{"uid":"cap_8lMD0jVZLc-3A7MPZecZ_","slug":"fetcher-sh-yelp-search-api-f5b173b7","name":"fetcher.sh Yelp Search API","description":"fetcher.sh is an x402 web-data and scraping API: 111 endpoints for Twitter/X, YouTube, TikTok, Instagram, Reddit, Google, App Store, and Yelp — paid per call in USDC on Base, Polygon, Arbitrum, Monad or Solana, or with prepaid credits. Built for AI agents: no accounts, no OAuth, no subscriptions.","url":"https://fetcher.sh/api/yelp/search","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"required":{"type":"string"},"properties":{"type":"string"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-7c8NvKdChFf5bWTiCCAM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search Yelp for local businesses by keyword and location, returning listings, ratings, reviews, and contact details","exampleAgentPrompt":"Search Yelp for the top-rated sushi restaurants in Brooklyn, NY and give me their names, ratings, addresses, and phone numbers.","exampleUseCases":[{"title":"Restaurant discovery for a night out","prompt":"Find me the best-rated Italian restaurants in the East Village, New York — I want their names, star ratings, price range, and addresses so I can pick one for dinner tonight."},{"title":"Local service provider research","prompt":"Search Yelp for highly rated electricians in Austin, TX and give me a list of the top results with their ratings, phone numbers, and number of reviews."},{"title":"Competitor landscape analysis","prompt":"Find all the coffee shops listed on Yelp near downtown Seattle and give me their names, ratings, and how many reviews each one has — I want to see who the main players are."}],"resultDescription":"Returns a list of Yelp business listings matching the search query and location, including business names, star ratings, review counts, addresses, phone numbers, price range indicators, categories, and hours of operation where available.","failureModes":["Missing required query or location parameter returns a 400 error","No results found for obscure location or niche category returns empty list","Rate limiting or payment failure returns 402 if USDC payment is insufficient","Yelp data may be stale or incomplete for newer or less-reviewed businesses","Geographic queries for very small towns may return sparse results"],"whenToPreferThis":"Choose this endpoint when you need to search Yelp specifically for local business discovery, ratings, and reviews — especially for restaurants, home services, or consumer-facing businesses. Prefer this over generic web scraping when you want structured Yelp data (ratings, hours, phone) without needing an OAuth token or Yelp developer account. It's ideal for AI agents that need to pay per-call in USDC with no subscription overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:55:34.757Z","isFirstParty":false}