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

Search query

find_desc

Optional

Parameter defines the query you want to search. You can use anything that you would use in a regular Yelp search.

Geographic location

find_loc

Required

Parameter defines from where you want the search to originate. You can use any location you would use in a regular Yelp search. Following location formats are acceptable:

- 706 Mission St, San Francisco, CA
- San Francisco, CA
- San Francisco, CA 94103
- 94103

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.

Advanced parameters

sortby

Optional

Parameter is used for sorting results. Available options:

recommended - Recommended (default)
rating - Highest Rated
review_count - Most Reviewed

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

engine

Required

Set parameter to yelp to use the Yelp API engine.

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.

api_key

Required

Parameter defines the SerpApi private key to use.

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

Example with find_desc: Coffee and find_loc: New York, NY, USA as a location

JSON Example

{
  "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"
  }
}