{"uid":"cap_HmJk5Cwr8lDUQWmEdKBFM","slug":"yelp-business-scraper-x402-30efd598","name":"Yelp Business 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?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"maxItems":{"type":"integer","default":0,"minimum":0,"description":"Hard cap across all searches and direct URLs. Zero means no additional cap."},"locations":{"type":"array","description":"Cities or areas for each search term, such as London or New York, NY."},"maxImages":{"type":"integer","default":20,"maximum":1000,"minimum":0,"description":"Maximum photo links per profile. Zero skips photos; higher limits may require extra gallery pages."},"directUrls":{"type":"array","default":[],"description":"Business or search URLs. These can be combined with search terms and locations."},"searchLimit":{"type":"integer","default":10,"maximum":240,"minimum":1,"description":"Maximum business profiles to process for each term and location pair. Yelp exposes about 240 per search."},"searchTerms":{"type":"array","description":"Keywords or business types. Each term is searched in every location."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"name":null,"bizId":null,"phone":null,"address":null,"latitude":null,"directUrl":null,"longitude":null,"alternateNames":null}],"product":"yelp"}},"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_6owEc27GidTsJqGRE3hUM","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 structured business profile data from Yelp by search term and location or direct URL, returning name, address, phone, coordinates, and photos.","exampleAgentPrompt":"Find me up to 20 Italian restaurants in Chicago and Boston from Yelp, including their phone numbers, addresses, and up to 5 photos each.","exampleUseCases":[{"title":"Local competitor research for a new restaurant","prompt":"Search Yelp for all sushi restaurants in Austin, TX and Portland, OR — give me up to 30 results per city with their names, phone numbers, addresses, and coordinates."},{"title":"Lead generation for a B2B service","prompt":"Pull structured data on up to 50 plumbers and electricians in Miami, FL from Yelp, including their phone numbers and addresses so I can build a contact list."},{"title":"Photo and listing audit for a specific venue","prompt":"Grab the full Yelp profile for this business URL https://www.yelp.com/biz/tartine-bakery-san-francisco including up to 100 photos and all the contact details."}],"resultDescription":"Returns a JSON object with a count of matched businesses and an array of items, each containing the business name, Yelp business ID, phone number, street address, latitude, longitude, direct Yelp URL, and alternate names. Photo URLs are included up to the configured maxImages limit. Failed or empty runs are not billed.","failureModes":["No results found for the given search term and location combination — empty items array returned, no charge applied","Invalid or inaccessible direct URL provided — item may be skipped or return null fields","Rate limiting or blocking by Yelp during scrape — run may fail with no charge","maxItems cap reached before all searches are processed — partial results returned","Malformed input schema (e.g. missing both searchTerms/locations and directUrls) — likely 400 error"],"whenToPreferThis":"Choose this endpoint when you need structured Yelp business data (addresses, phones, coordinates, photos) for one or more cities or business types without managing a browser or Yelp API credentials. Ideal for lead generation, competitive research, local business aggregation, or feeding downstream workflows. The pay-per-successful-call model makes it cost-safe for exploratory queries. Prefer over generic web scrapers when Yelp-specific fields (bizId, alternateNames, Yelp URL) are needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:41.951Z","isFirstParty":false,"canonicalSlug":"yelp-business-scraper-x402-30efd598"}