API de Productos de una tienda de Douyin

Lee página a página los productos de una tienda de Douyin Mall por shop_id. Cada fila trae title, price_cny y monthly_sales, además de shop_product_count y shop_page_count, por $8 por cada 1000 llamadas.

  • shop_product_count es el número de productos de la tienda y shop_page_count su número de páginas.
  • shop_id sale de product_search o product_detail, no de un nombre de tienda.
  • Las llamadas fallidas y los resultados vacíos no se cobran.

Salud de la API

Salud 24 h
Normal
  • Saludable / normal
  • Disponible
  • Limitada
  • Casi sin servicio
Normal

Últimas 24 horas

Últimos 30 días

  1. 1Solicitud

    POST /api/v1/social
    {
      "platform": "douyin",
      "action": "shop_products",
      "params": {
        "shop_id": "84535208"
      }
    }
  2. 2Respuesta JSON

    {
      "results": [
        {
          "next_page_token": string,
          "product_id": string,
          "promotion_id": string,
          "title": string
        },
        …
      ]
    }
  3. 3Filas

    next_page_tokenproduct_idpromotion_idtitle
    stringstringstringstring
  4. 4CSV

    douyin-shop_products-sample.csv next_page_token,product_id,promotion_id,title,url,image_url,price_cny,price_cny_minor,monthly_sales,tags,shop_id,shop_product_count,shop_page_count,platform

Entra una solicitud con shop_id y sale una página de productos de esa tienda; cada fila de results es un producto, y se muestra como tabla de campos y se puede descargar en CSV.

Qué datos obtienes

Este endpoint aún no tiene una muestra real pública. La tabla lista los campos, tipos y significados que devuelve cada fila, sin valores.

CampoTipoSignificado
next_page_tokenstringToken de paginación (search / user_posts / comments / comment_replies / billboard_video_hot / billboard_low_fan_explosion / billboard_high_completion / billboard_account_search / music_search): devuélvelo sin cambios como page_token para obtener la página siguiente, con los demás parámetros iguales; dura 24 horas. Todas las filas de una página llevan el mismo valor, que también aparece en el nivel superior de la respuesta. No aparece en la última página. Las páginas de comentarios recorren todos los comentarios de primer nivel.
product_idstringID estable del producto en Douyin Mall.
promotion_idstringConserva el significado de la plataforma
titlestringTítulo. null cuando la plataforma no usa títulos (por ejemplo publicaciones solo de texto).
urlstringEnlace al registro en la plataforma.
image_urlstringEnlace de imagen. Las capacidades con varias imágenes pueden devolver una lista image_urls.
price_cnynumberPrecio mostrado del producto, en yuanes.
price_cny_minornumberConserva el significado de la plataforma
monthly_salesnumberConserva el significado de la plataforma
tagsarrayLista de etiquetas. Si no hay, es una lista vacía, no null.
shop_idstringID de la tienda en Douyin Mall.
shop_product_count—Conserva el significado de la plataforma
shop_page_count—Conserva el significado de la plataforma
platformstringIdentificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).

Casos de uso

  • Listar todos los productos de una tienda

    Sigue next_page_token página a página; la página sin next_page_token es la última.

  • Estimar el tamaño de una tienda

    Lee shop_product_count y shop_page_count para saber cuántos productos tiene la tienda y cuántas páginas, sin recorrerla.

  • Vigilar los precios de una tienda rival

    Lee la misma tienda con la periodicidad que quieras y compara el cambio de price_cny y monthly_sales por producto.

  • Profundizar en una tienda desde una búsqueda

    Encuentra un producto con product_search, toma su shop_id y lee aquí el resto de productos de esa tienda.

Plataforma abierta de Doudian frente a EveryInfra

Así se comparan la documentación de la Plataforma abierta de Doudian y shop_products de EveryInfra según de quién es la tienda que se lee.

AspectoPlataforma abierta de DoudianEveryInfra
De quién es la tiendaLa documentación dice que el endpoint hace una consulta por lotes de la información de los productos de la tienda de un comerciante.shop_id indica una tienda de Douyin Mall. La solicitud lleva solo tu clave de API de EveryInfra y shop_id, y lees los productos que esa tienda muestra públicamente.

La documentación de la Plataforma abierta de Doudian está en chino. La tabla muestra una traducción, cotejada con la página el 2026-11-22. La fecha de actualización es la que indica la propia página. Fuentes oficiales: product/listV2: consulta por lotes de la lista de productos (actualizada el 2026-11-05)

Límites y detalles a tener en cuenta

  • shop_id es obligatorio. Es el ID numérico de una tienda de Douyin Mall, no un nombre de tienda.
  • Paginación: envía page para pedir esa página directamente. Para seguir, devuelve el next_page_token recibido como page_token con el resto de parámetros sin cambios; el token dura 24 horas.
  • Si envías page y page_token a la vez, manda el token.
  • La última página no trae next_page_token. Para el número de páginas, lee shop_page_count.
  • shop_product_count y shop_page_count son iguales en todas las filas. Describen toda la tienda, no las filas de esta página.
  • monthly_sales son las ventas del producto en los últimos 30 días, no un número de compradores.

Precios

Pagas $0.008 por llamada, no por fila, y cada página es una llamada. Las llamadas fallidas y los resultados vacíos no se cobran.

LlamadasCosto
10,000$80.00
100,000$800.00
1,000,000$8,000.00

Los totales se calculan con el precio de lista por llamada.

Ejemplos de código

#
bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "douyin",
  "action": "shop_products",
  "params": {
    "shop_id": "84535208"
  }
}'

Definición OpenAPI (JSON)Los ejemplos leen la clave de la variable de entorno EVERYINFRA_API_KEY; el código copiado nunca contiene tu clave.

Referencia de API

Consulta los parámetros, los campos de respuesta, los errores y la facturación de shop_products, y copia la página o ábrela en Markdown para dársela a un asistente de IA.

POST

Prompt para IA

#
Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra Douyin: Productos de una tienda (douyin/shop_products).

Cómo funciona el endpoint:
- Solicitud: POST https://api.everyinfra.com/api/v1/social con la cabecera Authorization: Bearer <clave API>. Lee la clave de la variable de entorno EVERYINFRA_API_KEY y no la escribas en el código.
- En el cuerpo de la solicitud, pon platform en douyin y action en shop_products, y los parámetros dentro de params.
- Parámetros obligatorios:
  - shop_id: ID numérico de una tienda de Douyin Mall, tomado del shop_id de una fila de product_search o product_detail. No es el nombre de la tienda.
- Parámetros opcionales:
  - page: Número de página, desde 1, con 10 productos por página; el total de páginas es el shop_page_count de cada fila. Lee esa página directamente y cuenta como una llamada; si también envías page_token, manda el token.
  - page_token: Token de paginación de shop_products. Omítelo en la primera página y luego devuelve tal cual el next_page_token anterior, sin cambiar shop_id. Cada página trae 10 productos y es una llamada.
- Devuelve una lista de registros. Campos principales de cada registro: next_page_token (Token de paginación (search / user_post…), product_id (ID estable del producto en Douyin Mall), promotion_id, title, url, image_url, price_cny (Precio mostrado del producto, en yuanes), price_cny_minor, monthly_sales, tags, shop_id (ID de la tienda en Douyin Mall), shop_product_count; 13 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=douyin.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "douyin",
  "action": "shop_products",
  "params": {
    "shop_id": "84535208"
  }
}
- Precio: $8 por 1.000 solicitudes; los resultados fallidos y vacíos no se cobran.
- Para decenas o cientos de objetivos, añade "mode": "async" al cuerpo: recibes un job_id al instante y consultas GET https://api.everyinfra.com/api/v1/jobs/{job_id} para obtener el resultado.
- Ante un 422, corrige la solicitud con los nombres de parámetros y los valores admitidos que sugiere el error; ante un 429 o un 503, espera lo que indique Retry-After y vuelve a intentarlo.

Antes de escribir código, pregúntame qué objetivos necesito, cuántos, qué campos y en qué formato quiero el resultado; luego confirma conmigo el plan y el coste aproximado.

Parámetros de la solicitud

#
NombreUbicaciónTipoObligatorioPor defectoDescripción
AuthorizationheaderstringSí-Bearer seguido de tu clave de API. Créala en la consola; nunca la pongas en una URL ni en un repositorio de código.
platformbodystringSídouyinIdentificador de la plataforma, valor fijo.
actionbodystringSíshop_productsIdentificador de la capacidad, valor fijo.
shop_idbody.paramsstringSí-ID numérico de una tienda de Douyin Mall, tomado del shop_id de una fila de product_search o product_detail. No es el nombre de la tienda.
pagebody.paramsintegerNo-Número de página, desde 1, con 10 productos por página; el total de páginas es el shop_page_count de cada fila. Lee esa página directamente y cuenta como una llamada; si también envías page_token, manda el token.
page_tokenbody.paramsstringNo-Token de paginación de shop_products. Omítelo en la primera página y luego devuelve tal cual el next_page_token anterior, sin cambiar shop_id. Cada página trae 10 productos y es una llamada. El token dura 24 horas y la última página no lo trae.

Ejemplo de respuesta

#
Todavía no hay una muestra real para estos parámetros de ejemplo: se muestra la estructura de la respuesta y sus campos según la definición de la API, con … como marcadores. No es el resultado de una llamada real.
json
{  "id": "req_…",  "platform": "douyin",  "action": "shop_products",  "results": [    {      "next_page_token": …,      "product_id": …,      "promotion_id": …,      "title": …,      "url": …,      "image_url": …,      "price_cny": …,      "price_cny_minor": …,      "monthly_sales": …,      "tags": …,      "shop_id": …,      "shop_product_count": …,      "shop_page_count": …,      "platform": …    }  ],  "next_page_token": …,  "pagination": { … },  "count": …,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Campos de la respuesta

#

Los datos están en results. La tabla lista los campos que puede tener cada registro; los valores que la plataforma no muestra nunca se inventan.

CampoSignificado
next_page_tokenToken de paginación (search / user_posts / comments / comment_replies / billboard_video_hot / billboard_low_fan_explosion / billboard_high_completion / billboard_account_search / music_search): devuélvelo sin cambios como page_token para obtener la página siguiente, con los demás parámetros iguales; dura 24 horas. Todas las filas de una página llevan el mismo valor, que también aparece en el nivel superior de la respuesta. No aparece en la última página. Las páginas de comentarios recorren todos los comentarios de primer nivel.
product_idID estable del producto en Douyin Mall.
promotion_idConserva el significado de la plataforma
titleTítulo. null cuando la plataforma no usa títulos (por ejemplo publicaciones solo de texto).
urlEnlace al registro en la plataforma.
image_urlEnlace de imagen. Las capacidades con varias imágenes pueden devolver una lista image_urls.
price_cnyPrecio mostrado del producto, en yuanes.
price_cny_minorConserva el significado de la plataforma
monthly_salesConserva el significado de la plataforma
tagsLista de etiquetas. Si no hay, es una lista vacía, no null.
shop_idID de la tienda en Douyin Mall.
shop_product_countConserva el significado de la plataforma
shop_page_countConserva el significado de la plataforma
platformIdentificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).

Errores y facturación

#
401
Falta la clave o no es válida.
402
Saldo insuficiente. Recarga primero.
422
Nombre o valor de parámetro incorrecto. Corrígelo según las opciones indicadas en el error. Sin cargo.
429
Se alcanzó el límite de solicitudes por minuto. Espera el tiempo indicado en Retry-After y vuelve a intentarlo.
503
No se pudo completar. El cargo retenido vuelve a tu saldo. Si el resultado es incierto, compruébalo antes de reenviar.
200 vacío
Sin datos. Sin cargo.

Errores

Preguntas frecuentes

¿Qué devuelve la API de productos de una tienda de Douyin?

Una página de productos de la tienda: product_id, promotion_id, title, url, image_url, price_cny, monthly_sales, tags y shop_id; cada fila trae además shop_product_count, shop_page_count y next_page_token.

¿De dónde saco shop_id?

Del shop_id de una fila devuelta por product_search o product_detail. Es el ID numérico de la tienda, no su nombre.

¿Cómo sé cuántas páginas tiene una tienda?

Lee shop_page_count en cualquier fila, o sigue paginando hasta que la respuesta no traiga next_page_token.

¿Cuánto cuesta leer una tienda?

Cada página es una llamada de $0.008, o $8 por cada 1000 llamadas. Las llamadas fallidas y los resultados vacíos no se cobran.

Con la misma clave de API de EveryInfra puedes llamar a los demás endpoints de Douyin.

Google Analytics solo si aceptas. Privacidad