Yelp API

Yelp Search API

Search Yelp for businesses by keyword and location: up to 20 listings with ratings, categories, and core business info per request.

Start freeDownload sampleor JSON

$3.50/1k req, pay per request, no subscription.

What the API returneditems[0]
{
"id": "abc123XyzChicagoDeepDish",
"name": "Lou's Deep Dish Kitchen",
"alias": "lous-deep-dish-kitchen-chicago",
"address1": "2145 N Halsted St",
"address2": "",
"address3": "",
"city": "Chicago",
"state": "IL",
... 18 more fields
}
Uptime
93.10%
30d · 58 calls
Requests
58
30d · weekly, last 12 wks
Response
7.7s
median · 30d

Pricing and providers

Yelp Search API pricing: one API, 2 interchangeable providers

The cheapest provider serves first. If it fails, the next one takes over in the same call.

You pay
$35.00
$3.50/1k req, only for what you use. No monthly plan.
Your first 28 requests are free with the $0.10 starting balance.

Call it

Get Yelp search in one request

import os, requests

res = requests.post(
    "https://api.getanyapi.com/v1/run/yelp.search",
    headers={"Authorization": f"Bearer {os.environ['ANYAPI_KEY']}"},
    json={
        "location": "",
        "query": ""
    },
)
print(res.json())
Open in
Get a free key
Sample response

This sample shows 29 of 30 fields. See every field

{
  "found": true,
  "data": {
    "items": [
      {
        "id": "abc123XyzChicagoDeepDish",
        "name": "Lou's Deep Dish Kitchen",
        "alias": "lous-deep-dish-kitchen-chicago",
        "address1": "2145 N Halsted St",
        "address2": "",
        "address3": "",
        "city": "Chicago",
        "state": "IL",
        "zip": "60614",
        "country": "US",
        "latitude": 41.9214,
        "longitude": -87.6486,
        "neighborhoods": [
          "Lincoln Park"
        ],
        "phone": "+13125550142",
        "localized_phone": "(312) 555-0142",
        "dialable_phone": "+13125550142",
        "review_count": 2418,
        "avg_rating": 4.5,
        "unrounded_avg_rating": 4.47,
        "is_closed": false,
        "price": 2,
        "localized_price": "$$",
        "categories": [
          {
            "alias": "pizza",
            "title": "Pizza"
          },
          {
            "alias": "tradamerican",
            "title": "American (Traditional)"
          }
        ],
        "photo_url": "https://s3-media0.fl.yelpcdn.com/bphoto/9f2a1b7c6e4d8a3b5c1f0e2d4a6b8c9d/o.jpg",
        "photo_count": 384,
        "url": "https://www.yelp.com/biz/lous-deep-dish-kitchen-chicago"
      },
      {
        "id": "def456UptownSlice",
        "name": "Uptown Slice House",
        "alias": "uptown-slice-house-chicago",
        "address1": "4560 N Broadway St",
        "address2": "",
        "address3": "",
        "city": "Chicago",
        "state": "IL",
        "zip": "60640",
        "country": "US",
        "latitude": 41.9647,
        "longitude": -87.6558,
        "neighborhoods": [
          "Uptown"
        ],
        "phone": "+17735550198",
        "localized_phone": "(773) 555-0198",
        "dialable_phone": "+17735550198",
        "review_count": 967,
        "avg_rating": 4,
        "unrounded_avg_rating": 4.02,
        "is_closed": false,
        "price": 1,
        "localized_price": "$",
        "categories": [
          {
            "alias": "pizza",
            "title": "Pizza"
          }
        ],
        "photo_url": "https://s3-media0.fl.yelpcdn.com/bphoto/2c4e6a8b0d1f3e5a7c9b1d3f5e7a9c0b/o.jpg",
        "photo_count": 156,
        "url": "https://www.yelp.com/biz/uptown-slice-house-chicago"
      },
      {
        "id": "ghi789WickerParkPie",
        "name": "Wicker Park Pie Co.",
        "alias": "wicker-park-pie-co-chicago",
        "address1": "1780 N Milwaukee Ave",
        "address2": "Suite 2",
        "address3": "",
        "city": "Chicago",
        "state": "IL",
        "zip": "60622",
        "country": "US",
        "latitude": 41.9127,
        "longitude": -87.6763,
        "neighborhoods": [
          "Wicker Park"
        ],
        "phone": "+17735550176",
        "localized_phone": "(773) 555-0176",
        "dialable_phone": "+17735550176",
        "review_count": 512,
        "avg_rating": 4.5,
        "unrounded_avg_rating": 4.46,
        "is_closed": false,
        "price": 2,
        "localized_price": "$$",
        "categories": [
          {
            "alias": "pizza",
            "title": "Pizza"
          },
          {
            "alias": "italian",
            "title": "Italian"
          }
        ],
        "photo_url": "https://s3-media0.fl.yelpcdn.com/bphoto/5a7c9e1b3d5f7a9c1e3b5d7f9a1c3e5b/o.jpg",
        "photo_count": 92,
        "url": "https://www.yelp.com/biz/wicker-park-pie-co-chicago"
      }
    ]
  }
}

Full parameter and response reference - every field, type, and example for this endpoint.

Reference

One request, one response shape.

Every field you send and every field you get back, each with a real example.

Last verified 2026-10-31 · uptime and latency measured over 30d

Request body

JSON, posted to this endpoint.

  • locationstring

    Chicago, IL

    City and state defining the search area (e.g. San Francisco, CA).

  • querystring

    pizza

    Search term or category to look for (e.g. sushi).

  • limitinteger

    3

    Maximum number of results to return (1 to 20, default 20).

  • requireFieldsarray

    Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `is_closed` or `price`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a place that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge.

You send. A small JSON body. The values shown are examples to replace with your own.

Response

JSON, one example value per field.

each itemdata.items[]

Business listing records: name, categories, rating, review count, address, and core business info. Populated whenever the provider has data for the entity.

  • address1string

    2145 N Halsted St

    Primary street address line.

  • address2stringcan require

    Secondary address line.

  • address3stringcan require

    Tertiary address line.

  • aliasstring

    lous-deep-dish-kitchen-chicago

    URL slug for the business. Populated whenever the provider has data for the entity.

  • avg_ratingnumber

    4.5

    Rounded average star rating.

  • categoriesobject[]

    Business category tags.

  • citystring

    Chicago

    City name.

  • countrystring

    US

    ISO country code.

  • dialable_phonestringcan require

    +13125550142

    Dialable phone number.

  • idstring

    abc123XyzChicagoDeepDish

    Stable Yelp business identifier. Populated whenever the provider has data for the entity.

  • is_closedbooleancan require

    false

    Whether the business is permanently closed.

  • latitudenumber

    41.9214

    Latitude of the business.

  • localized_phonestringcan require

    (312) 555-0142

    Formatted local phone number.

  • localized_pricestring

    $$

    Localized price tier (e.g. $$).

  • longitudenumber

    -87.6486

    Longitude of the business.

  • namestring

    Lou's Deep Dish Kitchen

    Business display name. Populated whenever the provider has data for the entity.

  • neighborhoodsstring[]

    Neighborhood labels for the location.

  • phonestring

    +13125550142

    Raw phone number.

  • photo_countintegercan require

    384

    Total photo count.

  • photo_urlstring

    https://s3-media0.fl.yelpcdn.com/bphoto/9f2a1b7c6e4d8a3b5c1f0e2d4a6b8c9d/o.jpg

    Primary photo URL. Populated whenever the provider has data for the entity.

  • priceintegercan require

    2

    Numeric price tier.

  • review_countinteger

    2418

    Number of reviews.

  • statestring

    IL

    State or region code.

  • unrounded_avg_ratingnumbercan require

    4.47

    Unrounded average star rating.

  • urlstring

    https://www.yelp.com/biz/lous-deep-dish-kitchen-chicago

    Public Yelp business page URL.

  • zipstring

    60614

    Postal code.

top level
  • foundboolean

    true

  • reason"not_found"

    Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

You get back. Named, typed fields in the same shape whichever source answers.

FAQ

About the Yelp Search API

The AnyAPI Yelp Search API returns Yelp search data as normalized JSON from one POST call to /v1/run/yelp.search. Search Yelp for businesses by keyword and location: up to 20 listings with ratings, categories, and core business info per request. AnyAPI routes each request across 2 sources and falls back automatically when one fails. It costs from $3.50 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 93.1% of Yelp search calls through AnyAPI succeeded, with a median response time of 7.7 seconds across 58 measured calls.

It costs from $3.50 per 1,000 requests, in US dollars with no subscription and no monthly minimum. You fund one USD wallet and each call draws it down. Some failed wallet-funded requests incur processing charges that we pass through at cost, with no markup; the error response shows the amount charged.

Search Yelp for businesses by keyword and location: up to 20 listings with ratings, categories, and core business info per request. The response is normalized JSON with the same envelope every AnyAPI endpoint returns, so parsing a second endpoint is a change of URL and nothing else.

Over the last 30 days, 93.1% of Yelp search calls through AnyAPI succeeded, with a median response time of 7.7 seconds across 58 measured calls. These are AnyAPI's own measurements of traffic through the gateway, recomputed continuously, not a published service-level target.

Yes. A new AnyAPI account starts with $0.10 of free balance and no card required, which covers 28 Yelp Search calls at $0.0035 each.

AnyAPI asks the next of its 2 sources in the same request, cheapest first, so one source going down does not fail your call.

Send a POST request to https://api.getanyapi.com/v1/run/yelp.search with your AnyAPI key in an "Authorization: Bearer" header and the input as a JSON body. The same key and the same wallet work on every AnyAPI endpoint.

No. You add US dollars to one prepaid AnyAPI balance and each request draws it down. There is no monthly plan and no minimum, and the same balance pays for every AnyAPI endpoint.

Yes. Install @getanyapi/sdk from npm for TypeScript or getanyapi from pip for Python. Both call every AnyAPI endpoint with the same key, and any HTTP client works too.

Yes. An agent can connect to the AnyAPI MCP server at https://api.getanyapi.com/mcp, or create its own free-trial key with one unauthenticated POST to https://api.getanyapi.com/agent/signup and call this endpoint over HTTP.