Inteligencia de TikTok FM

API de productos más vendidos de TikTok MCP

Query TikTok Compra rankings de productos de venta superior por día, semana, mes, mercado y categoría. Llamada vía REST API o MCP con tu clave de API de Nexscope.

CosteRecent Avg. 22 · Range 11–22 créditos por llamadaPrueba en línea

Prompts y casos de uso de API de productos más vendidos 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 Top-Selling TikTok Productos

Prompt: Encontrar Top-Selling TikTok Productos en la tienda [target marketplace]. Mostrar los resultados disponibles e identificar claramente la información que falta. Para esta selección, elija Estados Unidos, Reino Unido, México, España, Alemania, Italia, Francia, Indonesia, Vietnam, Malasia, Tailandia, Filipinas, Brasil, Japón o Singapur.

2. Revise un período específico de presentación de informes

Prompt: Encontrar Top-Selling TikTok Productos en la tienda [target marketplace]. Uso [my chosen reporting period] y mostrar el período con las cifras devueltas. Mantenga las instantáneas datadas distintas de los datos actuales.

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

Prompt: Encontrar Top-Selling TikTok Productos en la tienda [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.

4. Priorizar los resultados para la revisión

Prompt: Encontrar Top-Selling TikTok Productos en la tienda [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. Para esta selección, elija ventas, GMV, ventas totales, total GMV o tasa de crecimiento.

5. Encontrar Bestsellers en una categoría de producto

Prompt: Encontrar Top-Selling TikTok Productos en la tienda [target marketplace]. Uso [my selected product category name , matched to tiktok category id] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.

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_tiktok_top_selling_products

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": "tiktok-top-selling-products-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_tiktok_top_selling_products",
    "arguments": {
      "dateInfo": {
        "type": "day",
        "value": "2026-08-01"
      },
      "orderby": {
        "field": "units_sold",
        "order": "desc"
      },
      "page": 1,
      "pageSize": 10,
      "region": "US"
    }
  }
}

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
`region`	`string`	obligatorio	Código de la región del mercado. Opciones: US (Estados Unidos) GB (Reino Unido), MX (México) ES (España), DE (Alemania), IT (Italia) FR (Francia), ID (Indonesia), VN (Vietnam), MY (Malasia), TH (Tailandia), PH (Filipinas), BR (Brasil), JP (Japón), SG (Singapur) Ejemplo: US
`dateInfo`	`object`	obligatorio	Especificación de la fecha objeto, que contiene campos de tipo y valor Ejemplo: { "type": "day", "value": "2026-08-01" }
`dateInfo.type`	`string`	obligatorio	Granularidad del tiempo: día, semana, mes Ejemplo: day
`dateInfo.value`	`string`	obligatorio	Valor de la fecha: formato del día YYYY-MM-DD, formato semanal YYYY-weekNumber (e.g., 2025-18), formato mes YYYY-MM Ejemplo: 2026-01-01
`category`	`string`	opcional	Nombre de la categoría de producto (inglés), correspondiente a TikTok categoría ID. La entrada no inglesa debe traducirse al inglés primero
`orderby`	`object`	opcional	Ordenar objeto regla, conteniendo campos de campo y orden Ejemplo: { "field": "units_sold", "order": "desc" }
`orderby.field`	`string`	opcional	Campo tipo: units_sold (sales), gmv (GMV), total_units_sold (ventas totales), total_gmv (total) GMV), growth_rate (tasa de crecimiento) Ejemplo: units_sold
`orderby.order`	`string`	opcional	Dirección de clasificación: desc (descendente), asc (ascending), desc predeterminado Ejemplo: desc
`page`	`integer`	opcional	Número de página, por defecto 1 Ejemplo: 1
`pageSize`	`integer`	opcional	Artículos por página, max 10, default 10 Ejemplo: 10

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	Código de estado comercial, `200` indica éxito.
`errmsg`	`string`	opcional	Descripción del estado comercial.
`page`	`integer`	opcional	Número de página actual.
`pageSize`	`integer`	opcional	El número actual de artículos por página.
`total`	`integer`	opcional	Número de registros.
`products`	`array`	opcional	Lista de productos de venta caliente, campos de objeto de producto se muestran en la tabla siguiente.
`columns`	`array`	opcional	Columnas rendidas.
`type`	`string`	opcional	Rendering estilo.
`costTime`	`integer`	opcional	Tiempo de interfase gastado (milliseconds).
`costToken`	`integer`	opcional	Consume token; algunas respuestas pueden omitirse.
`matchedCategoryIdPath`	`string`	opcional	Camino a la categoría igualada ID; puede ser devuelto cuando `category` se pasa.
`matchedCategoryNamePath`	`string`	opcional	Pauta de nombre de categoría igualada; puede ser devuelto cuando `category` se pasa.
`title`	`string`	opcional	Nombre del producto.
`productId`	`string`	opcional	Producto ID.
`region`	`string`	opcional	Código de área.
`price`	`number`	opcional	Precio del producto.
`minPrice`	`number`	opcional	Precio más bajo; sólo los productos de rango de precios se devuelven.
`maxPrice`	`number`	opcional	Precio más alto; sólo los productos de rango de precios se devuelven.
`currency`	`string`	opcional	Símbolo de moneda o logo.
`totalSaleCnt`	`integer`	opcional	Total de ventas.
`totalSale1dCnt`	`integer`	opcional	Volumen de ventas en el último 1 día (retornado cuando `dateType=day`).
`totalSale7dCnt`	`integer`	opcional	Volumen de ventas en los últimos 7 días (retornado cuando `dateType=week`).
`totalSale30dCnt`	`integer`	opcional	Volumen de ventas en los últimos 30 días (retornado cuando `dateType=month`).
`totalSaleGmvAmt`	`number`	opcional	Total de ventas.
`totalSaleGmv1dAmt`	`number`	opcional	Ventas en el último 1 día (retornado cuando `dateType=day`).
`totalSaleGmv7dAmt`	`number`	opcional	Ventas en los últimos 7 días (retornado cuando `dateType=week`).
`totalSaleGmv30dAmt`	`number`	opcional	Ventas en los últimos 30 días (regresados para `dateType=month`).
`growthRate`	`number`	opcional	Tasa de crecimiento (porcentaje).
`shopName`	`string`	opcional	Nombre de la tienda.
`shopTotalUnitsSold`	`integer`	opcional	El volumen total de ventas de la tienda.
`shopSellerId`	`string`	opcional	Vendedor de tiendas ID.
`categoryName`	`string`	opcional	Categoría de productos.
`categoryIds`	`array`	opcional	Categoría de productos ID (nivel uno a nivel tres).
`productCommissionRate`	`number`	opcional	ratio de comisión de productos (puntos de parálisis, 1000=10%).
`imageUrl`	`string`	opcional	Imagen del producto URL.
`coverUrl`	`array`	opcional	Imagen de la cubierta del producto URL lista.
`shopAvatar`	`string`	opcional	Store avatar URL.
`sourceType`	`string`	opcional	Tipo fuente de producto.
`offShelvesText`	`string`	opcional	Si se elimina de los estantes ("Sí" = eliminado de los estantes, "No" = a la venta).

Ilustración del formato

Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.

Pregunta ilustrativa

Query TikTok Compra rankings de productos de venta superior por día, semana, mes, mercado y categoría. Centrarse en el US.

Explicación ilustrativa de la respuesta

El resultado ilustrativo muestra el título: Ejemplo producto; producto id: ejemplo-productId; precio: 19.99. Estas cifras describen sólo el registro mostrado. A partir de este ejemplo, no se pueden calcular las medidas que faltan.

Sobre esta muestra: Ejemplo ilustrativo con registros ficticios; no procede de una llamada real. Los identificadores, precios y recuentos son datos de demostración.

No hay datos de ejemplo publicados para esta página. Una ilustración del formato o una guía de flujo de trabajo no sustituye un resultado publicado.

Ver el formato de solicitud y respuesta MCP

Ejemplos

Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.

La estructura JSON-RPC siguiente muestra cómo se presentan en MCP los argumentos y los datos indicados. No procede de una captura de tráfico ni demuestra que la llamada se haya completado. Los ejemplos de flujo de trabajo no muestran un resultado.

Solicitud MCP

{
  "jsonrpc": "2.0",
  "id": "tiktok-top-selling-products-example",
  "method": "tools/call",
  "params": {
    "name": "nexscope_tiktok_top_selling_products",
    "arguments": {
      "dateInfo": {
        "type": "day",
        "value": "2026-08-01"
      },
      "orderby": {
        "field": "units_sold",
        "order": "desc"
      },
      "page": 1,
      "pageSize": 10,
      "region": "US"
    }
  }
}

Formato de respuesta MCP

{
  "jsonrpc": "2.0",
  "id": "tiktok-top-selling-products-example",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"code\":0,\"msg\":null,\"data\":{\"products\":[{\"title\":\"Example product\",\"productId\":\"example-productId\",\"price\":19.99}]}}"
      }
    ],
    "structuredContent": {
      "code": 0,
      "msg": null,
      "data": {
        "products": [
          {
            "title": "Example product",
            "productId": "example-productId",
            "price": 19.99
          }
        ]
      }
    },
    "isError": false
  }
}