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.
Disponibilidad de la plataforma
- Salud 24 h
- Normal
Últimos 30 días
Funciones disponibles
Cada acción de Shopee, 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 productos en Shopeesearch | Busca productos de Shopee mediante keyword, con precio mínimo y orden opcionales. | $1.39 por 1.000 solicitudes | Normal |
Consultar una ficha de Shopeeprofile | Abre la url de un producto y recoge descripción, rango de precio, rating y disponibilidad pública. | $1.39 por 1.000 solicitudes | Normal |
Listar productos de una tiendashop | Consulta mediante shop los artículos de una tienda, conservando IDs, precios y métricas por ficha. | $1.39 por 1.000 solicitudes | Normal |
Obtener el detalle regional del productoproduct_detail | Lee la url del producto con país opcional y devuelve precio, stock mostrado, ventas y rating. | $1.39 por 1.000 solicitudes | No disponible temporalmente |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿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.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
searchBuscar productos en Shopee Busca productos de Shopee mediante | keyword | country, 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 | 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 | country | 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 · images · shop |
shopListar productos de una tienda Consulta mediante | shop | country | 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é 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. 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 haya datos de esa región. Enproduct_detail, el país suele deducirse de la URL del producto.Valores permitidos:brclcoidmxmyphsgthtwvn max_priceOpcional- Precio máximo del producto según la escala de precios del mercado de destino. Se usa junto con
min_price. 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 usuario — 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. · Consultada 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 haya datos de esa región. Enproduct_detail, el país suele deducirse de la URL del producto.Valores permitidos:brclcoidmxmyphsgthtwvn
¿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 tienda — Shopee 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 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 haya datos de esa región. Enproduct_detail, el país suele deducirse de la URL del producto.Valores permitidos:brclcoidmxmyphsgthtwvn
¿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 haya datos de esa región. Enproduct_detail, el país suele deducirse de la URL del producto.Valores permitidos:bridmxmyphsgthvn
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 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":"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 tengan 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.
¿Las acciones de Shopee 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.