Inteligencia comercial de TikTok CJ

API de tiendas más promocionadas de TikTok MCP

Descubre TikTok Shops clasificadas por actividad de promoción. Llama a la TikTok Shop Most Promoted API mediante REST o MCP con tu clave de API de Nexscope.

CosteRecent 38 créditos por llamadaPrueba en línea

Prompts y casos de uso de API de tiendas más promocionadas de TikTok

Después de conectar esta herramienta MCP a tu asistente de IA, puedes plantear las preguntas siguientes. Sustituye los marcadores entre corchetes por tus datos y usa los valores admitidos en Argumentos.

¿Es tu primera vez con Nexscope MCP? Sigue la guía de conexión, y después usa los prompts siguientes. Las pestañas Integración y Parámetros y respuesta contienen los pasos de conexión, un ejemplo de llamada y la referencia técnica.

1. Encontrar tiendas en una fecha TikTok promoción clasificación

Prompt: Encontrar tiendas en una fecha TikTok ranking de promoción para [selected reporting date] dentro [target marketplace]. Mostrar los resultados disponibles e identificar claramente la información que falta.

2. Continuar los resultados dentro de un límite de página

Prompt: Encontrar tiendas en una fecha TikTok ranking de promoción para [selected reporting date] dentro [target marketplace]. Inicio [my selected page] y retorno [my requested page size] dentro de los límites documentados. Pregunte antes de solicitar otra página y no describa una página como conjunto de datos completo.

3. Priorizar los resultados para la revisión

Prompt: Encontrar tiendas en una fecha TikTok ranking de promoción para [selected reporting date] dentro [target marketplace]. Prioridad [my chosen ranking metric] dentro [my chosen order]. Mantenga la clasificación limitada a los filtros seleccionados y el período de presentación de informes. El tipo de métrica documentada es contado creador; elegir orden ascendente o descendente.

4. Resultados estrechos por categoría de producto ID

Prompt: Encontrar tiendas en una fecha TikTok ranking de promoción para [selected reporting date] dentro [target marketplace]. Uso [my selected product category id] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.

5. Elija Tiendas Locales o Transfronterizas

Prompt: Encontrar tiendas en una fecha TikTok ranking de promoción para [selected reporting date] dentro [target marketplace]. Concéntrate en [local stores or cross-border stores], según mi preferencia de abastecimiento. Resumir sólo los registros devueltos.

Qué debes proporcionar

Sustituye las entradas entre corchetes por tus propios valores. Usa únicamente los mercados, períodos y formatos de entrada documentados.

Las estimaciones y clasificaciones devueltas corresponden a los datos y al período seleccionados. Un valor ausente no equivale a cero y una página de resultados no representa todo el mercado.

Paso 1 · Conectar

Conecta tu asistente de IA

Conecta un cliente MCP compatible a Nexscope y selecciona esta herramienta en tu asistente. Completa la autenticación en la configuración de conexión del cliente.

POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/json

Autenticación

Usa el código de autorización OAuth 2.1 con PKCE y el ámbito mcp:tools. Las claves de API siguen siendo una opción de compatibilidad admitida.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

¿Usas una clave de API? Obtén tu clave en Acceso a la API e inclúyela en el encabezado Authorization que se muestra arriba.

Llamar a esta herramienta MCP

Nombre de la herramienta MCP

nexscope_chuhaijiang_tiktok_shop_rankings_most_promoted

Punto de conexión MCP

https://api.nexscope.ai/mcp

Método JSON-RPC

tools/call

Inicializa una sesión HTTP Streamable MCP 2025-11-25 en https://api.nexscope.ai/mcp y después usa tools/call.

{
  "jsonrpc": "2.0",
  "id": "chuhaijiang-tiktok-shop-rankings-most-promoted-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_chuhaijiang_tiktok_shop_rankings_most_promoted",
    "arguments": {
      "country": "us",
      "date": "20260824",
      "granularity": "daily",
      "pageSize": 10
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

La respuesta SSE del POST inicial comunica el progreso. El flujo SSE por GET transmite notificaciones; si se restablece la conexión, consulta la tarea asíncrona existente en vez de enviarla de nuevo.

Argumentos

Nombre	Tipo	Obligatorio	Descripción
`country`	`string`	obligatorio	Maleta inferior TikTok Código de mercado. Ejemplo: us
`page`	`integer`	opcional	Número de página, empezando en 1. Ejemplo: 1
`pageSize`	`integer`	opcional	Registros máximos por página. Ejemplo: 10
`date`	`string`	obligatorio	Fecha de clasificación YYYYMMDD formato. Ejemplo: 20260824
`granularity`	`string`	obligatorio	Periodo de clasificación. Ejemplo: daily
`category`	`string`	opcional	Categoría de productos ID.
`shopType`	`string`	opcional	Tipo de tienda de proveedores.
`sort`	`string`	opcional	Proveedor de campo y dirección (campo:asc o campo:desc). Ejemplo: related_creator_count:desc

Campos de respuesta

Usa structuredContent como los datos de respuesta de la API para el procesamiento programático.

Nombre	Tipo	Obligatorio	Descripción
`errcode`	`integer`	opcional	200 significa éxito
`errmsg`	`string`	opcional	`ok` sobre el éxito
`request_id`	`string`	opcional	Solicitud de rastreo ID
`data`	`object`	opcional	La lista está en `data.items[]`y el total es `data.total_count`
`biz_type`	`string`	opcional	Tipo de negocio
`interval_related_creator_count`	`number`	opcional	Número de personas asociadas con intervalo
`interval_total_related_videos_count`	`number`	opcional	Número de vídeos asociados al intervalo

Preguntas y respuestas de ejemplo

Se basa en una muestra de la documentación publicada, no en una llamada en vivo a la herramienta.

Tu pregunta

Encontrar tiendas en una fecha TikTok ranking de promoción. Centrarse en el US.

Respuesta de ejemplo

En la muestra publicada, el primer registro mostrado es “medicube US Tienda”. Su calificación de tienda reportada es 4.7. Su número total de creador relacionado con intervalos reportados es 92302. Estas observaciones se aplican únicamente al ámbito de registro y presentación de informes mostrados.

Sobre esta muestra: Extracto de la documentación publicada, no de una consulta en vivo. Las listas muestran como máximo dos registros y algunos textos largos pueden estar abreviados. Si faltan unidades, fechas o datos sobre la cobertura, el extracto no permite determinarlos ni representa el conjunto de datos completo.

Ver los datos de ejemplo publicados (JSON)

Ejemplo de datos REST publicado. Para llamar a esta herramienta, consulta los argumentos MCP en Parámetros y respuesta.

Ejemplo de datos

Ejemplo de solicitud y respuesta

Parámetros de solicitud

{
  "country": "us",
  "date": "20260824",
  "granularity": "daily",
  "pageSize": 10
}

Respuesta

{
  "code": 0,
  "msg": null,
  "data": {
    "data": {
      "total_count": 1000,
      "items": [
        {
          "shop_rating": 4.7,
          "interval_total_related_creator_count": 92302,
          "interval_total_related_video_creator_count": 80972,
          "shop_product_count": 156,
          "biz_type": 0,
          "seller_avatar": {
            "thumb_url": "",
            "url": "https://oss-t.chuhaijiang.com/v1/os/ttm_shop/s-7495514739648989419/3fda6fbf695c4a8792a3059b4e1546e3~tplv-fhlh96nyum-resize-png:300:300.png?sign=REDACTED"
          },
          "seller_main_category": "601450",
          "shop_name": "medicube US Store",
          "seller_business_info": [
            "APR US INC"
          ],
          "id": "7495514739648989419",
          "interval_total_related_shop_creator_count": 24844,
          "interval_total_related_videos_count": 397348,
          "region": "US",
          "interval_related_creator_count": 342,
          "seller_id": "7495514739648989419"
        },
        {
          "shop_rating": 4.6,
          "interval_total_related_creator_count": 50928,
          "interval_total_related_video_creator_count": 49106,
          "shop_product_count": 51908,
          "biz_type": 0,
          "seller_avatar": {
            "thumb_url": "",
            "url": "https://oss-t.chuhaijiang.com/v1/os/ttm_shop/s-7495811038271212487/4ae4940e7bcf436491ab2ddb3363ce9c~tplv-fhlh96nyum-resize-png:300:300.png?sign=REDACTED"
          },
          "seller_main_category": "600001",
          "shop_name": "QVC, Inc",
          "seller_business_info": [
            "QVC, Inc"
          ],
          "id": "7495811038271212487",
          "interval_total_related_shop_creator_count": 4067,
          "interval_total_related_videos_count": 346348,
          "region": "US",
          "interval_related_creator_count": 270,
          "seller_id": "7495811038271212487"
        },
        {
          "shop_rating": 4.3,
          "interval_total_related_creator_count": 44282,
          "interval_total_related_video_creator_count": 43648,
          "shop_product_count": 156,
          "biz_type": 0,
          "seller_avatar": {
            "thumb_url": "",
            "url": "https://oss-t.chuhaijiang.com/v1/os/ttm_shop/s-7495830785034323995/35249ab76437453aa1154620ca308b66~tplv-fhlh96nyum-resize-png:300:300.png?sign=REDACTED"
          },
          "seller_main_category": "601450",
          "shop_name": "Dr.Melaxin",
          "seller_business_info": [
            "BRAND501 US Corp."
          ],
          "id": "7495830785034323995",
          "interval_total_related_shop_creator_count": 1710,
          "interval_total_related_videos_count": 182321,
          "region": "US",
          "interval_related_creator_count": 214,
          "seller_id": "7495830785034323995"
        },
        {
          "shop_rating": 4.5,
          "interval_total_related_creator_count": 46784,
          "interval_total_related_video_creator_count": 40973,
          "shop_product_count": 515,
          "biz_type": 0,
          "seller_avatar": {
            "thumb_url": "",
            "url": "https://oss-t.chuhaijiang.com/v1/os/ttm_shop/s-7495183505163847730/ab48a51fb8b24b39aaadb54d5dc68e9c~tplv-fhlh96nyum-resize-png:300:300.png?sign=REDACTED"
          },
          "seller_main_category": "601450",
          "shop_name": "Kitsch",
          "seller_business_info": [
            "Kitsch LLC"
          ],
          "id": "7495183505163847730",
          "interval_total_related_shop_creator_count": 8509,
          "interval_total_related_videos_count": 131430,
          "region": "US",
          "interval_related_creator_count": 183,
          "seller_id": "7495183505163847730"
        },
        {
          "shop_rating": 4.4,
          "interval_total_related_creator_count": 26340,
          "interval_total_related_video_creator_count": 26340,
          "shop_product_count": 2486,
          "biz_type": 0,
          "seller_avatar": {
            "thumb_url": "",
            "url": "https://oss-t.chuhaijiang.com/v1/os/ttm_shop/s-7495828139121281896/14b28ba0053640ada25d6a58ba079dab~tplv-fhlh96nyum-resize-png:300:300.png?sign=REDACTED"
          },
          "seller_main_category": "601152",
          "shop_name": "Fashion Nova",
          "seller_business_info": [
            "Fashion Nova, LLC"
          ],
          "id": "7495828139121281896",
          "interval_total_related_shop_creator_count": 0,
          "interval_total_related_videos_count": 161106,
          "region": "US",
          "interval_related_creator_count": 172,
          "seller_id": "7495828139121281896"
        },
        {
          "shop_rating": 4.6,
          "interval_total_related_creator_count": 23378,
          "interval_total_related_video_creator_count": 22074,
          "shop_product_count": 97,
          "biz_type": 0,
          "seller_avatar": {
            "thumb_url": "",
            "url": "https://oss-t.chuhaijiang.com/v1/os/ttm_shop/s-7495275617887947202/864b4c33d2ee493284ef8e87917cf22f~tplv-fhlh96nyum-resize-png:300:300.png?sign=REDACTED"
          },
          "seller_main_category": "601450",
          "shop_name": "SKIN1004 US",
          "seller_business_info": [
            "CRAVERCORP USA INC"
          ],
          "id": "7495275617887947202",
          "interval_total_related_shop_creator_count": 2069,
          "interval_total_related_videos_count": 57921,
          "region": "US",
          "interval_related_creator_count": 139,
          "seller_id": "7495275617887947202"
        },
        {
          "shop_rating": 4.6,
          "interval_total_related_creator_count": 74767,
          "interval_total_related_video_creator_count": 59134,
          "shop_product_count": 163,
          "biz_type": 0,
          "seller_avatar": {
            "thumb_url": "",
            "url": "https://oss-t.chuhaijiang.com/v1/os/ttm_shop/s-7495150597721263036/d08849cce29e49f1bdbfd6f303b52153~tplv-fhlh96nyum-resize-png:300:300.png?sign=REDACTED"
          },
          "seller_main_category": "601450",
          "shop_name": "Tarte Cosmetics",
          "seller_business_info": [
            "Tarte Cosmetics"
          ],
          "id": "7495150597721263036",
          "interval_total_related_shop_creator_count": 26047,
          "interval_total_related_videos_count": 238626,
          "region": "US",
          "interval_related_creator_count": 125,
          "seller_id": "7495150597721263036"
        },
        {
          "shop_rating": 4.6,
          "interval_total_related_creator_count": 29054,
          "interval_total_related_video_creator_count": 16787,
          "shop_product_count": 13,
          "biz_type": 0,
          "seller_avatar": {
            "thumb_url": "",
            "url": "https://oss-t.chuhaijiang.com/v1/os/ttm_shop/s-7495491684454205698/2f7d114e9a93411fbbbd1d91ba2ca264~tplv-fhlh96nyum-resize-png:300:300.png?sign=REDACTED"
          },
          "seller_main_category": "700437",
          "shop_name": "RYZE Superfoods",
          "seller_business_info": [
            "RYZE, INC."
          ],
          "id": "7495491684454205698",
          "interval_total_related_shop_creator_count": 19013,
          "interval_total_related_videos_count": 28806,
          "region": "US",
          "interval_related_creator_count": 116,
          "seller_id": "7495491684454205698"
        },
        {
          "shop_rating": 4.7,
          "interval_total_related_creator_count": 36562,
          "interval_total_related_video_creator_count": 26067,
          "shop_product_count": 194,
          "biz_type": 0,
          "seller_avatar": {
            "thumb_url": "",
            "url": "https://oss-t.chuhaijiang.com/v1/os/ttm_shop/s-7495045046260173699/9404de4951d9419994afd84e2e233402~tplv-fhlh96nyum-resize-png:300:300.png?sign=REDACTED"
          },
          "seller_main_category": "601152",
          "shop_name": "Comfrt",
          "seller_business_info": [
            "Comfrt LLC"
          ],
          "id": "7495045046260173699",
          "interval_total_related_shop_creator_count": 16383,
          "interval_total_related_videos_count": 176560,
          "region": "US",
          "interval_related_creator_count": 113,
          "seller_id": "7495045046260173699"
        },
        {
          "shop_rating": 4.5,
          "interval_total_related_creator_count": 44520,
          "interval_total_related_video_creator_count": 34465,
          "shop_product_count": 46,
          "biz_type": 0,
          "seller_avatar": {
            "thumb_url": "",
            "url": "https://oss-t.chuhaijiang.com/v1/os/ttm_shop/s-7495294706998086587/e2a2bf7f86e5438ba618d47ed51a4a4c~tplv-fhlh96nyum-resize-png:300:300.png?sign=REDACTED"
          },
          "seller_main_category": "700645",
          "shop_name": "Bloom Nutrition",
          "seller_business_info": [
            "Bloom Nutrition LLC"
          ],
          "id": "7495294706998086587",
          "interval_total_related_shop_creator_count": 13369,
          "interval_total_related_videos_count": 84038,
          "region": "US",
          "interval_related_creator_count": 102,
          "seller_id": "7495294706998086587"
        }
      ]
    },
    "request_id": "01f5ac19-6366-4c6c-b04d-e5de80d3c262"
  }
}

Ver el formato de solicitud y respuesta MCP

Ejemplos