{"uid":"cap_JRco0oOCow9InjD7ob2ke","slug":"serp402-yelp-reviews-api-dbba7307","name":"serp402 Yelp Reviews API","description":"Yelp Reviews: User information, rating, date, comment, owner responses and more. Structured JSON, USD 0.05 per call in USDC — no API key, no account, no subscription, no minimum. Not affiliated with, endorsed by or an official channel of any of the services the results come from. All trademarks and copyright remain the property of their respective owners.","url":"https://serp402.com/api/v1/yelp-reviews?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"hl":{"type":"string","description":"language to use for sorting Yelp Reviews. It's a two-letter language code. (e.g., en for English, es for Spanish, or fr for French) Head to the Yelp Reviews…"},"num":{"type":"string","description":"maximum number of results to return. 49 (default) returns 49 results. Maximum number of results to return is 49 ."},"start":{"type":"string","description":"result offset. It skips the given number of results. It's used for pagination. (e.g., 0 (default) is the first page of results, 49 is the 2nd page of results,…"},"rating":{"type":"string","description":"Parameter filters out the results by rating. Possible values are 5 , 4 , 3 , 2 , and 1 . All results are included by default. To only show results with the…"},"sortby":{"type":"string","description":"Parameter is used for sorting results. Available options: relevance_desc - Yelp Sort (default) date_desc - Newest First date_asc - Oldest Rated rating_desc -…"},"place_id":{"type":"string","description":"Yelp ID of a place. Each place has two unique IDs (e.g. ED7A7vDdg8yLNKJTSVHHmg and arabica-brooklyn ). Only the first ID type is supported (e.g.…"},"yelp_domain":{"type":"string","description":"Yelp domain to use. It defaults to yelp.com . Head to the Yelp domains for a full list of supported Yelp domains."},"not_recommended":{"type":"string","description":"Parameter fetches reviews that are not recommended by Yelp. It can be set to true to only show not recommended reviews, or false to show recommended reviews.…"},"not_recommended_start":{"type":"string","description":"result offset. It skips the given number of results. It's used for pagination. (e.g., 0 (default) is the first page of results, 10 is the 2nd page of results,…"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_maNan4Sry5gHlI1kPpV3s","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches structured Yelp reviews for a given place, including user info, ratings, dates, comments, and owner responses","exampleAgentPrompt":"Pull the 49 most recent Yelp reviews for the restaurant with Yelp ID 'ED7A7vDdg8yLNKJTSVHHmg', sorted by newest first, in English — I want the reviewer names, ratings, dates, comments, and any owner responses.","exampleUseCases":[{"title":"Competitor review sentiment analysis","prompt":"Get me the top 49 Yelp reviews for the sushi place with Yelp ID 'oTiSMgrT7p9K_J6UCFH8dg', sorted by newest first in English — I want to analyze what customers are saying about the food and service."},{"title":"Reputation monitoring for 1-star complaints","prompt":"Fetch all 1-star Yelp reviews for the hotel with place ID 'W7WDYQ6g6KLlMmcnFcVRlg' — show me the reviewer names, dates, full comment text, and whether the owner has responded to each one."},{"title":"Surfacing hidden not-recommended reviews","prompt":"Grab the not-recommended Yelp reviews for the bar with Yelp ID 'arabica-brooklyn' — I want to see what reviews Yelp has filtered out, including user info and their comments."}],"resultDescription":"Returns a structured JSON array of Yelp reviews for the requested business, each containing reviewer username, profile details, star rating, review date, full review text, owner response (if any), and recommendation status. Supports up to 49 results per call with pagination.","failureModes":["Invalid or unsupported place_id returns empty results or error","place_id of second format (slug-style) not supported — only alphanumeric IDs work","Requesting more than 49 results per call is not supported","Unsupported Yelp domain may return no results","Payment failure (insufficient USDC balance) blocks the call","Yelp rate limiting or blocking on the scraping side may cause intermittent failures"],"whenToPreferThis":"Choose this endpoint when you need structured Yelp review data without managing a Yelp API key or subscription, especially for ad-hoc lookups, competitive research, or reputation monitoring. It supports filtering by rating and fetching not-recommended reviews that Yelp hides by default — useful for deeper sentiment analysis. It is pay-per-call at $0.05 USDC with no minimums, making it ideal for low-volume or one-off agent tasks.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:41:46.385Z","isFirstParty":false,"canonicalSlug":"serp402-yelp-reviews-api-dbba7307"}