API de Yelp: Buscar
Busca negocios en Yelp por palabra clave y ubicación: hasta 20 resultados con calificaciones, categorías y datos básicos del negocio por solicitud.
US$2.50/1k solic., pagas por solicitud, sin suscripción.
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 campos más}
Precios y proveedores
Precios del endpoint Buscar de la API de Yelp: una API, 2 proveedores intercambiables
El proveedor más barato responde primero. Si falla, el siguiente toma el relevo en la misma llamada.
con un tope de US$0.0275 por solicitud1 resultadoUS$0.0118310 resultadosUS$0.019320 resultadostope de US$0.0275Se te cobra por lo que se devuelve. Baja el límite para pagar menos, y ninguna solicitud puede costar más que el tope, sin importar cuánto se devuelva.IbexFuera de servicio30.00% de disponibilidad19190ms p5049.2% de las llamadas49.2%30 llamadasUS$2.00/1k solic.flat
Un proveedor marcado como Fuera de servicio dejó de responder de forma confiable y se sacó de la rotación, así que tus llamadas van a los demás. Vuelve a entrar por sí solo cuando responde de forma confiable otra vez.
Pruébalo
Obtén Buscar de Yelp en una sola solicitud
Este ejemplo muestra 29 de 30 campos. Ver todos los campos
{
"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"
}
]
}
}Referencia completa de parámetros y respuesta: cada campo, tipo y ejemplo de este endpoint.
Referencia
Una solicitud, un formato de respuesta.
Cada campo que envías y cada campo que recibes, cada uno con un ejemplo real.
Verificado por última vez el 2026-11-14 · disponibilidad y latencia medidas en 30d
Cuerpo de la solicitud
JSON, enviado por POST a este endpoint.
- locationstring
Chicago, IL
Ciudad y estado que definen el área de búsqueda (p. ej., San Francisco, CA).
- querystring
pizza
Término o categoría a buscar (p. ej., sushi).
- limitinteger
3
Número máximo de resultados a devolver (de 1 a 20, por defecto 20).
- requireFieldsarray
Opcional; si lo omites, el enrutamiento no cambia y atiende la fuente más barata. Indica los campos de salida que esta solicitud debe poder devolver, por ejemplo `is_closed` o `price`, y solo la atenderá una fuente que los devuelva todos. Los campos que no indiques se siguen devolviendo siempre que la fuente que atiende los tenga. Esto puede subir tu precio: cuando la fuente más barata no puede devolver un campo indicado, atiende una fuente más cara, y se te cotiza y cobra su precio. Un campo indicado puede faltar igualmente en un lugar que realmente no lo tenga. Indicar una combinación que ninguna fuente devuelve junta se rechaza como entrada no válida, sin cargo.
Respuesta
JSON, un valor de ejemplo por campo.
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.
- address2stringse puede exigir
Secondary address line.
- address3stringse puede exigir
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_phonestringse puede exigir
+13125550142
Dialable phone number.
- idstring
abc123XyzChicagoDeepDish
Stable Yelp business identifier. Populated whenever the provider has data for the entity.
- is_closedbooleanse puede exigir
false
Whether the business is permanently closed.
- latitudenumber
41.9214
Latitude of the business.
- localized_phonestringse puede exigir
(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[]se puede exigir
Neighborhood labels for the location.
- phonestring
+13125550142
Raw phone number.
- photo_countintegerse puede exigir
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.
- priceintegerse puede exigir
2
Numeric price tier.
- review_countinteger
2418
Number of reviews.
- statestring
IL
State or region code.
- unrounded_avg_ratingnumberse puede exigir
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.
Preguntas frecuentes
Acerca del endpoint Buscar de la API de Yelp
El endpoint Buscar de AnyAPI para Yelp devuelve datos de Yelp como JSON normalizado con una sola llamada POST a /v1/run/yelp.search. Busca negocios en Yelp por palabra clave y ubicación: hasta 20 resultados con calificaciones, categorías y datos básicos del negocio por solicitud. AnyAPI enruta cada solicitud entre 2 fuentes y recurre automáticamente a otra cuando una falla. Cuesta desde US$2.50 por cada 1,000 solicitudes, en dólares estadounidenses, sin suscripción y sin mínimo mensual. En los últimos 30 días, el 93.8% de las llamadas al endpoint Buscar de la API de Yelp a través de AnyAPI tuvo éxito, con un tiempo de respuesta mediano de 18.6 segundos en 65 llamadas medidas.