API de plataforma de EveryData
API de Yandex
Busca lugares y productos en Yandex y consulta reseñas públicas por URL. Idioma, ubicación, región, precio y orden se aplican según la acción elegida.
Ratings, compras mostradas y precios son señales del objeto observado. La API no reserva, compra, valida inventario ni responde reseñas.
- Endpoint
- POST /api/v1/social
- Funciones
- 3
- Por 1.000
- 1,389 US$
Funciones disponibles
Compara las acciones de Yandex por sus entradas obligatorias, datos devueltos y precio. Usa el identificador de la acción exactamente como aparece.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
searchBuscar lugares y negocios en Yandex Busca negocios o lugares mediante | keyword | category, lang, language, location, max_price, min_price, sort | Entrega síncrona | El catálogo declara `defaultLimit = 20` y `maxLimit = 100` 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 · url · name · text · address · city · country · categories · rating · rating_scale · review_count · phone · website · lat · lng · is_open_now · platform |
marketBuscar productos en Yandex Market Busca productos en Yandex Market mediante | keyword | city, max_price, min_price, region, sort | Entrega síncrona | El catálogo declara `defaultLimit = 20` y `maxLimit = 100` 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 · url · title · price · currency · rating · rating_scale · rating_count · review_count · purchase_count · category · shop_name · shop_rating · stock · is_available · image_url · platform |
reviewsLeer reseñas de un objeto Lee reseñas de la | url | language, sort | Entrega síncrona | El catálogo declara `defaultLimit = 20` y `maxLimit = 200` 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 · url · text · rating · rating_scale · posted_at · language · like_count · dislike_count · comment_count · author_name · owner_reply · business_id · business_name · business_rating · business_review_count · platform |
¿Qué acepta cada acción de Yandex?
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.
¿Qué significan los parámetros de Yandex search?
Busca negocios o lugares mediante keyword, con categoría, idioma, ubicación, precio u orden opcionales. Devuelve dirección y valoración pública; no confirma disponibilidad o calidad.
keywordObligatorio- Palabra clave para buscar negocios en mapas con la acción
searcho productos con la acciónmarket. Las reseñas de mapas y los productos de comercio electrónico son conjuntos de datos diferentes. categoryOpcional- Categoría del negocio para la acción
searchen mapas. Usanonepara no especificar. Los valores permitidos incluyenrestaurants,cafes,coffee_shops,hotels, etc. Consulta la lista completa de valores. No es una categoría de producto demarkety debe ser coherente con elkeywordy la ciudad de la búsqueda.Valores permitidos:atmsauto_repairbanksbars_pubsbeauty_salonsburgerscafescar_washcinemascoffee_shopsdentistsdry_cleaningfast_foodfitness_clubsgas_stationsgovernment_servicesgrocery_storeshookah_barshospitalshotelskindergartensmuseumsnonepharmaciespizzarestaurantsschoolsshopping_mallssports_facilitiessushi_rollsveterinary_clinicsYandex Maps: ficha, categoría y valoración de un lugarYandex Maps describe fichas con categoría, dirección, puntuación, número de reseñas y horario. Se cita para interpretar el lugar; los botones de la ficha no añaden reserva, edición o gestión del negocio a la API.Consultada langOpcional- Idioma para la acción
search. Valores:ru(ruso),en(inglés),kk(kazajo),tr(turco),uk(ucraniano). No garantiza que los comentarios se traduzcan a este idioma.Valores permitidos:enkkrutruk languageOpcional- Idioma de la interfaz. Por defecto es
ruparasearchyenparareviews. Si envías el parámetrolangen una llamada asearch, su valor anulará a este. locationOpcional- Ciudad para la búsqueda en mapas con la acción
search. Por defecto es Moscú. No es el código de región numérico demarket. max_priceOpcional- Condición de precio máximo para la acción correspondiente. Se usa junto con
min_price. No se refiere a la puntuación máxima. min_priceOpcional- Para la acción
market, es el precio mínimo del producto. Parasearch, es un filtro de rango de precios para negocios en mapas. El significado del precio es diferente en cada caso. El rango de precios de un negocio no debe confundirse con el precio de un producto ni con el coste de esta API. sortOpcional- Criterio de orden. Para
search, usarelevance(relevancia) odistance(distancia). Paramarket, usapopular(popularidad) otop_rated(mejor puntuación). Parareviews, usanewest(más recientes, por defecto),relevance(relevancia),highest(puntuación más alta primero) olowest(puntuación más baja primero). No mezcles los valores entre acciones.Valores permitidos:distancerelevance
¿Qué significan los parámetros de Yandex market?
Busca productos en Yandex Market mediante keyword, con ciudad, región, precio y orden opcionales. Devuelve precio, valoración y compras mostradas; no realiza pedidos ni garantiza stock.
keywordObligatorio- Palabra clave para buscar negocios en mapas con la acción
searcho productos con la acciónmarket. Las reseñas de mapas y los productos de comercio electrónico son conjuntos de datos diferentes. cityOpcional- Ciudad para la acción
market, comomoscow(Moscú) osaint_petersburg(San Petersburgo). Elige un valor de la lista de ciudades permitidas. No se usa para el parámetrolocationde la acciónsearch.Valores permitidos:chelyabinskkazankrasnodarkrasnoyarskmoscownizhny_novgorodnovosibirskomskpermrostov_on_donsaint_petersburgsamaraufavolgogradvoronezhyekaterinburgYandex Market: las condiciones de envío dependen de la ciudad y del productoLa documentación oficial sobre envíos vincula el método, el tiempo y el coste a la ciudad y al producto, indicando que las condiciones exactas se ven en la página del producto y de pago. Sirve para recordar que el precio en una búsqueda de productos no equivale al coste total final con envío ni a un compromiso de entrega.Consultada max_priceOpcional- Condición de precio máximo para la acción correspondiente. Se usa junto con
min_price. No se refiere a la puntuación máxima. min_priceOpcional- Para la acción
market, es el precio mínimo del producto. Parasearch, es un filtro de rango de precios para negocios en mapas. El significado del precio es diferente en cada caso. El rango de precios de un negocio no debe confundirse con el precio de un producto ni con el coste de esta API. regionOpcional- Código numérico de región para la acción
market. El valor por defecto es 213 (Moscú). No es el código de paísRU. Se recomienda usarcitypor ser más específico; si envíascity, su valor anulará aregion. sortOpcional- Criterio de orden. Para
search, usarelevance(relevancia) odistance(distancia). Paramarket, usapopular(popularidad) otop_rated(mejor puntuación). Parareviews, usanewest(más recientes, por defecto),relevance(relevancia),highest(puntuación más alta primero) olowest(puntuación más baja primero). No mezcles los valores entre acciones.Valores permitidos:populartop_rated
¿Qué significan los parámetros de Yandex reviews?
Lee reseñas de la url del objeto, con idioma y orden opcionales. Conserva likes, dislikes y comentarios contados; no publica respuestas ni garantiza todo el historial.
urlObligatorio- URL completa del negocio en mapas para la acción
reviews. También puedes enviar directamente elbusinessIden este campo. No es un enlace de producto de Yandex Market. languageOpcional- Idioma de la interfaz. Por defecto es
ruparasearchyenparareviews. Si envías el parámetrolangen una llamada asearch, su valor anulará a este.Yandex Maps: reseñas en idioma original y traducciones de la interfazLa documentación oficial explica que, si el idioma de una reseña es distinto al de la interfaz, puede mostrarse una traducción con la opción de volver al original. Por tanto, el parámetro de idioma de esta API no puede interpretarse como una garantía del idioma original de la reseña ni de su traducción.Consultada sortOpcional- Criterio de orden. Para
search, usarelevance(relevancia) odistance(distancia). Paramarket, usapopular(popularidad) otop_rated(mejor puntuación). Parareviews, usanewest(más recientes, por defecto),relevance(relevancia),highest(puntuación más alta primero) olowest(puntuación más baja primero). No mezcles los valores entre acciones.
Cómo usar la API de Yandex
- 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 devuelto si la acción es 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":"yandex","action":"search","params":{"keyword":"<keyword>"}}'
Preguntas sobre la API de Yandex
¿Cómo llamo a la API de Yandex?
Envía POST /api/v1/social con platform igual a yandex, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Yandex?
Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye name, text, address y city. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros de origen contengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de Yandex?
Yandex Maps describe fichas con categoría, dirección, puntuación, número de reseñas y horario. Se cita para interpretar el lugar; los botones de la ficha no añaden reserva, edición o gestión del negocio a la API.
¿Qué parámetros son obligatorios?
Depende de la acción. search requiere keyword; market requiere keyword; reviews requiere url.