{"uid":"cap_5GFzK7js_8NcKaovwwTfj","slug":"yelp-reviews-scraper-fe527837","name":"Yelp Reviews Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/yelp-reviews?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"domain":{"type":"string","default":"www.yelp.com","description":"Regional Yelp host for business IDs. Business URLs keep their own domain."},"keyword":{"type":"string","default":"","description":"Keep reviews containing this text, ignoring case."},"ratings":{"type":"array","items":{"type":"integer"},"default":[],"description":"Keep only reviews with these star ratings; empty means all ratings."},"language":{"type":"string","default":"","description":"Two-letter language filter when supported by the review feed; empty means all languages."},"maxItems":{"type":"integer","default":0,"minimum":0,"description":"Hard cap across all businesses. Zero means no total cap."},"searchUrls":{"type":"array","items":{"type":"string"},"description":"Yelp search result URLs whose visible business listings should be expanded."},"businessIds":{"type":"array","items":{"type":"string"},"description":"Business URL aliases or encoded IDs to use when URLs are unavailable."},"reviewsSort":{"enum":["recommended","newest","oldest","highest","lowest"],"type":"string","default":"recommended","description":"Order used when requesting review pages."},"businessUrls":{"type":"array","items":{"type":"string"},"description":"Public Yelp business page URLs to collect reviews from."},"reviewsLimit":{"type":"integer","default":100,"minimum":1,"description":"Maximum number of reviews to collect from each business."},"includePersonalData":{"type":"boolean","default":false,"description":"Include public reviewer name, profile URL, photo URL, and review count. Disabled by default."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"text":null,"rating":null,"language":null,"reviewId":null,"reviewUrl":null,"reviewDate":null,"reviewPosition":null,"translatedText":null}],"product":"yelp-reviews"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","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.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oyV-GXf8q44My_RHdTgju","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes and returns structured Yelp business reviews filtered by rating, keyword, language, and sort order","exampleAgentPrompt":"Pull up to 50 Yelp reviews for https://www.yelp.com/biz/nobu-new-york — sort them newest first, keep only 1-star and 2-star reviews, and flag any that mention the word 'rude'.","exampleUseCases":[{"title":"Competitor review sentiment research","prompt":"Grab the 100 most recent Yelp reviews for https://www.yelp.com/biz/shake-shack-new-york and return only ones in English that mention 'wait time' — I want to see what customers are complaining about."},{"title":"Local business reputation monitoring","prompt":"Scrape up to 200 Yelp reviews for my restaurant at https://www.yelp.com/biz/the-smith-nyc, sorted by newest first, and only give me 1-star, 2-star, and 3-star reviews so I can see what needs fixing."},{"title":"Market research from Yelp search results","prompt":"Take this Yelp search URL https://www.yelp.com/search?find_desc=pizza&find_loc=Chicago, expand all the listed businesses, collect up to 25 reviews each sorted by highest rating, and return only reviews that mention 'delivery'."}],"resultDescription":"Returns a JSON object with a count of results and an array of review items, each containing the review text, star rating, language, review ID, review URL, review date, position in the list, and optionally translated text. Failed or empty scrape runs are not billed.","failureModes":["Business URL is invalid or no longer exists on Yelp — empty items array returned, no charge","Yelp blocks or rate-limits the scraper — may return empty or partial results","Keyword or rating filter is too restrictive — returns count:0 with empty items","Invalid searchUrl that doesn't resolve to business listings — empty results","Language filter code not recognized — may default to all languages or return empty"],"whenToPreferThis":"Use this endpoint when you need structured, filterable Yelp review data at scale — particularly when you want to filter by star rating, keyword, language, or sort order in a single call. It is preferable to generic web scrapers because it natively understands Yelp's data model (business IDs, search result expansion, review pagination) and returns a clean normalized schema. Ideal for sentiment analysis pipelines, reputation monitoring, and competitive research workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:45:16.613Z","isFirstParty":false,"canonicalSlug":"yelp-reviews-scraper-fe527837"}