API de Yelp
Busca negocios en Yelp y consulta su ficha o reseñas públicas mediante URL. Nombre, categoría, contacto y rating ayudan a distinguir establecimientos.
Un horario, teléfono o valoración puede cambiar y no certifica disponibilidad o calidad. Las reseñas son una muestra pública y la API no las publica ni responde.
Disponibilidad de la plataforma
- Salud 24 h
- Normal
Últimos 30 días
Funciones disponibles
Cada acción de Yelp, qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.
| Capacidad | Qué hace | Por 1.000 | Salud en 24 horas |
|---|---|---|---|
Buscar negocios en Yelpsearch | Busca negocios en Yelp mediante keyword y devuelve categoría, rating, precio y contacto públicos. | $1.39 por 1.000 solicitudes | Normal |
Consultar la ficha de un negocioprofile | Abre la url de un negocio y recoge ficha, categorías, contacto, valoración y horario visible. | $1.39 por 1.000 solicitudes | Normal |
Leer reseñas de Yelpreviews | Lee reseñas de la url con autor, valoración, fecha y votos útil, divertido o cool. | $1.39 por 1.000 solicitudes | Normal |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿Qué acepta cada acción de Yelp?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
searchBuscar negocios en Yelp Busca negocios en Yelp mediante | keyword | location | Entrega síncrona | El catálogo declara defaultLimit = 10 y maxLimit = 50 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | id · name · url · rating · rating_scale · review_count · price_range · phone · website · categories · cuisine · description · address · city · region · postal_code · country · is_claimed · is_verified · health_score · established_year · image_url · platform · images · amenities · highlights · hours |
profileConsultar la ficha de un negocio Abre la | url | — | Entrega síncrona | — | $1.39 por 1.000 solicitudes | id · name · url · rating · rating_scale · review_count · price_range · phone · website · categories · cuisine · description · address · city · region · postal_code · country · is_claimed · is_verified · health_score · established_year · image_url · platform · images · amenities · highlights · hours |
reviewsLeer reseñas de Yelp Lee reseñas de la | url | page_token | Entrega síncrona | El catálogo declara defaultLimit = 10 y maxLimit = 10 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. Si envías un limit mayor, se acepta y se aplica maxLimit = 10. Para la siguiente página, devuelve next_page_token como page_token sin cambiar los demás parámetros; cada página es una llamada. | $1.39 por 1.000 solicitudes | id · text · rating · rating_scale · posted_at · author_name · useful_count · funny_count · cool_count · photo_count · business_name · business_url · platform |
¿Qué significan los parámetros de Yelp search?
Busca negocios en Yelp mediante keyword y devuelve categoría, rating, precio y contacto públicos. No reserva, recomienda por cuenta propia ni garantiza cobertura local completa.
keywordObligatorio- Palabra clave para buscar negocios o servicios locales con la acción
search, por ejemplo,coffee. Debes combinarlo conlocation; de lo contrario, la búsqueda se realiza por defecto en Nueva York, no a nivel global. locationOpcional- Ciudad, barrio o código postal para buscar negocios, por ejemplo
Austin, TXo78701. Es la ubicación del negocio, no la del autor de una reseña.
¿Qué significan los parámetros de Yelp profile?
Abre la url de un negocio y recoge ficha, categorías, contacto, valoración y horario visible. No acredita propiedad, licencia o disponibilidad actual.
urlObligatorio- Enlace a la página de un negocio en Yelp (con formato
/biz/<nombre_negocio>) para las accionesprofileoreviews. Permite obtener la información del negocio y sus reseñas, respectivamente. No es un perfil de usuario de Yelp.
¿Qué significan los parámetros de Yelp reviews?
Lee reseñas de la url con autor, valoración, fecha y votos útil, divertido o cool. El lote no representa necesariamente todas las opiniones ni permite responderlas.
urlObligatorio- Enlace a la página de un negocio en Yelp (con formato
/biz/<nombre_negocio>) para las accionesprofileoreviews. Permite obtener la información del negocio y sus reseñas, respectivamente. No es un perfil de usuario de Yelp.Yelp: reseñas recomendadas y puntuación general — Yelp indica que las reseñas no recomendadas en ese momento no cuentan para la valoración ni el total mostrado del negocio. Una muestra extraída no debe recalcularse y publicarse como la cifra oficial de Yelp. · Consultada page_tokenOpcional- Token de paginación: devuelve el next_page_token de la respuesta anterior para obtener la siguiente página; omítelo para la primera. Mantén el resto de parámetros sin cambios. Los tokens duran 24 horas y cada página es una llamada.
Cómo usar la API de Yelp
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"yelp","action":"search","params":{"keyword":"<keyword>"}}'
Preguntas sobre la API de Yelp
¿Cómo llamo a la API de Yelp?
Envía POST /api/v1/social con platform igual a yelp, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Yelp?
Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye name, rating, rating_scale y review_count. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de Yelp?
Yelp indica que las reseñas no recomendadas en ese momento no cuentan para la valoración ni el total mostrado del negocio. Una muestra extraída no debe recalcularse y publicarse como la cifra oficial de Yelp.
¿Qué parámetros son obligatorios?
Depende de la acción. search requiere keyword; profile requiere url; reviews requiere url.
¿Las acciones de Yelp responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.