API de plataforma de EveryData
API de Shopee
Busca productos de Shopee y consulta fichas, tiendas o detalles regionales mediante sus identificadores públicos. Shop ID, item ID y URL mantienen funciones distintas.
Precio, descuento, ventas mostradas, rating y stock no son la misma señal. La respuesta no compra, reserva unidades ni garantiza disponibilidad en todos los países.
- Endpoint
- POST /api/v1/social
- Funciones
- 4
- Por 1.000
- 1,389 US$
Funciones disponibles
Compara las acciones de Shopee 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 productos en Shopee Busca productos de Shopee mediante | keyword | 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 | shop_id · item_id · name · url · image_url · price · original_price · discount_pct · currency · rating · rating_scale · rating_count · sold_count · location · is_mall · platform |
profileConsultar una ficha de Shopee Abre la | url | — | Entrega síncrona | — | $1.39 por 1.000 solicitudes | shop_id · item_id · name · url · description · price · price_min · price_max · original_price · discount_pct · currency · rating · rating_scale · rating_count · sold_count · stock · liked_count · view_count · brand · is_pre_order · has_video · platform |
shopListar productos de una tienda Consulta mediante | shop | — | 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 | shop_id · item_id · name · url · image_url · price · original_price · discount_pct · currency · rating · rating_scale · rating_count · sold_count · location · is_mall · platform |
product_detailObtener el detalle regional del producto Lee la | url | country | Entrega síncrona | — | $1.39 por 1.000 solicitudes | id · url · name · text · price · original_price · currency · discount · stock · sold_count · rating · rating_scale · review_count · shop_name · shop_location · variants · image_url · platform |
¿Qué acepta cada acción de Shopee?
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 Shopee search?
Busca productos de Shopee mediante keyword, con precio mínimo y orden opcionales. Devuelve tienda, artículo, precio, descuento, valoración y ventas mostradas; no calcula inventario ni margen.
keywordObligatorio- Palabra clave de producto para
search. El parámetrocountrydetermina en qué sitio local se realiza la búsqueda. min_priceOpcional- Importe mínimo del producto para la acción
search. Usa la moneda del sitio local de destino. No trates importes de distintas regiones como si fueran la misma moneda. No se refiere al coste de esta API. sortOpcional- Orden de los productos para
search:relevance(relevancia),popular(relacionado con las ventas),newest(más recientes),price_asc(precio ascendente) oprice_desc(precio descendente). No se aplica a listas de tiendas (shop) ni a detalles de producto.Valores permitidos:newestpopularprice_ascprice_descrelevance
¿Qué significan los parámetros de Shopee profile?
Abre la url de un producto y recoge descripción, rango de precio, rating y disponibilidad pública. Aquí el perfil es del artículo, no de la cuenta compradora ni del vendedor.
urlObligatorio- URL completa del producto de Shopee para
profileoproduct_detail. La acciónprofileextrae el identificador a partir dei.ID_tienda.ID_producto. Los enlaces cortos no se pueden analizar directamente; primero debes obtener la URL de destino.Shopee: Shop ID, Item ID y nombre de usuarioEl material de Shopee distingue Shop ID, Item ID, nombre de usuario y nombre visible de la tienda. La referencia ayuda a evitar intercambiarlos; no garantiza que los pasos de un panel regional sean iguales en todos los mercados.Consultada
¿Qué significan los parámetros de Shopee shop?
Consulta mediante shop los artículos de una tienda, conservando IDs, precios y métricas por ficha. No devuelve finanzas, pedidos privados ni el catálogo completo garantizado.
shopObligatorio- Nombre de usuario o ID numérico de la tienda para la acción
shop. Puede incluir@. Devuelve la lista de productos de la tienda, no sus valoraciones.Shopee: diferencia entre el nombre de usuario y el nombre visible de la tiendaShopee explica por separado el `username` utilizado para iniciar sesión y el `Shop Name` que ven los compradores. El nombre visible de la tienda puede contener espacios y no puede sustituir directamente al nombre de usuario o al ID de la tienda que requiere este parámetro.Consultada
¿Qué significan los parámetros de Shopee product_detail?
Lee la url del producto con país opcional y devuelve precio, stock mostrado, ventas y rating. No realiza compra, selecciona logística ni confirma unidades disponibles.
urlObligatorio- URL completa del producto de Shopee para
profileoproduct_detail. La acciónprofileextrae el identificador a partir dei.ID_tienda.ID_producto. Los enlaces cortos no se pueden analizar directamente; primero debes obtener la URL de destino. countryOpcional- El código de país tiene prioridad sobre
regiony la deducción a partir de la URL. Si no se especifica ensearch,profileoshop, el valor por defecto esid(Indonesia). El reconocimiento de dominios está configurado parasg,my,th,ph,vn,br,tw,mx,coycl. Que un dominio sea reconocible no garantiza que se puedan obtener datos de esa región actualmente. La acciónproduct_detailusa una ruta independiente para el país.
Cómo usar la API de Shopee
- 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":"shopee","action":"search","params":{"keyword":"<keyword>"}}'
Preguntas sobre la API de Shopee
¿Cómo llamo a la API de Shopee?
Envía POST /api/v1/social con platform igual a shopee, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Shopee?
Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye shop_id, item_id, name e image_url. 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 Shopee?
El material de Shopee distingue Shop ID, Item ID, nombre de usuario y nombre visible de la tienda. La referencia ayuda a evitar intercambiarlos; no garantiza que los pasos de un panel regional sean iguales en todos los mercados.
¿Qué parámetros son obligatorios?
Depende de la acción. search requiere keyword; profile requiere url; shop requiere shop; consulta las demás acciones en la lista de funciones.