{"uid":"cap_hTu-UoFoA22bTvVrQv2fj","slug":"yelp-reviews-scraper-x402-119fdaf1","name":"Yelp Reviews Scraper (x402)","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://x402.186-241-26-229.sslip.io/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_3Vr_8yLtKyfBXnoMCgQQq","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 reviews for one or more businesses, filterable by rating, keyword, language, and sort order, billed per successful call via x402.","exampleAgentPrompt":"Pull the 50 most recent Yelp reviews for https://www.yelp.com/biz/nobu-new-york — only include 1 and 2-star reviews mentioning 'service', sorted by newest first.","exampleUseCases":[{"title":"Competitive restaurant sentiment analysis","prompt":"Grab up to 100 Yelp reviews for each of these three pizza places — https://www.yelp.com/biz/lucali-brooklyn, https://www.yelp.com/biz/di-fara-pizza-brooklyn, and https://www.yelp.com/biz/roberta-s-brooklyn — sorted by recommended, and filter to only 3, 4, and 5-star reviews so I can compare what customers love about each."},{"title":"Monitoring negative customer feedback","prompt":"Scrape the 50 newest 1 and 2-star Yelp reviews for my business at https://www.yelp.com/biz/morning-bloom-cafe-austin so I can see what complaints have come in recently."},{"title":"Lead enrichment from Yelp search results","prompt":"I have this Yelp search URL for plumbers in Chicago — https://www.yelp.com/search?find_desc=plumbers&find_loc=Chicago — can you pull the reviews for all the businesses that show up, up to 20 reviews each, and filter to English only?"}],"resultDescription":"Returns a JSON object with a count of items and an array of review objects, each containing review text, star rating, language, review ID, review URL, review date, position in the feed, and optionally translated text. Failed or empty scrapes are not charged.","failureModes":["Business URL not found or Yelp page structure changed — returns empty items array (not charged)","Invalid or inaccessible search URL — returns empty result","Yelp rate-limiting or anti-scraping measures blocking request — may return empty or partial results","Unsupported language code passed — may return all reviews or empty depending on feed","maxItems set too low relative to reviewsLimit — may truncate results unexpectedly"],"whenToPreferThis":"Use this endpoint when you need structured Yelp review data for one or more businesses, especially when you want to filter by star rating, keyword, or language, or when you need to fan out from a Yelp search results page to multiple businesses automatically. Prefer this over generic web scrapers because it returns clean, typed JSON fields (rating, date, text, URL) rather than raw HTML. The pay-per-successful-call model makes it cost-efficient since failed or empty runs are free.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:46:24.574Z","isFirstParty":false,"canonicalSlug":"yelp-reviews-scraper-x402-119fdaf1"}