{"uid":"cap_0wmmH1_SBYAyUlw70K_em","slug":"agents-openwebninja-com-yelp-business-reviews-ecc62d6a","name":"Yelp Business Reviews","description":"Fetch a single or multiple business review pages from Yelp (each page includes up to 10 reviews).","url":"https://agents.openwebninja.com/yelp-business-data/business-reviews?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["business_id"],"properties":{"page":{"type":"integer","default":1,"description":"Page to return (each page includes up to 10 results)."},"sort":{"enum":["BEST_MATCH","NEWEST","OLDEST","HIGHEST_RATED","LOWEST_RATED","ELITES"],"type":"string","default":"BEST_MATCH","description":"How to sort reviews in the results. Note that the ELITES value will cause the API to only return reviews posted by elite members."},"query":{"type":"string","description":"Return reviews matching a text query"},"language":{"type":"string","default":"en","description":"Only return reviews of a certain language.  \n For a list of supported language codes see https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2."},"num_pages":{"type":"integer","default":1,"description":"Number of pages to return, starting from page. Allowed values: 1-10.  \n\n  **Note:** requests for more than one page are charged 2x."},"page_size":{"type":"integer","default":10,"description":"Results page size. Allowed values: 1-45."},"business_id":{"type":"string","description":"Yelp business id or alias to fetch reviews for."}}},"responseSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"total":{"type":"integer","description":"The total number of reviews."},"review_languages":{"type":"array","items":{"type":"object","properties":{"count":{"type":"integer","description":"The number of reviews in this language."},"language":{"type":"string","description":"The language of the reviews."}}}}}},"status":{"type":"string","description":"The status of the response."},"request_id":{"type":"string","description":"A unique identifier for the request."}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unprobed","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":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_91Q27qcqdYhtwo8YH2evs","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.openwebninja.com","brandSlug":"agents-openwebninja-com-x402","brandBaseUrl":"https://agents.openwebninja.com","brandDocsUrl":null,"whatItDoes":"Fetch paginated customer reviews for a specific Yelp business, with filtering by language, sort order, and text query.","exampleAgentPrompt":"Pull me the top 20 best-match Yelp reviews for the business with alias 'gary-danko-san-francisco' — grab 2 pages starting from page 1 and only return English reviews.","exampleUseCases":[{"title":"Competitor sentiment analysis for a restaurant","prompt":"Get me the 20 most recent Yelp reviews for 'bestia-los-angeles' — I want to see what customers are saying lately about that restaurant."},{"title":"Surfacing complaints from low-rated reviews","prompt":"Fetch the lowest-rated Yelp reviews for the business ID 'sweetgreen-new-york' so I can identify the most common complaints customers are making."},{"title":"Elite reviewer opinions on a hotel","prompt":"Pull only the Yelp Elite member reviews for 'the-standard-hotel-los-angeles' — I want to see what experienced reviewers think of the place."}],"resultDescription":"Returns a data object containing the total number of reviews, an array of reviews for the requested page(s) (up to 10 reviews per page, or up to 45 with page_size), review language breakdown with counts, a status string, and a unique request ID.","failureModes":["Invalid or non-existent business_id returns an error or empty results","Requesting num_pages outside 1-10 range returns a validation error","Unsupported language code may return no results or an error","ELITES sort with no elite reviews returns an empty set","Rate limiting or payment failure returns a 402 or 429 error","Page number beyond available pages returns empty review set"],"whenToPreferThis":"Use this endpoint when you need Yelp-specific customer reviews for a business and have a Yelp business ID or alias. It is ideal when you want to filter by review language, sort by recency, rating, or elite status, or search reviews by keyword. Prefer this over Google review endpoints when Yelp reputation data is specifically needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:28.424Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-yelp-business-reviews-ecc62d6a"}