API Yelp

Yelp Поиск API

Ищет в Yelp компании по ключевому слову и местоположению: до 20 записей с рейтингами, категориями и основными данными о бизнесе за запрос.

2,50 USD/1 тыс. запросов, оплата за запрос, без подписки.

Best pizza Near Chicago, IL - Yelp
yelp.com/search?find_desc=pizza&find_loc=Chicago%2C%20IL
yelp
AllDeliveryTakeoutPriceOpen Now

Best pizza Near Chicago, IL

1.

2,418

$$ · Pizza, American (Traditional)

Lincoln Park

2.
3.
Lou's Deep Dish Kitchen
Yelp
Что вернул APIitems[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
}
Доступность
100,00%
30d · Вызовов: 76
Запросы
91
30 дн. · по неделям, последние недель: 12
Ответ
15,7s
медиана · 30d

Цены и поставщики

Цена API Yelp Поиск: один API, поставщиков 2, и любой может заменить другого

Первым обслуживает самый дешёвый поставщик. Если он не отвечает, его заменяет следующий в том же вызове.

Поставщик с пометкой Не обслуживает перестал отвечать стабильно и выведен из ротации, поэтому ваши вызовы идут к остальным. Он вернётся сам, как только снова начнёт отвечать стабильно.

Вы платите
25,00 USD
2,50 USD/1 тыс. запросов, только за то, чем пользуетесь. Без ежемесячного тарифа.
Ваши первые запросы (40) бесплатны за счёт стартового баланса 0,10 USD.

Попробовать

Получите Yelp Поиск одним запросом

requireFieldsarray
Необязательно; если не указывать, маршрутизация не меняется и обслуживает самый дешёвый источник. Назовите выходные поля, которые этот запрос должен уметь вернуть, например `is_closed` или `price`, и его обслужит только источник, который возвращает каждое из них. Поля, которые вы не назвали, по-прежнему возвращаются, когда они есть у обслуживающего источника. Это может поднять вашу цену: если самый дешёвый источник не может вернуть названное поле, обслуживает более дорогой, и вам называют и списывают его цену. Названное поле всё равно может отсутствовать в месте, где его действительно нет. Указание сочетания полей, которые вместе не возвращает ни один источник, отклоняется как неверный ввод, без списания.
Открыть в
Пример ответа
Бесплатные запуски возвращают только первые результаты: 3. Пополните ключ, чтобы получить полный ответ.

В этом примере показано полей: 29 из 30. Все поля

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

Полный справочник по параметрам и ответу: каждое поле, тип и пример для этого эндпоинта.

Справочник

Один запрос, один формат ответа.

Каждое поле, которое вы отправляете, и каждое поле, которое получаете, с реальным примером.

Проверено 2026-11-21 · доступность и задержка измерены за 30d

Тело запроса

JSON, отправляется на этот эндпоинт.

  • locationstring

    Chicago, IL

    Город и штат, задающие область поиска (например, San Francisco, CA).

  • querystring

    pizza

    Поисковый запрос или категория (например, sushi).

  • limitinteger

    3

    Максимальное число возвращаемых результатов (от 1 до 20, по умолчанию 20).

  • requireFieldsarray

    Необязательно; если не указывать, маршрутизация не меняется и обслуживает самый дешёвый источник. Назовите выходные поля, которые этот запрос должен уметь вернуть, например `is_closed` или `price`, и его обслужит только источник, который возвращает каждое из них. Поля, которые вы не назвали, по-прежнему возвращаются, когда они есть у обслуживающего источника. Это может поднять вашу цену: если самый дешёвый источник не может вернуть названное поле, обслуживает более дорогой, и вам называют и списывают его цену. Названное поле всё равно может отсутствовать в месте, где его действительно нет. Указание сочетания полей, которые вместе не возвращает ни один источник, отклоняется как неверный ввод, без списания.

Вы отправляете. Небольшое тело JSON. Показанные значения это примеры, замените их своими.

Ответ

JSON, по одному примеру значения на поле.

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.

  • address2stringможет потребовать

    Secondary address line.

  • address3stringможет потребовать

    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_phonestringможет потребовать

    +13125550142

    Dialable phone number.

  • idstring

    abc123XyzChicagoDeepDish

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

  • is_closedbooleanможет потребовать

    false

    Whether the business is permanently closed.

  • latitudenumber

    41.9214

    Latitude of the business.

  • localized_phonestringможет потребовать

    (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_countintegerможет потребовать

    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.

  • priceintegerможет потребовать

    2

    Numeric price tier.

  • review_countinteger

    2418

    Number of reviews.

  • statestring

    IL

    State or region code.

  • unrounded_avg_ratingnumberможет потребовать

    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.

Вы получаете. Именованные типизированные поля в одном формате, какой бы источник ни ответил.

Вопросы и ответы

Об API Yelp Поиск

AnyAPI Yelp Поиск API возвращает данные Yelp в виде нормализованного JSON одним вызовом POST к /v1/run/yelp.search. Ищет в Yelp компании по ключевому слову и местоположению: до 20 записей с рейтингами, категориями и основными данными о бизнесе за запрос. AnyAPI направляет каждый запрос по источникам (их 2) и автоматически переключается, если один из них отказывает. Это стоит от 2,50 USD за 1000 запросов, в долларах США, без подписки и без ежемесячного минимума. За последние 30 дней 100,0% вызовов Yelp Поиск через AnyAPI завершились успешно, медианное время ответа 15,7 с, измерено вызовов: 76.

Это стоит от 2,50 USD за 1000 запросов, в долларах США, без подписки и без ежемесячного минимума. Вы пополняете один кошелёк в долларах США, и каждый вызов списывает с него. По некоторым неудавшимся запросам, оплаченным из кошелька, возникают расходы на обработку; мы передаём их по себестоимости, без наценки, а сумма списания указана в ответе с ошибкой.

Ищет в Yelp компании по ключевому слову и местоположению: до 20 записей с рейтингами, категориями и основными данными о бизнесе за запрос. Ответ это нормализованный JSON с тем же конвертом, что возвращает каждый эндпоинт AnyAPI, поэтому разбор второго эндпоинта это смена URL и ничего больше.

За последние 30 дней 100,0% вызовов Yelp Поиск через AnyAPI завершились успешно, медианное время ответа 15,7 с, измерено вызовов: 76. Это собственные измерения AnyAPI по трафику через шлюз, пересчитываемые непрерывно, а не опубликованный целевой уровень обслуживания.

Да. Новый аккаунт AnyAPI стартует с бесплатным балансом 0,10 USD, карта не нужна. Этого хватает на 40 вызовов Yelp Поиск по 0,0025 USD за каждый.

AnyAPI в том же запросе обращается к следующему из источников (их 2), начиная с самого дешёвого, поэтому отказ одного источника не ломает ваш вызов.

Отправьте запрос POST на https://api.getanyapi.com/v1/run/yelp.search с вашим ключом AnyAPI в заголовке "Authorization: Bearer" и входными данными в теле JSON. Один и тот же ключ и один и тот же кошелёк работают на каждом эндпоинте AnyAPI.

Нет. Вы пополняете один предоплаченный баланс AnyAPI в долларах США, и каждый запрос списывает с него. Ежемесячного тарифа и минимума нет, а один и тот же баланс оплачивает каждый эндпоинт AnyAPI.

Да. Установите @getanyapi/sdk из npm для TypeScript или getanyapi из pip для Python. Оба вызывают любой эндпоинт AnyAPI с одним и тем же ключом, а ещё подойдёт любой HTTP-клиент.

Да. Агент может подключиться к MCP-серверу AnyAPI по адресу https://api.getanyapi.com/mcp или создать собственный бесплатный пробный ключ одним POST без аутентификации на https://api.getanyapi.com/agent/signup и вызывать этот эндпоинт по HTTP.