Inteligencia comercial de TikTok CJ

API de búsqueda de directos de TikTok MCP

Búsqueda TikTok livestreams para investigación de productos y contenidos. Llama a la TikTok Búsqueda en vivo 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 búsqueda de directos 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. Búsqueda TikTok flujos para investigación de productos y contenidos

Prompt: Búsqueda TikTok flujos para investigación de productos y contenidos para [search phrase] 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: Búsqueda TikTok flujos para investigación de productos y contenidos para [search phrase] 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: Búsqueda TikTok flujos para investigación de productos y contenidos para [search phrase] 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. La métrica documentada es GMV; elegir orden ascendente o descendente.

4. Encontrar coincidencias por unidades vendidas

Prompt: Búsqueda TikTok flujos para investigación de productos y contenidos para [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen units sold range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

5. Encontrar Livestreams by Gmv

Prompt: Búsqueda TikTok flujos para investigación de productos y contenidos para [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen GMV range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

6. Encontrar Livestreams by Audience Count

Prompt: Búsqueda TikTok flujos para investigación de productos y contenidos para [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen audience count range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

7. Encontrar coincidencias en una categoría seleccionada

Prompt: Búsqueda TikTok flujos para investigación de productos y contenidos para [search phrase] dentro [target marketplace]. Reducir esta búsqueda [my selected category] después de confirmar su valor soportado en la documentación del proveedor, y resumir los registros coincidentes.

8. Encontrar Livestreams para una categoría de producto

Prompt: Encontrar TikTok corrientes en vivo que coinciden [search phrase] dentro [target marketplace] para [selected product category]. Confirmar el valor de la categoría soportada antes de buscar y resumir los flujos en vivo iguales.

9. Encontrar Active Livestreams

Prompt: Búsqueda TikTok flujos para investigación de productos y contenidos para [search phrase] dentro [target marketplace]. Limita la búsqueda a las transmisiones que estén en directo. Informe sólo lo que los registros seleccionados soportan.

10. Encontrar contenido comercial

Prompt: Búsqueda TikTok flujos para investigación de productos y contenidos para [search phrase] dentro [target marketplace]. Limita la búsqueda al contenido marcado como comercial. 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_chuhaijiang_tiktok_live_search

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-live-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_chuhaijiang_tiktok_live_search",
    "arguments": {
      "country": "us",
      "page": 1,
      "pageSize": 3
    }
  }
}

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	Mercado de solicitudes de minúscula. Regresados country_code puede diferir; preservar ambos. Ejemplo: us
`page`	`integer`	opcional	Número de página, empezando en 1. No hay paginación automática. Ejemplo: 1
`pageSize`	`integer`	opcional	Artículos por página, de 1 a 10. La omisión preserva el predeterminado de arriba. Ejemplo: 3
`keyword`	`string`	opcional	Palabras clave Livestream. Ejemplo: beauty
`category`	`string`	opcional	Proveedor de categoría en directo aprobado; no enum se publica. Ejemplo:
`productCategory`	`string`	opcional	Categoría de productos aprobados por el proveedor. Ejemplo:
`isLiving`	`boolean`	opcional	Filtrar actualmente habitaciones en vivo. Ejemplo: true
`isCommercial`	`boolean`	opcional	Filtros que promueven productos. Ejemplo: true
`minSold`	`number`	opcional	Valor de filtro del proveedor; mantener la definición métrica del proveedor sin conversión de unidad. Ejemplo: 0
`maxSold`	`number`	opcional	Valor de filtro del proveedor; mantener la definición métrica del proveedor sin conversión de unidad. Ejemplo: 0
`minGmv`	`number`	opcional	Valor de filtro del proveedor; mantener la definición métrica del proveedor sin conversión de unidad. Ejemplo: 0
`maxGmv`	`number`	opcional	Valor de filtro del proveedor; mantener la definición métrica del proveedor sin conversión de unidad. Ejemplo: 0
`minAudience`	`number`	opcional	Valor de filtro del proveedor; mantener la definición métrica del proveedor sin conversión de unidad. Ejemplo: 0
`maxAudience`	`number`	opcional	Valor de filtro del proveedor; mantener la definición métrica del proveedor sin conversión de unidad. Ejemplo: 0
`sort`	`string`	opcional	Campo aprobado por el proveedor seguido por :asc o :desc. No se publica ningún enum de campo completo. Ejemplo: gmv: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 de transmisión en vivo está en `data.items[]`, el número total es `data.total_count`
`id`	`string`	opcional	Sala de estar ID; detalles y productos asociados utilizan este valor
`cover`	`object`	opcional	Objeto de cobertura, incluyendo `url`, `thumb_url`
`opm`	`number`	opcional	Órdenes por mil espectadores
`most_product_category_label`	`string`	opcional	Principales categorías de productos
`data.total_count`	`integer`	opcional	Número total de partidos
`data.items[].id`	`string`	opcional	Sala de difusión en vivo ID
`user_category_label`	`string`	opcional	Etiquetas de clasificación de anclaje
`country_code`	`string`	opcional	Código del país
`cover`	`object`	opcional	objeto
`new_follow_count`	`number`	opcional	Número de nuevos fans
`opm`	`number`	opcional	Órdenes por mil espectadores
`most_product_category_label`	`string`	opcional	Principales categorías de productos
`tiktok_live_detail_product_title`	`string`	opcional	Título del producto
`tiktok_live_detail_product_images`	`object`	opcional	Fotos de productos
`tiktok_live_detail_product_country_code`	`string`	opcional	Código del país producto
`tiktok_live_detail_product_sold_count`	`number`	opcional	Ventas relacionadas
`tiktok_live_detail_product_gmv`	`object`	opcional	Asociado GMV
`tiktok_live_detail_product_commission_rate_num`	`number`	opcional	Tasa de comisión
`tiktok_live_detail_product_conversion_rate`	`number`	opcional	Tasa de conversión
`tiktok_live_detail_product_seller_avatar`	`object`	opcional	Vendedor avatar
`tiktok_live_detail_product_seller_info`	`array`	opcional	Texto de descripción del vendedor
`tiktok_live_detail_product_seller_category_name_label`	`string`	opcional	Etiquetas de clasificación del vendedor

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

Búsqueda TikTok livestreams para investigación de productos y contenidos. Centrarse en el US.

Respuesta de ejemplo

En la muestra publicada, el primer registro mostrado es “May Memorial Day Mega LIVE!”. Su etiqueta de categoría de productos reportada es 601450. Su recuento de productos reportados es 50. 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

{
  "page": 1,
  "pageSize": 3,
  "country": "us"
}

Respuesta

{
  "code": 0,
  "msg": null,
  "data": {
    "data": {
      "total_count": 10000,
      "items": [
        {
          "room_link": "https://www.tiktok.com/@based/live",
          "user_unique_id": "based",
          "gpm": {
            "unit": "US",
            "value": 464.9233
          },
          "most_product_category_label": "601450",
          "product_count": 50,
          "end_time": "1779982090076",
          "title": "May Memorial Day Mega LIVE!",
          "opm": 18.825,
          "new_follow_count": 3125,
          "cover": {
            "thumb_url": "",
            "url": "https://oss-t.chuhaijiang.com/v1/os/ttm_live/r-7643101948819835678-7153432386608251946/aac55800d8b7b5ffc5990bfa7b6196e2~tplv-tiktokx-cropcenter:720:720.webp?sign=REDACTED"
          },
          "country_code": "US",
          "gmv": {
            "unit": "US",
            "value": 2015752.2500000007
          },
          "max_user_count": 1645,
          "start_time": "1779548710424",
          "total_sold_count": 81619,
          "total_user": 4335666,
          "user_id": "7153432386608251946",
          "user_nickname": "BASED",
          "user_category_label": "creator_category_v20240616_8",
          "id": "7643101948819835678"
        },
        {
          "room_link": "https://www.tiktok.com/@based/live",
          "user_unique_id": "based",
          "gpm": {
            "unit": "US",
            "value": 406.6801
          },
          "most_product_category_label": "601450",
          "product_count": 50,
          "end_time": "1778536248304",
          "title": "Stock Up Deals",
          "opm": 16.3467,
          "new_follow_count": 3053,
          "cover": {
            "thumb_url": "",
            "url": "https://oss-t.chuhaijiang.com/v1/os/ttm_live/r-7636861069956221727-7153432386608251946/aac55800d8b7b5ffc5990bfa7b6196e2~tplv-tiktokx-cropcenter:720:720.webp?sign=REDACTED"
          },
          "country_code": "US",
          "gmv": {
            "unit": "US",
            "value": 1767558.2499999998
          },
          "max_user_count": 3065,
          "start_time": "1778095464598",
          "total_sold_count": 71048,
          "total_user": 4346311,
          "user_id": "7153432386608251946",
          "user_nickname": "BASED",
          "user_category_label": "creator_category_v20240616_8",
          "id": "7636861069956221727"
        },
        {
          "room_link": "https://www.tiktok.com/@based/live",
          "user_unique_id": "based",
          "gpm": {
            "unit": "US",
            "value": 538.549
          },
          "most_product_category_label": "601450",
          "product_count": 42,
          "end_time": "1771531331575",
          "title": "BASED LIVE",
          "opm": 21.5094,
          "new_follow_count": 2411,
          "cover": {
            "thumb_url": "",
            "url": "https://oss-t.chuhaijiang.com/v1/os/ttm_live/r-7606801671091391263-7153432386608251946/55014e26dbf474c4a27a302cea499131~tplv-tiktokx-cropcenter:720:720.webp?sign=REDACTED"
          },
          "country_code": "US",
          "gmv": {
            "unit": "US",
            "value": 1569474.5999999999
          },
          "max_user_count": 1150,
          "start_time": "1771096790468",
          "total_sold_count": 62684,
          "total_user": 2914265,
          "user_id": "7153432386608251946",
          "user_nickname": "BASED",
          "user_category_label": "creator_category_v20240616_8",
          "id": "7606801671091391263"
        }
      ]
    },
    "request_id": "23c00e7e-5c93-4bb8-b843-36422bf784ed"
  }
}

Ver el formato de solicitud y respuesta MCP

Ejemplos