{"uid":"cap_4HiqH7U-2UE5IDDO2Qmm4","slug":"serp402-yelp-search-scraper-998a5925","name":"serp402 Yelp Search Scraper","description":"Yelp: Scrape Yelp search results in JSON format automatically using custom parameters. Position, title, link, rating, reviews and more available. Structured JSON, USD 0.05 per call in USDC — no API key, no account, no subscription, no minimum. Not affiliated with, endorsed by or an official channel of any of the services the results come from. All trademarks and copyright remain the property of their respective owners.","url":"https://serp402.com/api/v1/yelp-search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"cflt":{"type":"string","description":"a category. It can be used alongside find_desc parameter to refine the search."},"attrs":{"type":"string","description":"Parameter is used for refining results. You can add more filters like 'price', 'features', etc. to your search. You can use our JSON endpoint to fetch values.…"},"start":{"type":"string","description":"result offset. It skips the given number of results. It's used for pagination. (e.g., 0 (default) is the first page of results, 10 is the 2nd page of results,…"},"sortby":{"type":"string","description":"Parameter is used for sorting results. Available options: recommended - Recommended (default) rating - Highest Rated review_count - Most Reviewed"},"find_loc":{"type":"string","description":"from where you want the search to originate. You can use any location you would use in a regular Yelp search. Following location formats are acceptable: - 706…"},"find_desc":{"type":"string","description":"query you want to search. You can use anything that you would use in a regular Yelp search."},"yelp_domain":{"type":"string","description":"Yelp domain to use. It defaults to yelp.com . Head to the Yelp domains for a full list of supported Yelp domains."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_m5Pmhvk1UFgCCZ8zSaD3t","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes Yelp search results and returns structured JSON including business position, title, link, rating, review count, and more","exampleAgentPrompt":"Search Yelp for the best-rated Italian restaurants in Chicago, sorted by highest rated, and give me the first page of results with names, ratings, and review counts.","exampleUseCases":[{"title":"Local competitor research for a business","prompt":"Search Yelp for 'pizza delivery' in Brooklyn, NY sorted by most reviewed and pull the top 10 results with their names, ratings, and review counts so I can see who the major players are."},{"title":"Finding top-rated service providers","prompt":"Look up Yelp for 'plumber' in Austin, TX sorted by highest rated and show me the first page of results including business names, ratings, and links."},{"title":"Restaurant scouting by category and price","prompt":"Search Yelp for sushi restaurants in San Francisco filtered to the 'Japanese' category and sort by recommended — I need business names, ratings, and review counts from the first page."}],"resultDescription":"Returns a structured JSON array of Yelp business listings from the search results page, including each business's position in results, name, Yelp URL, star rating, review count, category, and any other metadata Yelp surfaces such as price range or featured attributes.","failureModes":["Invalid or unrecognized location returns empty results or error","Yelp blocking or rate-limiting the scraper causes failed or incomplete responses","Unsupported Yelp domain returns an error","Invalid sort-by value causes parameter rejection","Pagination offset beyond available results returns empty array","Payment not confirmed results in request rejection"],"whenToPreferThis":"Choose this endpoint when you need to programmatically query Yelp search results without a Yelp API key or account, especially for local business discovery, competitor research, or aggregating ratings and reviews. It is ideal for agents that need pay-per-call access with no subscription commitment and support for pagination, category filtering, and sort ordering.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:40:42.450Z","isFirstParty":false,"canonicalSlug":"serp402-yelp-search-scraper-998a5925"}