{"uid":"cap_pnwf1nAcoMTJoqbBQReeM","slug":"fetcher-sh-yelp-place-by-handle-d42dd7b6","name":"fetcher.sh Yelp Place by Handle","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/place/handle/%7Bhandle%7D","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"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_R2oeD-gmDm5hSh7rh63yJ","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":"Fetches detailed Yelp business profile data for a given Yelp business handle/alias, paid per call in USDC via x402.","exampleAgentPrompt":"Pull the Yelp business profile for 'gary-danko-san-francisco' — I need their address, phone number, rating, and hours.","exampleUseCases":[{"title":"Restaurant research for dining recommendation","prompt":"Can you grab the Yelp details for 'the-french-laundry-yountville' — I want their rating, price range, hours, and categories so I can recommend it to a user."},{"title":"Business hours lookup for local service","prompt":"Look up the Yelp listing for 'joe-coffee-company-new-york' and tell me their current hours and phone number."},{"title":"Competitor profile enrichment for sales tool","prompt":"Fetch the full Yelp profile for 'nobu-los-angeles' including their review count, star rating, and address so I can add it to our business intelligence dashboard."}],"resultDescription":"Returns a structured Yelp business profile including the business name, address, phone number, star rating, total review count, price range, categories, hours of operation, photos, and other publicly available attributes from the Yelp listing for the specified handle.","failureModes":["Invalid or non-existent Yelp handle returns 404 or empty result","Payment failure if USDC balance is insufficient (x402 payment required)","Rate limiting or temporary Yelp scraping blocks may return errors","Business may have been closed or removed from Yelp, returning no data","Handle with special characters may need URL encoding"],"whenToPreferThis":"Use this endpoint when you already know the Yelp business handle/alias (the slug in the Yelp URL) and need structured profile data without setting up OAuth, a Yelp developer account, or managing API keys. Ideal for AI agents that need pay-per-call access to Yelp data in USDC with no subscriptions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:50:09.752Z","isFirstParty":false}