{"uid":"cap_-m20xdyXMojlnKwSjKEg2","slug":"agents-openwebninja-com-yelp-business-details-867428ed","name":"Yelp Business Details","description":"Fetch a single or multiple business details from Yelp.","url":"https://agents.openwebninja.com/yelp-business-data/business-details?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["business_id"],"properties":{"business_id":{"type":"string","description":"Yelp business id or alias to fetch details for.  \n  In addition, batching of up to 20 Business Ids or aliases is supported in a single request using a comma separated list (e.g. business_id=id1,id2)."},"yelp_domain":{"enum":["yelp.com","yelp.com.au","yelp.co.nz","ms.yelp.my","yelp.cz","yelp.dk","yelp.de","yelp.at","de.yelp.ch","en.yelp.be","yelp.ca","en.yelp.com.hk","en.yelp.my","en.yelp.com.ph","yelp.ie","yelp.com.sg","en.yelp.ch","yelp.co.uk","yelp.com.ar","yelp.cl","yelp.es","yelp.com.mx","fil.yelp.com.ph","yelp.fr","fr.yelp.ca","fr.yelp.ch","fr.yelp.be","yelp.no","yelp.pl","yelp.pot","yelp.com.br","fi.yelp.fi","sv.yelp.fi","yelp.se","yelp.com.tr","yelp.co.jp","zh.yelp.com.hk","yelp.com.tw"],"type":"string","default":"yelp.com","description":"The yelp domain to use for the search."}}},"responseSchema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The unique identifier of the business"},"name":{"type":"string","description":"The name of the business"},"alias":{"type":"string","description":"The alias of the business"},"phone":{"type":"string","description":"The phone number of the business"},"photo":{"type":"string","description":"The URL of the business photo"},"rating":{"type":"number","description":"The rating of the business"},"address":{"type":"string","description":"The address of the business"},"country":{"type":"string","description":"The country where the business is located"},"website":{"type":"string","description":"The website URL of the business"},"menu_url":{"type":"string","description":"The URL of the business menu"},"yelp_menu":{"type":"string","description":"The URL to the Yelp menu of the business"},"owner_name":{"type":"string","description":"The name of the business owner"},"price_range":{"type":"string","description":"The price range of the business"},"review_count":{"type":"integer","description":"The number of reviews for the business"},"owner_biography":{"type":"string","description":"A short biography of the business owner"},"owner_photo_url":{"type":"string","description":"The URL of the business owner's photo"},"business_page_link":{"type":"string","description":"The link to the business page"}}}},"status":{"type":"string","description":"The status of the response"},"request_id":{"type":"string","description":"The unique identifier for the request"}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","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":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_LRGEnrhZji5iOjxiRQZvw","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.openwebninja.com","brandSlug":"agents-openwebninja-com-x402","brandBaseUrl":"https://agents.openwebninja.com","brandDocsUrl":null,"whatItDoes":"Fetch detailed business information for one or up to 20 Yelp businesses by business ID or alias, including ratings, contact info, owner details, and menu links.","exampleAgentPrompt":"Can you pull up the full Yelp details for 'gary-danko-san-francisco' — I want their phone number, address, rating, price range, and a link to their menu?","exampleUseCases":[{"title":"Restaurant vetting before a booking","prompt":"I'm considering taking clients to dinner at Nobu in Malibu — can you grab the Yelp details for 'nobu-restaurant-malibu' so I can check the rating, price range, and their contact info?"},{"title":"Batch enrichment of a business list","prompt":"I have these 5 Yelp business IDs: 'tartine-bakery-san-francisco', 'blue-bottle-coffee-san-francisco', 'zuni-cafe-san-francisco', 'foreign-cinema-san-francisco', 'bix-san-francisco' — can you fetch the details for all of them at once including ratings, addresses, and websites?"},{"title":"Owner research for a local business profile","prompt":"Look up the Yelp listing for 'farmstead-cheese-and-wine-berkeley' and get me the owner's name, biography, and their business website — I'm writing a local business spotlight."}],"resultDescription":"Returns an array of business objects, each containing the business ID, name, alias, phone number, address, country, website URL, menu URL, Yelp menu URL, business photo URL, rating, review count, price range, owner name, owner biography, owner photo URL, and a direct link to the Yelp business page. Also includes a response status and request ID.","failureModes":["Invalid or non-existent business ID returns empty data array","Exceeding 20 business IDs in a single batch may result in an error","Rate limiting or quota exhaustion returns a 402 or 429 error","Unsupported yelp_domain enum value causes a validation error","Business may have incomplete data (e.g. no menu URL or owner info) if not provided on Yelp"],"whenToPreferThis":"Use this endpoint when you need structured Yelp-specific business details — especially owner info, Yelp ratings, menu links, or price ranges — and you already have a Yelp business ID or alias. It supports batching up to 20 businesses per call, making it efficient for bulk enrichment workflows. Prefer this over Google Maps endpoints when the user specifically references Yelp or when Yelp ratings/reviews are the primary data need.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:27.168Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-yelp-business-details-867428ed"}