{"uid":"cap_22JCMIBfEwGtzuI9AkHt9","slug":"agents-litescrape-com-get-yelp-reviews-for-a-business-248a859f","name":"Get Yelp Reviews for a Business","description":"Returns the reviews of one Yelp business identified by its place_id from a search result: each review carries the rating, text, date, and reviewer details. Choose the language with hl, the order with sortby, keep only some star ratings with rating, and page with start and num (up to 49 per call). One call is one request.","url":"https://agents.litescrape.com/api/yelp/reviews","method":"GET","headers":{},"bodySchema":{"type":"object","required":["place_id"],"properties":{"q":{"type":"string","description":"Review-text filtering is not supported: the API answers 422 when this is set."},"hl":{"type":"string","default":"en","description":"Review language such as en or fr-FR."},"num":{"type":"integer","default":49,"maximum":49,"minimum":1,"description":"Number of reviews."},"start":{"type":"integer","default":0,"maximum":10000,"minimum":0,"description":"Review offset."},"rating":{"type":"string","description":"Comma-separated star ratings from 1 through 5 to keep."},"sortby":{"enum":["relevance_desc","date_desc","date_asc","rating_desc","rating_asc","elites_desc"],"type":"string","default":"relevance_desc","description":"Review order."},"place_id":{"type":"string","description":"Encoded Yelp business identifier from a search result."},"yelp_domain":{"type":"string","default":"www.yelp.com","description":"Localized Yelp hostname."},"not_recommended":{"type":"boolean","default":false,"description":"The hidden not-recommended feed is not supported: the API answers 422 when this is true."},"not_recommended_start":{"type":"string","description":"Hidden-feed offset, not supported: the API rejects the request when this is supplied."}}},"responseSchema":{"type":"object","properties":{"reviews":{"type":"array","items":{"type":"object"},"description":"Reviews: rating, text, date, reviewer details."},"pagination":{"type":"object","description":"Present when more results exist: next (a ready-made URL for the next page) or next_page_token."},"search_metadata":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string"},"total_time_taken":{"type":"number"}}},"search_parameters":{"type":"object","description":"The request parameters as normalized by the API."}},"description":"Successful responses carry request metadata, the normalized parameters, and the result groups available for the operation. Optional groups are omitted when the source does not provide them. Errors are a JSON body with error, error_code, status_code, request_id, retryable, and the echoed search_parameters."},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.000150","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.000150/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.000150","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.000150","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_C2gFRMpCZDdZ2HRKqrQMX","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.000150","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.litescrape.com","brandSlug":"agents-litescrape-com-mpp","brandBaseUrl":"https://agents.litescrape.com","brandDocsUrl":null,"whatItDoes":"Fetches paginated Yelp reviews for a specific business, including ratings, text, dates, and reviewer details, with filtering and sorting options.","exampleAgentPrompt":"Pull me the 49 most recent Yelp reviews for the restaurant with place_id 'WavvLdfdP6g8aZTtbBQHTw', sorted by newest first, in English.","exampleUseCases":[{"title":"Competitor review analysis for a restaurant","prompt":"Get me the latest 49 Yelp reviews for the pizza place with place_id 'abc123XYZ', sorted by date newest first — I want to see what customers are saying recently."},{"title":"Filtering negative reviews for service recovery","prompt":"Fetch all 1-star and 2-star Yelp reviews for the hotel with place_id 'hotel456DEF' so I can identify recurring complaints and prioritize fixes."},{"title":"Multilingual review monitoring for an international brand","prompt":"Pull up to 49 Yelp reviews in French for the business with place_id 'paris789GHI' on yelp.fr, sorted by most relevant first."}],"resultDescription":"Returns an array of review objects each containing the star rating, full review text, date posted, and reviewer details (name, profile info). Also includes a pagination object with a next-page URL or token when more results exist, plus search_metadata (request ID, status, time taken) and the normalized search_parameters echo.","failureModes":["Missing place_id returns a 422 validation error","Setting the q (text filter) parameter returns a 422 error — not supported","Setting not_recommended=true returns a 422 error — not supported","Supplying not_recommended_start returns a 422 rejection","Invalid place_id (non-existent business) may return an empty reviews array or an error","Requesting start > 10000 exceeds the maximum offset and is rejected","num > 49 exceeds the maximum per-call limit and is rejected","Unsupported hl locale may return no results or an error from the upstream Yelp API"],"whenToPreferThis":"Use this endpoint when you need structured Yelp review data (ratings, text, dates, reviewer info) for a known Yelp business identified by its place_id, especially when you need filtering by star rating, language, or sort order. Prefer this over manual scraping or browser automation when you need clean JSON output at low cost ($0.00015/call) without managing proxies. It is ideal for sentiment analysis pipelines, competitive intelligence, reputation monitoring, or any workflow that needs paginated Yelp reviews programmatically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-18T17:29:19.839Z","isFirstParty":false}