Yelp Place Scraper API
When a Yelp place search contains place results, they are parsed and exist within the place_results array in the JSON output. Place results can contain name, review, rating, address, country, website, price, phone, categories and more.
API Parameters
Search Query
place_id
Optional
Parameter defines the Yelp ID of a place. Each place has two unique IDs (e.g. ED7A7vDdg8yLNKJTSVHHmg and arabica-brooklyn) and you can use either of them as a value of the place_id. To extract the IDs of a place you can use our Yelp Search API.
Localization
yelp_domain
Optional
Parameter defines the Yelp domain to use. It defaults to yelp.com. Head to the Yelp domains for a full list of supported Yelp domains.
Serpapi Parameters
no_cache
Optional
Parameter will force SerpApi to fetch the Yelp place results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to false (default) to allow results from the cache, or true to disallow results from the cache. no_cache and async parameters should not be used together.
async
Optional
Parameter defines the way you want to submit your search to SerpApi. It can be set to false (default) to open an HTTP connection and keep it open until you got your search results, or true to just submit your search to SerpApi and retrieve them later. In this case, you'll need to use our Searches Archive API to retrieve your results. async and no_cache parameters should not be used together. async should not be used on accounts with Ludicrous Speed enabled.
zero_trace
Optional
Enterprise only. Parameter enables ZeroTrace mode. It can be set to false (default) or true. Enable this mode to skip storing search parameters, search files, and search metadata on our servers. This may make debugging more difficult.
JSON structure overview
{
...
"place_results": {
"name": "String - Name of the place (Ex: '% Arabica')",
"business_alert": "String - Alert message about the place (Ex: 'Yelpers report this location has closed.', 'Place is temporarily closed.')",
"about": "String - Extra Information about the place ('Maman, a café and bakery in SoHo, serves family-inspired recipes from the South of France.')",
"reviews": "Integer - Number of reviews of the place (Ex: 229)",
"rating": "Float - Rating of the place (Ex: 4.4)",
"is_claimable": "Boolean - Whether the page of the place is claimable or not. In some cases, a place is still claimable although it is claimed. (Ex: false)",
"is_claimed": "Boolean - Whether the page of the place is claimed or not. (Ex: true)",
"price": "String - Expensiveness expressed in currency (Ex: '$$')",
"categories": [
{
"title": "String - Category title (Ex: 'Coffee & Tea')",
"link": "String - Yelp link to category"
},
...
],
"images": [
"String - Link to an image of the place",
...
],
"see_all_images_link": "String - Yelp link to all images of the place",
"website": "String - Website of the place",
"phone": "String - Phone number of the place",
"address": "String - Address of the place",
"directions": "String - Yelp Map directions link to the place",
"history": {
"description": "String - Description about the history of the place (Ex: 'In 2021, Maman founders released the highly anticipated cookbook')",
"established": "String - Establishment date of the place (Ex: '2014')"
},
"popular_items": [
{
"title": "String - Name of a popular dish or drink of the place (Ex: 'Spanish Lattes')",
"photos": "Integer - Number of photos of the popular item (Ex: 71)",
"reviews": "Integer - Number of reviews made to a popular item (Ex: 88)",
"thumbnail": "String - Link to the thumbnail of a popular item"
},
...
],
"ambiance": {
"images": [
{
"title": "String - Title of the images",
"photos": "Integer - Total number of photos",
"images": "Array - Link to the images"
},
...
],
"highlights": "Array - List of highlights of the ambiance"
},
"review_highlights": [
{
"highlight": "String - Highlighted word in a review (Ex 'Kyoto Latte')",
"review": "String - Entire review text (Ex: 'Kyoto Latte was refreshing.')",
"review_count": "Integer - Number of reviews with the same highlighted word (Ex: 27)",
"author": "String - Author of the Review",
"thumbnail": "String - Link to thumbnail of a review",
"link": "String - Yelp Link to all reviews with the highlighted word"
},
...
],
"website_menu": "String - Yelp redirection link to the menu on the website of the place",
"full_menu": "String - Yelp link to the menu of the place",
"business_map": "String - Link to the image of Google Maps marking the place",
"cross_streets": "String - Cross streets where the place is located (Ex: 'Grand St & Cleveland Pl')",
"neighborhoods": [
"String - Neighborhoods nearby the place (Ex: 'Brooklyn Heights')",
],
"country": "String - Two letter country code of the place's location (Ex: 'US')",
"operation_hours": {
"last_update": "String - Information about when the operational hours were updated (Ex: 'Hours updated 1 month ago')",
"hours": [
{
"day": "String - Day at the operational hours table (Ex: 'Mon')",
"hours": "String - Operational hours of the day (Ex: '8:00 AM - 6:00 PM')",
"currently_open": "Boolean - If the place is open on the day or not (Ex: true)"
},
...
]
},
"health_provider": {
"name": "String - Name of the health provider company of the place (Ex: 'Hazel Analytics')",
"link": "String - Link to the website of the health provider company",
"score": "String - Score given by the health provider company (Ex: 'A')"
},
"features": [
{
"title": "String - Title of the feature of the place (Ex: 'Offers Takeout')",
"is_active": "Boolean - Whether or not the feature is active (Ex: true)"
},
...
],
"community_questions": [
{
"question": "String - Question from the community about the place (Ex: 'Do they sell whole bean coffee to go?')",
"answer": "String - Answer to the question from the community (Ex: 'Yes')",
"author": "String - Author of the question",
"date": "String - Date of the question (Ex: '2 years ago')",
"helpful_vote_count": "Integer - How many people vote this question to be helpful (Ex: 2)",
"extra_link": {
"text": "String - Text of the extra button about question or answer (Ex: 'See question details')",
"link": "String - Yelp link of the extra button about question or answer"
},
},
...
],
"see_more_questions_link": "String - Yelp link to more community questions about the place"
}
}
API Examples
Place results overview
{
"search_metadata": {
"id": "670c8d1796562260e45f7fe7",
"status": "Success",
"json_endpoint": "https://serpapi.com/searches/ca3f7036d2d7016d/670c8d1796562260e45f7fe7.json",
"created_at": "2024-10-14 03:16:39 UTC",
"processed_at": "2024-10-14 03:16:40 UTC",
"yelp_place_url": "https://www.yelp.com/biz/maman-new-york-22",
"raw_html_file": "https://serpapi.com/searches/ca3f7036d2d7016d/670c8d1796562260e45f7fe7.html",
"total_time_taken": 1.33
},
"search_parameters": {
"engine": "yelp_place",
"place_id": "maman-new-york-22"
},
"place_results": {
"name": "Maman",
"about": "maman is a french bakery, café and leading lifestyle brand with locations across north america and canada. inspired by family traditions, and the highest quality ingredients, maman offers a selection of delicious baked goods {including their famous nutty chocolate chip cookie}, coffee, fresh breakfast, and lunch options spanning from hearty salads & sandwiches to savory quiches. in addition to hosting intimate events, maman has partnered with leading brands for partnerships and activations. from baby showers and birthday parties to engagements, they're able to help celebrate customers & make new beautiful memories. in september 2021, maman founders elisa marshall & benjamin sormonte released the highly anticipated maman: the cookbook.",
"reviews": 847,
"rating": 3.9,
"is_claimed": true,
"price": "$$",
"categories": [
{
"title": "Coffee & Tea",
"link": "https://www.yelp.com/search?find_desc=Coffee+%26+Tea&find_loc=New+York%2C+NY"
},
{
"title": "Bakeries",
"link": "https://www.yelp.com/search?find_desc=Bakeries&find_loc=New+York%2C+NY"
},
{
"title": "Breakfast & Brunch",
"link": "https://www.yelp.com/search?find_desc=Breakfast+%26+Brunch&find_loc=New+York%2C+NY"
}
],
"images": [
"https://s3-media0.fl.yelpcdn.com/bphoto/wfDzNa6yoflDFvKbO7UGnw/l.jpg",
"https://s3-media0.fl.yelpcdn.com/bphoto/3JRNOL1twgmq5s7e6kU5cQ/l.jpg",
"https://s3-media0.fl.yelpcdn.com/bphoto/dCIj5bWCOM_PORWLqQB4ow/l.jpg",
...
],
"see_all_images_link": "https://www.yelp.com/biz_photos/DE0ROwygh-86i4s-WLp8wQ",
"website": "https://www.mamannyc.com",
"phone": "(212) 226-0700",
"address": "239 Centre St New York, NY 10013",
"directions": "https://www.yelp.com/map/DE0ROwygh-86i4s-WLp8wQ",
"history": {
"description": "maman is a french café and lifestyle brand, offering baked goods, coffee, fresh breakfast, and lunch options, as well as hosting intimate events and brand partnerships. in 2021, maman founders released the highly anticipated maman: the cookbook. {please note we are laptop free environment}",
"established": "2014"
},
"popular_items": [
{
"title": "Almond Croissant",
"photos": 18,
"reviews": 28,
"thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/hSF_ejYc-oL7hxgpyIwWCA/258s.jpg"
},
{
"title": "Maman's Breakfast Sandwich",
"photos": 19,
"reviews": 25,
"thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/wfDzNa6yoflDFvKbO7UGnw/258s.jpg"
},
{
"title": "Pistachio Croissant",
"photos": 18,
"reviews": 20,
"thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/n7X36hQYffIaP4uXtY0aRg/258s.jpg"
},
...
],
"ambiance": {
"images": [
{
"title": "Inside",
"photos": 305,
"images": [
"https://s3-media0.fl.yelpcdn.com/bphoto/3JRNOL1twgmq5s7e6kU5cQ/258s.jpg",
"https://s3-media0.fl.yelpcdn.com/bphoto/lkuTCHip8o2vRQqmZ4jJhg/258s.jpg",
"https://s3-media0.fl.yelpcdn.com/bphoto/Q8GdeIQ7IywI5U6R7jR_9g/258s.jpg",
...
]
},
{
"title": "Outside",
"photos": 130,
"images": [
"https://s3-media0.fl.yelpcdn.com/bphoto/Z3En-1sIgkvxNsBJCLlHCQ/258s.jpg",
"https://s3-media0.fl.yelpcdn.com/bphoto/l2zbQ1_DSsMFM3L1lH2a_A/258s.jpg",
"https://s3-media0.fl.yelpcdn.com/bphoto/X1oRyEuPLt5LvfKT7IvGMw/258s.jpg",
...
]
},
{
"title": "All photos",
"photos": 1561,
"images": [
"https://s3-media0.fl.yelpcdn.com/bphoto/wfDzNa6yoflDFvKbO7UGnw/258s.jpg",
"https://s3-media0.fl.yelpcdn.com/bphoto/3JRNOL1twgmq5s7e6kU5cQ/258s.jpg",
"https://s3-media0.fl.yelpcdn.com/bphoto/dCIj5bWCOM_PORWLqQB4ow/258s.jpg",
...
]
}
],
"highlights": [
"Moderate noise",
"Classy",
"Casual",
...
]
},
"review_highlights": [
{
"author": "Kenneth L.",
"link": "https://www.yelp.com/biz/maman-new-york-22?hrid=BmAy7YQQW_AOR0_pHZAm_Q&rh_ident=almond-croissant&rh_type=menu",
"review": "We also got an almond croissant, a pistachio chocolate croissant, and a few of their chocolate chip cookies.",
"highlight": "almond croissant",
"review_count": 28,
"thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/gQ-n8zSqH4I3dzAzPByV0Q/60s.jpg"
},
{
"author": "Emily T.",
"link": "https://www.yelp.com/biz/maman-new-york-22?hrid=TTi-o8SD9sJViMIdLsqwnA&rh_ident=mamans-breakfast-sandwich&rh_type=menu",
"review": "I really enjoyed the breakfast sandwich and my latte, which I was able to get in a to-go cup on my way out.",
"highlight": "breakfast sandwich",
"review_count": 25,
"thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/GsealMV-U1JiIwMIZDpz-w/60s.jpg"
},
{
"author": "Shaiza S.",
"link": "https://www.yelp.com/biz/maman-new-york-22?hrid=Ra6JrnK8Hkcg2lQNa1Ob9w&rh_ident=nutty_chocolate_chip_cookie&rh_type=phrase",
"review": "Here's everything I've tried: nutty chocolate chip cookie--I've had three of these on three different occasions.",
"highlight": "nutty chocolate chip cookie",
"review_count": 23,
"thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/pMXy-EmzfjQm3YyTsaq3mA/60s.jpg"
},
...
],
"full_menu": "https://www.yelp.com/menu/maman-new-york-22",
"business_map": "https://maps.googleapis.com/maps/api/staticmap?size=315x180&sensor=false&client=gme-yelp&language=en&scale=1&zoom=15¢er=40.720295%2C-73.998393&markers=scale%3A1%7Cicon%3Ahttps%3A%2F%2Fyelp-images.s3.amazonaws.com%2Fassets%2Fmap-markers%2Fannotation_32x43.png%7C40.720295%2C-73.998393&signature=CIdXlvLIpZ_R3R0q1ApdjMr9W4o=",
"cross_streets": "Grand St & Broome St",
"neighborhoods": [
"Little Italy",
"SoHo"
],
"country": "US",
"operation_hours": {
"last_update": "Updated 1 week ago",
"hours": [
{
"day": "Mon",
"hours": "7:30 AM - 6:00 PM"
},
{
"day": "Tue",
"hours": "7:30 AM - 6:00 PM"
},
...
{
"day": "Sun",
"hours": "8:00 AM - 6:00 PM",
"currently_open": false
}
]
},
"health_provider": {
"name": "Health Department Intelligence",
"link": "https://hazelanalytics.com/",
"score": "A"
},
"features": [
{
"title": "Offers Delivery",
"is_active": true
},
{
"title": "Offers Takeout",
"is_active": true
},
{
"title": "No Reservations",
"is_active": false
},
...
],
"community_questions": [
{
"question": "Do you need reservations?",
"answer": "No you don't",
"author": "Stephanie G.",
"date": "2022-05-08T00:16:01Z",
"helpful_vote_count": 0
}
],
"see_more_questions_link": "https://www.yelp.com/questions/DE0ROwygh-86i4s-WLp8wQ"
}
}
Business Alert Example
Business alert shows the most recent operation status of a business. It is usually present when the business has moved or closed. Set business_alert to true to include business alert information.
Example of business alert:
- Business is temporarily closed.
- Yelpers report this location has closed.
{
...
"place_results": {
"name": "That's Yogurt",
"business_alert": "Yelpers report this location has closed.",
"reviews": 107,
"rating": 2.9,
"price": "$$",
"categories": [
{
"title": "Ice Cream & Frozen Yogurt",
"link": "https://www.yelp.com/search?find_desc=Ice+Cream+%26+Frozen+Yogurt&find_loc=Milpitas%2C+CA"
}
],
...
}
}