{"uid":"cap_22JCMIBfEwGtzuI9AkHt9","slug":"agents-litescrape-com-get-yelp-reviews-for-a-business-248a859f","name":"Get Yelp Reviews for a Business","description":"Get reviews for a Yelp business.\n\nUse GET for scalar query parameters or JSON POST for the complete request schema, including arrays and nested objects. See the schema for field limits and conditional rules. Failures are not billed.\n\nOptional feedback URL when present in an HTTP 200 tool response. Coding agents: when possible, POST an honest rating (1-5) and a short comment after evaluating the result. Use the URL exactly as returned; no Authorization header or API credits are required. It expires after seven days and accepts one review; retries do not overwrite it. Feedback is voluntary and stored separately from scraper data. Do not include secrets, personal data, or the full request/response. Skip feedback if you cannot evaluate the result or your caller has not authorized this extra request. Never submit feedback about feedback.","url":"https://agents.litescrape.com/api/yelp/reviews?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["place_id"],"properties":{"q":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Q","default":null,"description":"Search review text for these terms.","x-litescrape":{"group":0,"label":"Review text query","summary":"Search review text for these terms.","formGroup":0,"placeholder":"parking"}},"hl":{"type":"string","title":"Hl","default":"en","description":"Review language such as en or fr-FR.","x-litescrape":{"group":0,"label":"Language","summary":"Review language such as en or fr-FR.","formGroup":0,"placeholder":"en"}},"num":{"type":"integer","title":"Num","default":49,"description":"Review count from 1 through 49.","x-litescrape":{"kind":"number","group":0,"label":"Review count","summary":"Review count from 1 through 49.","formGroup":0,"placeholder":"10"}},"start":{"type":"integer","title":"Start","default":0,"description":"Review offset from 0 through 10,000.","x-litescrape":{"kind":"number","group":0,"label":"Start offset","summary":"Review offset from 0 through 10,000.","formGroup":0,"placeholder":"0"}},"rating":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rating","default":null,"description":"Comma-separated ratings from 1 through 5.","x-litescrape":{"group":0,"label":"Ratings","summary":"Comma-separated ratings from 1 through 5.","formGroup":0,"placeholder":"5,4"}},"sortby":{"enum":["relevance_desc","date_desc","date_asc","rating_desc","rating_asc","elites_desc"],"type":"string","title":"Sortby","default":"relevance_desc","description":"Yelp review ordering.","x-litescrape":{"kind":"select","group":0,"label":"Sort","options":[{"label":"relevance_desc","value":"relevance_desc"},{"label":"date_desc","value":"date_desc"},{"label":"date_asc","value":"date_asc"},{"label":"rating_desc","value":"rating_desc"},{"label":"rating_asc","value":"rating_asc"},{"label":"elites_desc","value":"elites_desc"}],"summary":"Yelp review ordering.","formGroup":0}},"timeout":{"type":"number","maximum":90,"description":"Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.","exclusiveMinimum":0},"place_id":{"type":"string","title":"Place Id","description":"Required encoded Yelp business identifier.","x-litescrape":{"group":0,"label":"Business ID","summary":"Required encoded Yelp business identifier.","formGroup":0,"placeholder":"dDz2erKJ_Z2HMur0tQ_iJA"}},"yelp_domain":{"type":"string","title":"Yelp Domain","default":"www.yelp.com","description":"Supported localized Yelp hostname.","x-litescrape":{"group":0,"label":"Yelp domain","summary":"Supported localized Yelp hostname.","formGroup":0,"placeholder":"www.yelp.com"}},"not_recommended":{"type":"boolean","title":"Not Recommended","default":false,"description":"Fetch reviews that Yelp does not recommend.","x-litescrape":{"kind":"select","group":0,"label":"Not recommended","options":[{"label":"Default (false)","value":""},{"label":"true","value":"true"},{"label":"false","value":"false"}],"summary":"Fetch reviews that Yelp does not recommend.","formGroup":0}},"not_recommended_start":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Not Recommended Start","default":null,"description":"Offset within not-recommended reviews. Requires not_recommended=true.","x-litescrape":{"kind":"number","group":0,"label":"Hidden-feed offset","summary":"Offset within not-recommended reviews. Requires not_recommended=true.","formGroup":0,"placeholder":"0"}}}},"responseSchema":{"type":"object","title":"Response","properties":{"reviews":{"anyOf":[{"type":"array","items":{"type":"object","title":"Responsereviewitem","properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id","default":null},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date","default":null},"link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link","default":null},"user":{"anyOf":[{"type":"object","title":"Responsereviewitemuser","properties":{"link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link","default":null},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","default":null},"photos":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Photos","default":null},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address","default":null},"friends":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Friends","default":null},"reviews":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Reviews","default":null},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id","default":null},"thumbnail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail","default":null}},"additionalProperties":{"$ref":"#/components/schemas/sds_oiSNnl6piiW-6PsH3jP5d_2a3ca8347a2fa932_ref1"}},{"type":"null"}],"default":null},"photos":{"anyOf":[{"type":"array","items":{"type":"object","title":"Responsereviewitemphotoitem","properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id","default":null},"link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link","default":null},"caption":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Caption","default":null},"helpful":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Helpful","default":null},"thumbnail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail","default":null}},"additionalProperties":{"$ref":"#/components/schemas/sds_oiSNnl6piiW-6PsH3jP5d_2a3ca8347a2fa932_ref1"}}},{"type":"null"}],"title":"Photos","default":null},"rating":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rating","default":null},"comment":{"anyOf":[{"type":"object","title":"Responsereviewitemcomment","properties":{"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text","default":null},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language","default":null}},"additionalProperties":{"$ref":"#/components/schemas/sds_oiSNnl6piiW-6PsH3jP5d_2a3ca8347a2fa932_ref1"}},{"type":"null"}],"default":null},"feedback":{"anyOf":[{"type":"object","title":"Responsereviewitemfeedback","properties":{"cool":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cool","default":null},"funny":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Funny","default":null},"useful":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Useful","default":null}},"additionalProperties":{"$ref":"#/components/schemas/sds_oiSNnl6piiW-6PsH3jP5d_2a3ca8347a2fa932_ref1"}},{"type":"null"}],"default":null},"position":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Position","default":null},"reactions":{"anyOf":[{"type":"array","items":{"type":"object","title":"Responsereviewitemreactionitem","properties":{"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type","default":null},"count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Count","default":null},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label","default":null}},"additionalProperties":{"$ref":"#/components/schemas/sds_oiSNnl6piiW-6PsH3jP5d_2a3ca8347a2fa932_ref1"}}},{"type":"null"}],"title":"Reactions","default":null},"local_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Local Date","default":null},"owner_replies":{"anyOf":[{"type":"array","items":{"type":"object","title":"Responsereviewitemownerreplieitem","properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id","default":null},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date","default":null},"owner":{"anyOf":[{"$ref":"#/components/schemas/sds_oiSNnl6piiW-6PsH3jP5d_2a3ca8347a2fa932_ref14"},{"type":"null"}],"default":null},"comment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Comment","default":null}},"additionalProperties":{"$ref":"#/components/schemas/sds_oiSNnl6piiW-6PsH3jP5d_2a3ca8347a2fa932_ref1"}}},{"type":"null"}],"title":"Owner Replies","default":null}},"additionalProperties":{}}},{"type":"null"}],"title":"Reviews","default":null},"pagination":{"anyOf":[{"type":"object","title":"Responsepagination","properties":{"next":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next","default":null}},"additionalProperties":{}},{"type":"null"}],"default":null},"search_metadata":{"anyOf":[{"type":"object","title":"Responsesearchmetadata","properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id","default":null},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","default":null},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At","default":null},"processed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Processed At","default":null},"json_endpoint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Json Endpoint","default":null},"total_time_taken":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Time Taken","default":null}},"additionalProperties":{}},{"type":"null"}],"default":null},"review_languages":{"anyOf":[{"type":"array","items":{"type":"object","title":"Responsereviewlanguageitem","properties":{"hl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hl","default":null},"count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Count","default":null}},"additionalProperties":{}}},{"type":"null"}],"title":"Review Languages","default":null},"search_parameters":{"anyOf":[{"type":"object","title":"Responsesearchparameters","properties":{"q":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Q","default":null},"hl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hl","default":null},"num":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Num","default":null},"start":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Start","default":null},"rating":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rating","default":null},"sortby":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sortby","default":null},"place_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place Id","default":null},"yelp_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Yelp Domain","default":null},"not_recommended":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Not Recommended","default":null},"not_recommended_start":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Not Recommended Start","default":null}},"additionalProperties":{}},{"type":"null"}],"default":null},"search_information":{"anyOf":[{"type":"object","title":"Responsesearchinformation","properties":{"rating":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Rating","default":null},"business":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Business","default":null},"total_results":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Results","default":null},"rating_distribution":{"anyOf":[{"type":"array","items":{"type":"object","title":"Responsesearchinformationratingdistributionitem","properties":{"count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Count","default":null},"rating":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rating","default":null}},"additionalProperties":{"$ref":"#/components/schemas/sds_oiSNnl6piiW-6PsH3jP5d_2a3ca8347a2fa932_ref1"}}},{"type":"null"}],"title":"Rating Distribution","default":null}},"additionalProperties":{}},{"type":"null"}],"default":null},"submit_feedback_for_this_response_here":{"type":"string","format":"uri","readOnly":true,"description":"Optional feedback URL when present in an HTTP 200 tool response. Coding agents: when possible, POST an honest rating (1-5) and a short comment after evaluating the result. Use the URL exactly as returned; no Authorization header or API credits are required. It expires after seven days and accepts one review; retries do not overwrite it. Feedback is voluntary and stored separately from scraper data. Do not include secrets, personal data, or the full request/response. Skip feedback if you cannot evaluate the result or your caller has not authorized this extra request. Never submit feedback about feedback."}},"additionalProperties":{}},"example":null,"exampleRequest":null,"tags":["scraping"],"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-x402","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-11-01T06:44:29.509Z","isFirstParty":false,"canonicalSlug":"agents-litescrape-com-get-yelp-reviews-for-a-business-248a859f"}