Yelp Search Engine Results API
Our Yelp API allows you to scrape results from the Yelp search page.
The API endpoint is https://serpapi.com/search?engine=yelp
Head to the playground for a live and interactive demo.
Available results
Yelp returns up to 25 businesses for a search, so the API serves up to three pages of organic results. Yelp ranks results differently for each visitor, so use next_page_token from serpapi_pagination to get the next pages with the ranking of the first page. Ads, filters, review snippets, highlights, service options and phone numbers are no longer available, and the cflt, attrs and l parameters are no longer supported.
API parameters
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.
Pagination
start
Optional
Parameter defines the result offset. It skips the given number of results. It's used for pagination. (e.g., 0 (default) is the first page of results, 10 is the 2nd page of results, 20 is the 3rd page of results). Yelp returns at most 25 results for a search, so the maximum value is 24.
Yelp ranks results differently for each visitor, so pages requested with start can repeat or miss results. Use next_page_token to keep the ranking of the first page.
next_page_token
Optional
Parameter defines the next page token. It is used for retrieving the next page of results with the same ranking as the first page. Up to 10 results are returned per page.
Duplicate results can occasionally appear across pages because Yelp reorders results between requests. The same happens on yelp.com.
The next page token can be found in the SerpApi JSON response: serpapi_pagination -> next_page_token. It can't be used together with the start parameter.
SerpApi parameters
no_cache
Optional
Parameter will force SerpApi to fetch the Yelp 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.
output
Optional
Parameter defines the format of the result. It can be set to json (default) to get a structured JSON of the results, html to get the raw HTML retrieved, or md to get a Markdown-formatted version optimized for LLMs and AI agents.
json_restrictor
Optional
Parameter defines the fields you want to include in the output, reducing payload size for faster response. See the JSON Restrictor documentation for more details.
API results
JSON results
JSON output includes structured data for Organic Results.
A search status is accessible through search_metadata.status.
It flows this way: Processing -> Success || Error.
If a search has failed, error will contain an error message.
search_metadata.id is the search ID inside SerpApi.
HTML results
HTML output is useful to debug JSON results or support features not yet supported by SerpApi. It gives you the raw HTML results from Yelp.
Markdown results
Markdown output is optimized for LLMs and AI agents. It provides a curated view of the JSON results
in a token-efficient format using tables, markdown links, and YAML frontmatter.
To access, use the output=md parameter, the /search.md endpoint, or request header Accept: text/markdown.
API examples
Example with find_desc: Coffee and find_loc: New York, NY, USA as a location
{
"search_metadata": {
"id": "6908cd1e5d0d2e7f4a1b2c3d",
"status": "Success",
"json_endpoint": "https://serpapi.com/searches/84258a6c70981a89/6908cd1e5d0d2e7f4a1b2c3d.json",
"created_at": "2026-11-03 16:12:46 UTC",
"processed_at": "2026-11-03 16:12:46 UTC",
"yelp_url": "https://www.yelp.com/search?find_desc=Coffee&find_loc=New+York%2C+NY%2C+USA",
"raw_html_file": "https://serpapi.com/searches/84258a6c70981a89/6908cd1e5d0d2e7f4a1b2c3d.html",
"prettify_html_file": "https://serpapi.com/searches/84258a6c70981a89/6908cd1e5d0d2e7f4a1b2c3d.prettify",
"total_time_taken": 0.91
},
"search_parameters": {
"engine": "yelp",
"find_desc": "Coffee",
"find_loc": "New York, NY, USA"
},
"organic_results": [
{
"position": 1,
"place_ids": [
"ED7A7vDdg8yLNKJTSVHHmg",
"arabica-brooklyn"
],
"title": "% Arabica",
"link": "https://www.yelp.com/biz/arabica-brooklyn",
"reviews_link": "https://serpapi.com/search.json?engine=yelp_reviews&num=49&place_id=ED7A7vDdg8yLNKJTSVHHmg&start=0",
"categories": [
{
"title": "Coffee & Tea",
"link": "https://www.yelp.com/search?find_desc=Coffee+%26+Tea&find_loc=New+York%2C+NY%2C+USA"
}
],
"price": "$$",
"rating": 4.4,
"reviews": 366,
"address": "20 Old Fulton St",
"neighborhoods": "Brooklyn Heights",
"open_state": "Open until 6:00 PM",
"gps_coordinates": {
"latitude": 40.70260124,
"longitude": -73.99415048
},
"thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/RZ7MHlGjMjFpr9_KPPi8dg/ls.jpg"
},
{
"position": 2,
"place_ids": [
"K6fkejf2ZBUdlsVrm5RbrA",
"koré-coffee-new-york-7"
],
"title": "Koré Coffee",
"link": "https://www.yelp.com/biz/kor%C3%A9-coffee-new-york-7",
"reviews_link": "https://serpapi.com/search.json?engine=yelp_reviews&num=49&place_id=K6fkejf2ZBUdlsVrm5RbrA&start=0",
"categories": [
{
"title": "Coffee & Tea",
"link": "https://www.yelp.com/search?find_desc=Coffee+%26+Tea&find_loc=New+York%2C+NY%2C+USA"
}
],
"price": "$$",
"rating": 4.6,
"reviews": 335,
"address": "26A Elizabeth St",
"neighborhoods": "Chinatown",
"open_state": "Closes in 45 min",
"gps_coordinates": {
"latitude": 40.7161507,
"longitude": -73.9970321
},
"thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/FesYdZ-Ju-L-hI2Sdx_oJg/ls.jpg"
},
{
"position": 3,
"place_ids": [
"U3Ueh2bHtp3DLjrdc5w5fQ",
"remi-flower-and-coffee-new-york-2"
],
"title": "Remi Flower & Coffee",
"link": "https://www.yelp.com/biz/remi-flower-and-coffee-new-york-2",
"reviews_link": "https://serpapi.com/search.json?engine=yelp_reviews&num=49&place_id=U3Ueh2bHtp3DLjrdc5w5fQ&start=0",
"categories": [
{
"title": "Coffee & Tea",
"link": "https://www.yelp.com/search?find_desc=Coffee+%26+Tea&find_loc=New+York%2C+NY%2C+USA"
},
{
"title": "Florists",
"link": "https://www.yelp.com/search?find_desc=Florists&find_loc=New+York%2C+NY%2C+USA"
},
{
"title": "Floral Designers",
"link": "https://www.yelp.com/search?find_desc=Floral+Designers&find_loc=New+York%2C+NY%2C+USA"
}
],
"price": "$$",
"rating": 4.5,
"reviews": 765,
"address": "906 2nd Ave",
"neighborhoods": "Midtown East",
"open_state": "Open until 10:00 PM",
"gps_coordinates": {
"latitude": 40.753781,
"longitude": -73.9689989
},
"thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/jdhmWm_f2Js83l0prfbzLg/ls.jpg"
},
...
],
"pagination": {
"current": 1,
"next": "https://www.yelp.com/search?find_desc=Coffee&find_loc=New+York%2C+NY%2C+USA&start=10",
"other_pages": {
"2": "https://www.yelp.com/search?find_desc=Coffee&find_loc=New+York%2C+NY%2C+USA&start=10",
"3": "https://www.yelp.com/search?find_desc=Coffee&find_loc=New+York%2C+NY%2C+USA&start=20"
}
},
"serpapi_pagination": {
"current": 1,
"next": "https://serpapi.com/search.json?engine=yelp&find_desc=Coffee&find_loc=New+York%2C+NY%2C+USA&next_page_token=eyJ3ZGkiOiIyfEYyMjhBN0Q1NTIwNjc2QkF8MHgxLmFiYjI5ZjFlMDNkYzlwKzMwfGFjOTczYjQ5ODdmNmZlN2IiLCJzdGFydCI6MTB9",
"other_pages": {
"2": "https://serpapi.com/search.json?engine=yelp&find_desc=Coffee&find_loc=New+York%2C+NY%2C+USA&next_page_token=eyJ3ZGkiOiIyfEYyMjhBN0Q1NTIwNjc2QkF8MHgxLmFiYjI5ZjFlMDNkYzlwKzMwfGFjOTczYjQ5ODdmNmZlN2IiLCJzdGFydCI6MTB9",
"3": "https://serpapi.com/search.json?engine=yelp&find_desc=Coffee&find_loc=New+York%2C+NY%2C+USA&next_page_token=eyJ3ZGkiOiIyfEYyMjhBN0Q1NTIwNjc2QkF8MHgxLmFiYjI5ZjFlMDNkYzlwKzMwfGFjOTczYjQ5ODdmNmZlN2IiLCJzdGFydCI6MjB9"
},
"next_link": "https://serpapi.com/search.json?engine=yelp&find_desc=Coffee&find_loc=New+York%2C+NY%2C+USA&next_page_token=eyJ3ZGkiOiIyfEYyMjhBN0Q1NTIwNjc2QkF8MHgxLmFiYjI5ZjFlMDNkYzlwKzMwfGFjOTczYjQ5ODdmNmZlN2IiLCJzdGFydCI6MTB9",
"next_page_token": "eyJ3ZGkiOiIyfEYyMjhBN0Q1NTIwNjc2QkF8MHgxLmFiYjI5ZjFlMDNkYzlwKzMwfGFjOTczYjQ5ODdmNmZlN2IiLCJzdGFydCI6MTB9"
}
}