Yelp

Yelp Business Details API

One Yelp business in full as JSON: rating with the per-star histogram, review count, price band, categories, address and coordinates, phone, website and menu links, hours and holidays, amenities, photos and videos, popular items, health inspections, Q&A, licences and claim status — plus the first page of reviews at no extra cost. Costs 2 credits.

POST/api/v1/yelp/business

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

business_idstring

Which business, 1-500 characters. Accepts the human-readable alias (desnudo-coffee-austin-2), the opaque encid Yelp uses internally, or a yelp.com/biz URL. The Search endpoint returns both business_id and alias on every row. Either this or url is required.

Example: mozarts-coffee-roasters-austin

urlstring

A yelp.com/biz URL, 1-1000 characters, as an alternative to business_id. Either this or business_id is required.

Example: https://www.yelp.com/biz/mozarts-coffee-roasters-austin

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

biz = client.yelp.business(business_id="mozarts-coffee-roasters-austin")
d = biz["data"]

print(d["name"], d["rating"], d["rating_distribution"])
print("hidden by Yelp's filter:", d["not_recommended_review_count"])

# The first page of reviews rides along - do NOT call /reviews with page=1
for review in d["reviews"]:
    print(review["rating"], review["author"], review["text"][:80])

Response

"business_id": "-4ofMtrD7pSpZIX5pnDkig",

"alias": "mozarts-coffee-roasters-austin",

"name": "Mozart's Coffee Roasters",

"url": "https://www.yelp.com/biz/mozarts-coffee-roasters-austin",

"summary": "Lakeside cafe offers live music and scenic views with specialty coffee.",

"specialties": "Mozart's is proud to be an "Austin Original". We opened our doors in 1993 with the dream of offering a place to enjoy quality coffee in a beautiful setting.",

"history": null,

"year_established": null,

"rating": 4,

"review_count": 2153,

"not_recommended_review_count": 136,

"price_range": "$$",

"phone": "5555550100",

"website": "https://mozartscoffee.com",

"menu_url": "https://mozartscoffee.com/pages/mozartsmenu",

"address": "3825 Lake Austin Blvd, Austin, TX 78703",

"street_address": "3825 Lake Austin Blvd",

"city": "Austin",

"state": "TX",

"postal_code": "78703",

"country": "US",

"timezone": "America/Chicago",

"latitude": 30.29547,

"longitude": -97.783951,

"has_storefront_address": true,

"is_online_business": false,

"is_open_now": true,

"is_closed_today": false,

"is_closed": false,

"closed_until": null,

"image": "https://s3-media0.fl.yelpcdn.com/bphoto/L-7Oduckn9nS9hPUAHiGeA/l.jpg",

"media_count": 3430,

"photo_count": 3430,

"popular_items_title": "Popular Desserts",

"popular_items_omitted": false,

"question_count": 15,

"is_claimed": true,

"is_claimable": false,

"is_advertiser": true,

"is_yelp_guaranteed": false,

"is_multi_location": false,

"last_verified": "Verified over 3 months ago",

"last_verified_by": "Christine K.",

"messaging_enabled": true,

"impact_message": "32 people want to know about Mozart's Coffee Roasters today",

"search_impressions": 4697,

"filtered_review_count": 2148,

"response_time": 5516,

"credits_used": 2,

"credits_remaining": 4818

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") biz = client.yelp.business(business_id="mozarts-coffee-roasters-austin") d = biz["data"] print(d["name"], d["rating"], d["rating_distribution"]) print("hidden by Yelp's filter:", d["not_recommended_review_count"]) # The first page of reviews rides along - do NOT call /reviews with page=1 for review in d["reviews"]: print(review["rating"], review["author"], review["text"][:80])