Yelp Поиск API
Ищет в Yelp компании по ключевому слову и местоположению: до 20 записей с рейтингами, категориями и основными данными о бизнесе за запрос.
2,50 USD/1 тыс. запросов, оплата за запрос, без подписки.
Best pizza Near Chicago, IL
Lou's Deep Dish Kitchen
2,418
$$ · Pizza, American (Traditional)
Lincoln Park
{"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}
Цены и поставщики
Цена API Yelp Поиск: один API, поставщиков 2, и любой может заменить другого
Первым обслуживает самый дешёвый поставщик. Если он не отвечает, его заменяет следующий в том же вызове.
не больше 0,03 USD за запрос1 результат0,0129 USDРезультатов: 100,021 USDРезультатов: 20Лимит 0,03 USDВы платите за то, что вернулось. Снизьте лимит, чтобы платить меньше: ни один запрос не обойдётся дороже лимита, сколько бы ни вернулось.IbexНе обслуживаетДоступность: 29,47%19190ms p5049,1% вызовов49,1%Вызовов: 282,00 USD/1 тыс. запросовflat
Поставщик с пометкой Не обслуживает перестал отвечать стабильно и выведен из ротации, поэтому ваши вызовы идут к остальным. Он вернётся сам, как только снова начнёт отвечать стабильно.
Попробовать
Получите Yelp Поиск одним запросом
В этом примере показано полей: 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, по одному примеру значения на поле.
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.
- 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.