Get business
Returns a business's Yelp profile: rating, categories, structured address, phone, price band and photos, keyed by the URL alias slug. reviews is always null (see reviews_note). Redirects are followed; name is the business returned. data is null if Yelp has no page for the slug.
1 credit / requestBilled only on success
Authorization
ApiKeyAuth x-api-key<token>
In: header
Query Parameters
alias*string
Business slug from its Yelp URL, the part after /biz/. A full Yelp URL also works. Old slugs redirect and still resolve; name in the response shows what was fetched.
curl -X GET "https://example.com/v1/yelp/business?alias=tartine-bakery-san-francisco" \ -H "x-api-key: YOUR_API_KEY"{ "data": { "alias": "tartine-bakery-san-francisco", "url": "https://www.yelp.com/biz/tartine-bakery-san-francisco", "name": "Tartine Bakery", "rating": 4.3, "review_count_display": "9.2k", "phone": "(415) 487-2600", "price_range": "$$", "categories": [ "Bakeries", "Desserts", "Cafes" ], "address": { "street_address": "600 Guerrero St", "locality": "San Francisco", "region": "CA", "postal_code": "94110", "country": "US" }, "photos": [ { "url": "https://s3-media0.fl.yelpcdn.com/bphoto/AbCdEf/o.jpg", "thumbnail_url": "string", "caption": "string", "uploaded_at": "2024-05-14T00:00:00.000Z", "uploaded_at_raw": "2024-05-14", "author": "string" } ], "reviews": null, "reviews_note": "Yelp renders its review list client-side; a server-fetched page carries only loading placeholders. Reviews are not available on this tier." }}