{"uid":"cap_fD5fdMpwaiKY8A6jAL2px","slug":"bizintel-api-yelp-business-lookup-1dea32cb","name":"BizIntel API – Yelp Business Lookup","description":"Fetches local retail business ratings, reviews, and address from Yelp.","url":"https://bizintel-api.hahavoid0.workers.dev/company/yelp","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["name","location"],"properties":{"name":{"type":"string","description":"Business name"},"location":{"type":"string","description":"City and state/country"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"result":{"rating":4.5,"review_count":320},"warnings":[],"supported":true,"confidence":"high","data_as_of":"2026-06","disclaimer":"Informational support only. Not legal, tax, medical, veterinary, or financial advice. Verify with the cited official source or a qualified professional before acting."}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_lTcngoGYf0pTKP6AvoT5y","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up a business's Yelp rating and review count by name and location","exampleAgentPrompt":"What's the Yelp rating and number of reviews for Joe's Crab Shack in Houston, Texas?","exampleUseCases":[{"title":"Vetting a vendor before partnership","prompt":"Can you check the Yelp rating and review count for Golden Gate Plumbing in San Francisco, CA? I want to know if they're well-regarded before we refer them to clients."},{"title":"Restaurant recommendation research","prompt":"Look up the Yelp score for Nobu Restaurant in Los Angeles, California — I want to know their rating and how many reviews they have before I suggest it for a team dinner."},{"title":"Competitor reputation benchmarking","prompt":"What's the Yelp rating and total review count for BlueStar Heating & Cooling in Chicago, Illinois? I'm building a competitive analysis for a local HVAC company."}],"resultDescription":"Returns a JSON object with the business's Yelp star rating (e.g. 4.5), total review count, a confidence level (e.g. 'high'), a data_as_of date indicating freshness, a supported flag, any warnings, and a disclaimer noting the data is informational only.","failureModes":["Business not found on Yelp returns low confidence or unsupported flag","Ambiguous business name with multiple matches may reduce confidence","Location too vague or misspelled may return no results","Rate limiting or payment failure returns 402 or error response","Data may be stale relative to current Yelp listings (data_as_of indicates last refresh)"],"whenToPreferThis":"Use this endpoint when you need quick, structured Yelp reputation data (rating + review count) for a named business in a specific city without needing a Yelp API key or account. It's ideal for AI agents doing local business vetting, vendor research, or competitive benchmarking at $0.03 per call via x402 USDC — far simpler than setting up a full Yelp Fusion integration.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:57:35.726Z","isFirstParty":false}