{"uid":"cap_UmHuSK9XNCh13GaJNgD97","slug":"yelp-business-search-via-openwebninja-0e415f53","name":"Yelp Business Search via OpenWebNinja","description":"Search Yelp businesses by query and location.","url":"https://openwebninja-x402.vercel.app/api/yelp/business-search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["query","location"],"properties":{"query":{"type":"string","minLength":1},"start":{"type":"integer","maximum":9007199254740991,"minimum":0},"sort_by":{"enum":["RECOMMENDED","HIGHEST_RATED","REVIEW_COUNT"],"type":"string"},"location":{"type":"string","minLength":1},"price_range":{"type":"string","minLength":1},"yelp_domain":{"type":"string","minLength":1}},"additionalProperties":false}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hrsfFaZcYLzk-42LCMnkd","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search Yelp for businesses matching a keyword query and location, with optional filters for sort order and price range.","exampleAgentPrompt":"Can you search Yelp for the highest-rated sushi restaurants in San Francisco, sorted by rating, and show me only mid-range price options?","exampleUseCases":[{"title":"Find affordable plumbers nearby","prompt":"I need to find cheap plumbers in my area—can you search Yelp for plumbers sorted by price and show me the ones with the best ratings?"},{"title":"Discover top-rated coffee shops","prompt":"Help me find the most popular coffee shops in downtown Seattle. I want to see highly-reviewed places sorted by review count, preferably in the mid-range price bracket."},{"title":"Search for gyms by location","prompt":"Can you search Yelp for highly-rated gyms near Chicago and filter to show me only the affordable options? I want to see what's available sorted by rating."}],"resultDescription":"A list of Yelp business results matching the query and location, including business names, ratings, review counts, addresses, price levels, and other profile details from Yelp's directory.","failureModes":["Missing required 'query' parameter returns validation error","Missing required 'location' parameter returns validation error","Invalid sort_by value (not one of RECOMMENDED, HIGHEST_RATED, REVIEW_COUNT) causes error","No results found for obscure query/location combinations","Payment failure (402) if USDC balance is insufficient","Rate limiting or upstream Yelp API errors causing 5xx responses"],"whenToPreferThis":"Use this endpoint when you need to search Yelp's business directory by keyword and location and want structured results including ratings, reviews, and price ranges. Prefer this over generic web search when you specifically need Yelp data with filtering by price and sort order. Pair with the sibling Yelp business profile endpoint to get detailed info on a specific business after discovering it here.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T07:09:02.192Z","isFirstParty":false,"canonicalSlug":"yelp-business-search-via-openwebninja-0e415f53"}