{"uid":"cap_5xDBNaFsyAdmQZL9Ucfii","slug":"yelp-business-scraper-via-scrapeforagents-a45f85c2","name":"Yelp Business Scraper via ScrapeForAgents","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/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_7uyNL-wN1AlFWBHz9Sejz","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 names, addresses, phone numbers, coordinates, and photo links.","exampleAgentPrompt":"Search Yelp for 'Italian restaurants' in New York, NY and San Francisco, CA — pull up to 20 business profiles each, including their addresses, phone numbers, and up to 10 photos per listing.","exampleUseCases":[{"title":"Restaurant lead list for a city","prompt":"Pull me the top 30 Yelp listings for 'pizza restaurants' in Chicago, IL — I need their names, addresses, phone numbers, and coordinates."},{"title":"Competitor research for a local service","prompt":"Scrape Yelp for 'house cleaning services' in Austin, TX and return up to 50 profiles including alternate names and direct Yelp URLs so I can analyze what competitors are offering."},{"title":"Photo and profile data for hospitality venues","prompt":"Grab Yelp profile data for these 3 direct Yelp URLs I have — include up to 50 photos each and all contact details like address and phone number."}],"resultDescription":"A JSON object with a count of results and an items array where each entry contains the business name, Yelp business ID, phone number, street address, latitude, longitude, direct Yelp URL, alternate names, and photo link URLs (up to the requested max).","failureModes":["Empty results if search terms and locations return no Yelp matches — not charged","Invalid or expired direct URLs returning null fields","Search limit exceeding Yelp's exposed ~240 results per query silently capped","Missing fields (null) if Yelp profile is incomplete or partially scraped","Rate or anti-bot blocks from Yelp causing failed runs — not charged per pay-per-call model"],"whenToPreferThis":"Choose this endpoint when you need structured Yelp business data at scale — including contact info, coordinates, and photos — without managing your own scraping infrastructure. It's pay-per-call and only charges on successful, non-empty results, making it cost-efficient for both bulk city-wide searches and targeted direct-URL lookups. Prefer it over generic web scrapers when Yelp-specific fields like bizId, alternateNames, and Yelp-hosted photos are important.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:58.637Z","isFirstParty":false,"canonicalSlug":"yelp-business-scraper-via-scrapeforagents-a45f85c2"}