Yelp Organic Results API
When a Yelp search contains organic results, they are parsed and exist within the organic_results array in the JSON output. Organic results can contain position, title, link, thumbnail, snippet, rating, reviews, categories, neighborhoods and more.
The API endpoint is https://serpapi.com/search?engine=yelp
Head to the playground for a live and interactive demo.
API Examples
Organic results overview for q: Coffee
{
...
"organic_results": [
{
"position": 1,
"place_ids": [
"K6fkejf2ZBUdlsVrm5RbrA",
"kore-coffee-new-york-2"
],
"title": "Kore Coffee",
"link": "https://www.yelp.com/biz/kore-coffee-new-york-2?osq=Coffee",
"reviews_link": "https://serpapi.com/search.json?engine=yelp_reviews&place_id=K6fkejf2ZBUdlsVrm5RbrA",
"categories": [
{
"title": "Coffee & Tea",
"link": "https://www.yelp.com/search?cflt=coffee&find_loc=New+York%2C+NY%2C+USA"
}
],
"rating": 5,
"reviews": 13,
"neighborhoods": "Chinatown",
"highlights": [
"Opened 6 weeks ago"
],
"snippet": "Nice small cozy coffee place. Tried their signature Matcha Tiramisu Latte (only served cold) and Matcha Latte, both are nice.",
"thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/Nfc-QcUS71NWWjdlDx8JBw/348s.jpg"
},
{
"position": 2,
"place_ids": [
"-2UtjTxrt1Xzd-HPsLJ7mA",
"butler-brooklyn-2"
],
"title": "Butler",
"link": "https://www.yelp.com/biz/butler-brooklyn-2?osq=Coffee",
"reviews_link": "https://serpapi.com/search.json?engine=yelp_reviews&place_id=-2UtjTxrt1Xzd-HPsLJ7mA",
"categories": [
{
"title": "Coffee & Tea",
"link": "https://www.yelp.com/search?cflt=coffee&find_loc=New+York%2C+NY%2C+USA"
},
{
"title": "Cafes",
"link": "https://www.yelp.com/search?cflt=cafes&find_loc=New+York%2C+NY%2C+USA"
}
],
"price": "$$",
"rating": 4,
"reviews": 150,
"neighborhoods": "DUMBO",
"snippet": "it is and it's gross. Don't buy the coffee here, this place doesn't seem sanitary.",
"service_options": {
"outdoor_dining": true,
"takeout": true
},
"thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/CU_zfWiYItMJkR6iJsnk0w/348s.jpg"
},
{
"position": 3,
"place_ids": [
"kpxXi23lUQkeJQH-2BtzDw",
"qahwah-house-brooklyn"
],
"title": "Qahwah House",
"link": "https://www.yelp.com/biz/qahwah-house-brooklyn?osq=Coffee",
"reviews_link": "https://serpapi.com/search.json?engine=yelp_reviews&place_id=kpxXi23lUQkeJQH-2BtzDw",
"categories": [
{
"title": "Cafes",
"link": "https://www.yelp.com/search?cflt=cafes&find_loc=New+York%2C+NY%2C+USA"
},
{
"title": "Middle Eastern",
"link": "https://www.yelp.com/search?cflt=mideastern&find_loc=New+York%2C+NY%2C+USA"
},
{
"title": "Coffee & Tea",
"link": "https://www.yelp.com/search?cflt=coffee&find_loc=New+York%2C+NY%2C+USA"
}
],
"price": "$",
"rating": 5,
"reviews": 183,
"neighborhoods": "Williamsburg - North Side",
"snippet": "I walked in and could smell the coffee and it was like coffee heaven. The employees were very",
"service_options": {
"outdoor_dining": true,
"delivery": true,
"takeout": true
},
"button": {
"text": "Start Order",
"link": "https://www.yelp.com/biz/kpxXi23lUQkeJQH-2BtzDw?show_platform_modal=True"
},
"thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/hGHi0N9J4Q-2lzp6b3EPkw/348s.jpg"
},
...
]
...
}
Organic results overview for q: Steakhouse
{
...
"organic_results": [
{
"position": 1,
"place_ids": [
"B_CmQZt-qrEZxSiiGFEyfw",
"aris-steakhouse-austin"
],
"title": "Aris Steakhouse",
"link": "https://www.yelp.com/biz/aris-steakhouse-austin?osq=steakhouse",
"reviews_link": "https://serpapi.com/search.json?engine=yelp_reviews&num=49&place_id=B_CmQZt-qrEZxSiiGFEyfw&start=0",
"categories": [
{
"title": "Steakhouses",
"link": "https://www.yelp.com/search?find_desc=Steakhouses&find_loc=Austin%2C+TX%2C+United+States"
}
],
"rating": 4.6,
"reviews": 78,
"neighborhoods": "Austin",
"open_state": "Closed until 5:00 PM",
"snippet": "Both were excellent and cooked perfectly. The carrots and Aris puree (i.e. squash and potato, mashed...",
"thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/sxvvMVs3vwZafgB5RNwolA/ls.jpg"
},
{
"position": 2,
"place_ids": [
"I6OrRuUmbIYoVRevwlUTrg",
"j-prime-steakhouse-austin-austin"
],
"title": "J Prime Steakhouse - Austin",
"link": "https://www.yelp.com/biz/j-prime-steakhouse-austin-austin?osq=steakhouse",
"reviews_link": "https://serpapi.com/search.json?engine=yelp_reviews&num=49&place_id=I6OrRuUmbIYoVRevwlUTrg&start=0",
"categories": [
{
"title": "Steakhouses",
"link": "https://www.yelp.com/search?find_desc=Steakhouses&find_loc=Austin%2C+TX%2C+United+States"
},
{
"title": "Wine Bars",
"link": "https://www.yelp.com/search?find_desc=Wine+Bars&find_loc=Austin%2C+TX%2C+United+States"
},
{
"title": "Cocktail Bars",
"link": "https://www.yelp.com/search?find_desc=Cocktail+Bars&find_loc=Austin%2C+TX%2C+United+States"
}
],
"price": "$$$$",
"rating": 4.5,
"reviews": 258,
"neighborhoods": "Downtown",
"open_state": "Closed until 4:00 PM",
"snippet": "I am definitely coming back! Loved it! One of the best steakhouses I have been to!!!",
"thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/WqZKv8jYWpz0LTc-JrjEmQ/ls.jpg"
},
{
"position": 3,
"place_ids": [
"ZY8tVbP1evHIawY8u3UDjA",
"boa-steakhouse-austin-2"
],
"title": "BOA Steakhouse",
"link": "https://www.yelp.com/biz/boa-steakhouse-austin-2?osq=steakhouse",
"reviews_link": "https://serpapi.com/search.json?engine=yelp_reviews&num=49&place_id=ZY8tVbP1evHIawY8u3UDjA&start=0",
"categories": [
{
"title": "Steakhouses",
"link": "https://www.yelp.com/search?find_desc=Steakhouses&find_loc=Austin%2C+TX%2C+United+States"
},
{
"title": "Bars",
"link": "https://www.yelp.com/search?find_desc=Bars&find_loc=Austin%2C+TX%2C+United+States"
},
{
"title": "Seafood",
"link": "https://www.yelp.com/search?find_desc=Seafood&find_loc=Austin%2C+TX%2C+United+States"
}
],
"price": "$$$$",
"rating": 4.5,
"reviews": 175,
"neighborhoods": "Warehouse District",
"open_state": "Closed until 5:00 PM",
"snippet": "Food is amazing as well. From the beginning to end this is the best steakhouse we've ever been to.",
"button": {
"text": "Order",
"link": "https://www.yelp.com/biz/ZY8tVbP1evHIawY8u3UDjA?show_platform_modal=True"
},
"thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/3Ynh9SDR2Dlko_b_J6CkwA/ls.jpg"
},
...
]
...
}
JSON structure overview
{
"organic_results": [
{
"position": "Integer - Position of the result in the search results",
"place_ids": [
"Array of strings containing Yelp's unique identifiers for the business"
],
"title": "String - Title of the result",
"link": "String - URL of the result",
"reviews_link": "String - URL to access reviews for the result via Yelp Reviews API",
"categories": [
{
"title": "String - Title of the category",
"link": "String - URL to search for this category on Yelp"
}
],
"price": "String - Price range (e.g., $, $$, $$$)",
"rating": "Float - Rating of the business",
"reviews": "Integer - Number of reviews for the business",
"neighborhoods": "String - Neighborhoods where the business is located",
"open_state": "String - Open state of the business (e.g., 'Open now', 'Closed', 'Opens at 9:00 AM')",
"highlights": [
"Array of strings highlighting specific features or attributes of the business"
],
"snippet": "String - Snippet of text describing the business",
"thumbnail": "String - URL of the thumbnail image for the business",
"service_options": {
"outdoor_dining": "Boolean - Returns `true` if the business offers outdoor dining",
"delivery": "Boolean - Returns `true` if the business offers delivery",
"takeout": "Boolean - Returns `true` if the business offers takeout"
},
"button": {
"text": "String - Text to display on a call-to-action button (e.g., 'Start Order')",
"link": "String - URL to link to when the button is clicked"
}
}
]
}