Inteligencia de TikTok ET

API de búsqueda de vídeos de TikTok MCP

Encontrar TikTok videos por producto, creador, región, compromiso y rendimiento de ventas. Llama a la TikTok Búsqueda de vídeo API mediante REST o MCP con tu clave de API de Nexscope.

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

Prompts y casos de uso de API de búsqueda de vídeos 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 TikTok Videos

Prompt: Encontrar TikTok Videos para [product ID] dentro [target marketplace]. Mostrar los resultados disponibles e identificar claramente la información que falta. Para esta selección, elija Estados Unidos, Indonesia, Tailandia, Filipinas, Malasia, Vietnam, Reino Unido, México, Singapur, Arabia Saudita, Brasil, España, Japón, Alemania, Italia o Francia.

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

Prompt: Encontrar TikTok Videos para [product ID] 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 TikTok Videos para [product ID] 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. Para esta selección escoge gustos, publica tiempo o vistas.

4. Encontrar coincidencias por cuenta de vista de vídeo

Prompt: Encontrar TikTok Videos para [product ID] dentro [target marketplace]. Limitación de los resultados [my chosen video view count range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

5. Encontrar coincidencias por el filtro de la duración del vídeo -

Prompt: Encontrar TikTok Videos para [product ID] dentro [target marketplace]. Limitación de los resultados [my chosen video duration range filter - range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

6. Encontrar coincidencias por Publish Time Range Filter -

Prompt: Encontrar TikTok Videos para [product ID] dentro [target marketplace]. Limitación de los resultados [my chosen publish time range filter - range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.

7. Resultados estrechos por Creador ID

Prompt: Encontrar TikTok Videos para [product ID] dentro [target marketplace]. Uso [my selected creator id] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.

8. Resultados estrechos por categoría de producto asociado ID

Prompt: Encontrar TikTok Videos para [product ID] dentro [target marketplace]. Uso [my selected associated product category id] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.

9. Elija un canal de venta de contenidos

Prompt: Encontrar TikTok Videos para [product ID] dentro [target marketplace]. Reducir los resultados [video or livestream] promoción, según mi informe de investigación. Resumir sólo los registros devueltos.

10. Revista Publicidad Videos

Prompt: Encontrar TikTok Videos para [product ID] dentro [target marketplace]. Uso [my advertising-video preference] para reducir los resultados. Informe sólo lo que los registros seleccionados soportan.

11. Examen AI- Videos creados

Prompt: Encontrar TikTok Videos para [product ID] dentro [target marketplace]. Uso [my preference for AI-created videos] 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_video_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": "tiktok-video-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_tiktok_video_search",
    "arguments": {
      "pageNum": 1,
      "pageSize": 50,
      "region": "US",
      "sortType": 1,
      "videoSortField": 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
`region`	`string`	obligatorio	Código regional. Opciones: US (Estados Unidos) ID (Indonesia), TH (Tailandia), PH (Filipinas), MY (Malasia), VN (Vietnam), GB (Reino Unido), MX (México) SG (Singapur), SA (Arabia Saudita), BR (Brasil), ES (España), JP (Japón), DE (Alemania), IT (Italia) FR (Francia) Ejemplo: US
`userId`	`string`	opcional	Creador ID Filtro. Longitud máxima 1000 Ejemplo: example-id
`productId`	`string`	opcional	Producto asociado ID. Longitud máxima 1000
`productCategoryId`	`string`	opcional	Categoría de productos asociados ID. Longitud máxima 1000 Ejemplo: example-id
`minTotalViewsCnt`	`integer`	opcional	Filtro con vista de vídeo (mínimo) Ejemplo: 1
`maxTotalViewsCnt`	`integer`	opcional	Filtro de cuenta de vista de vídeo (máximo) Ejemplo: 1
`minDuration`	`integer`	opcional	Filtro de rango de duración de vídeo (segundos) - mínimo Ejemplo: 1
`maxDuration`	`integer`	opcional	Filtro de rango de duración de vídeo (segundos) - máximo Ejemplo: 1
`minCreateTime`	`integer`	opcional	Filtro de rango de tiempo (tiempos de segundo nivel) - mínimo Ejemplo: 1
`maxCreateTime`	`integer`	opcional	Filtro de intervalo de tiempo (timetamp de segundo nivel) - máximo Ejemplo: 1
`salesFlag`	`integer`	opcional	Ya sea un vídeo promocional: 0=vídeo no profesional, 1=vídeo profesional Ejemplo: 1
`isAd`	`integer`	opcional	Ya sea un vídeo de anuncio: 0=no-ad video, 1=ad video Ejemplo: 1
`createdByAi`	`string`	opcional	AI filtro de vídeo; acepta sólo las cadenas "verdad" o "falso", no un JSON boolean
`videoSortField`	`integer`	opcional	Campo de clasificación, por defecto 3: 1=total_digg_cnt (Me gusta), 2=create_time (Tiempo de publicación), 3=total_views_cnt (views) Ejemplo: 3
`sortType`	`integer`	opcional	Dirección: 0=ascendente, 1=descendente Ejemplo: 1
`pageNum`	`integer`	opcional	Número de página, a partir de 1 Ejemplo: 1
`pageSize`	`integer`	opcional	Artículos por página, predeterminado 50. Debe ser un múltiplo de 10, máx 100; el tercero API límite es 10 por página, internamente la puerta fetches 10 por página en múltiples rondas y fusiones Ejemplo: 50

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 (ver código de error abajo para detalles)
`errmsg`	`string`	opcional	Descripción del estado empresarial
`total`	`integer`	opcional	Número de registros
`data`	`array`	opcional	Lista de vídeo (ver campo de vídeo abajo para detalles)
`columns`	`array`	opcional	Rendered columns
`type`	`string`	opcional	Estilo de retroceso
`costToken`	`integer`	opcional	Consume token
`videoId`	`string`	opcional	Video ID
`videoDesc`	`string`	opcional	Descripción del vídeo
`officialUrl`	`string`	opcional	TikTok dirección de vídeo oficial
`coverUrl`	`string`	opcional	Cubierta de vídeo URL
`duration`	`integer`	opcional	Duración del vídeo (segundos)
`width`	`string`	opcional	ancho de vídeo
`height`	`string`	opcional	altura de vídeo
`ratio`	`string`	opcional	(resolución 540p/720p)
`dataSize`	`string`	opcional	Tamaño del archivo de vídeo
`createDate`	`string`	opcional	Fecha de lanzamiento de vídeo
`userId`	`string`	opcional	Expert ID
`uniqueId`	`string`	opcional	TikTok cuenta ID (unique_id)
`avatar`	`string`	opcional	Maestro avatar
`totalViewsCnt`	`integer`	opcional	Total de opiniones
`totalViews1dCnt`	`integer`	opcional	Jugar volumen en el pasado día
`totalViews7dCnt`	`integer`	opcional	Volumen de juego en los últimos 7 días
`totalViews30dCnt`	`integer`	opcional	Jugar volumen en los últimos 30 días
`totalDiggCnt`	`integer`	opcional	Total likes
`totalDigg1dCnt`	`integer`	opcional	Número de gustos en el pasado día
`totalDigg7dCnt`	`integer`	opcional	Número de gustos en los últimos 7 días
`totalDigg30dCnt`	`integer`	opcional	Número de gustos en los últimos 30 días
`totalCommentsCnt`	`integer`	opcional	Total de observaciones
`totalSharesCnt`	`integer`	opcional	Total de acciones
`totalFavoritesCnt`	`integer`	opcional	Total collections
`totalVideoSaleCnt`	`integer`	opcional	Ventas de vídeo (número de piezas)
`totalVideoSaleGmvAmt`	`integer`	opcional	Ventas de vídeo GMV (número)
`salesFlagText`	`string`	opcional	Ya sea para traer vídeo mercancías
`isAdText`	`string`	opcional	Ya sea para transmitir vídeo
`createdByAiText`	`string`	opcional	Ya. AI video (en inglés)yes/no/unknown)
`productCategoryList`	`string`	opcional	Clasificación de productos
`videoProducts`	`string`	opcional	Productos relacionados con el vídeo
`region`	`string`	opcional	código de área
`sourceType`	`string`	opcional	Fuente de producto

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 TikTok videos por producto, creador, región, compromiso y rendimiento de ventas. Uso del producto ID 1732459133172486968. Centrarse en el US.

Respuesta de ejemplo

En la muestra publicada, sus opiniones totales reportadas cnt son 500. El valor indicado de las ventas totales del vídeo es 0. Su duración notificada es 21. 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

{
  "pageSize": 10,
  "productId": "1732459133172486968",
  "region": "US",
  "videoSortField": 3
}

Respuesta

{
  "code": 0,
  "msg": null,
  "data": {
    "total": 3,
    "data": [
      {
        "totalVideoSaleCnt": 0,
        "videoDesc": "",
        "videoId": "7668568562134551821",
        "salesFlagText": "是",
        "officialUrl": "https://www.tiktok.com/@daily_finds137/video/7668568562134551821",
        "duration": 21,
        "sourceTool": "EchoTik-视频列表",
        "totalSharesCnt": 35,
        "totalFavoritesCnt": 0,
        "totalViewsCnt": 500,
        "createdByAiText": "否",
        "totalCommentsCnt": 61,
        "createDate": "2026-07-31 14:02:49",
        "height": "1280",
        "totalViews7dCnt": 0,
        "isAdText": "否",
        "totalDigg30dCnt": 101,
        "totalDigg7dCnt": 0,
        "dataSize": "1165241",
        "avatar": "https://echosell-images.tos-ap-southeast-1.volces.com/user-avatar/120/MS4wLjABAAAAZANi-p9J7sOebtYN69tY6g4jVdvNxpuH44XvwybYuSjhJXPFIgtTsqbA9LIOfIEH.jpg",
        "totalDiggCnt": 101,
        "userId": "6608740550285770758",
        "totalDigg1dCnt": 0,
        "coverUrl": "https://agent-files.linkfox.com/tiktok/20261011/7668568562134551821.jpg",
        "totalViews1dCnt": 0,
        "productCategoryList": "[{ \"category_name\":\"Phones & Electronics\",\"category_id\":\"601739\"}]",
        "totalVideoSaleGmvAmt": 0,
        "sourceType": "Tiktok",
        "width": "720",
        "totalViews30dCnt": 500,
        "region": "US",
        "videoProducts": "[1732459133172486968]",
        "uniqueId": "daily_finds137",
        "ratio": "720p"
      },
      {
        "totalVideoSaleCnt": 1,
        "videoDesc": "Olvídate de la sobrecarga! Este Smart Battery Protector de 100W es el accesorio definitivo para cuidar tu dispositivo. Su avanzada tecnología de auto-desconexión detiene el paso de energía automáticamente en cuanto la carga llega al 100%. Así evitas que la batería se degrade y prolongas su vida útil al máximo. Es seguro, rápido y perfecto para dejarlo conectado toda la noche sin preocupaciones.#gadgets #typec #accesorioscelular #bateriacelular #tiktokshopsummersale ",
        "videoId": "7670556324114992414",
        "salesFlagText": "是",
        "officialUrl": "https://www.tiktok.com/@anny.cachorro/video/7670556324114992414",
        "duration": 29,
        "sourceTool": "EchoTik-视频列表",
        "totalSharesCnt": 0,
        "totalFavoritesCnt": 1,
        "totalViewsCnt": 379,
        "createdByAiText": "否",
        "totalCommentsCnt": 1,
        "createDate": "2026-08-05 22:36:33",
        "height": "1280",
        "totalViews7dCnt": 0,
        "isAdText": "否",
        "totalDigg30dCnt": 16,
        "totalDigg7dCnt": 0,
        "dataSize": "2117186",
        "avatar": "https://echosell-images.tos-ap-southeast-1.volces.com/user-avatar/513/MS4wLjABAAAAsVqn3InQauwUbG3X-PO1PMQ1yJr6_T5Lkq7-Dk0jVA7R62Q5LyfcAUTv4NlJ0Gve.jpg",
        "totalDiggCnt": 16,
        "userId": "7435459344126477354",
        "totalDigg1dCnt": 0,
        "coverUrl": "https://agent-files.linkfox.com/tiktok/20261011/7670556324114992414.jpg",
        "totalViews1dCnt": 0,
        "productCategoryList": "[{ \"category_name\":\"Phones & Electronics\",\"category_id\":\"601739\"}]",
        "totalVideoSaleGmvAmt": 13,
        "sourceType": "Tiktok",
        "width": "720",
        "totalViews30dCnt": 379,
        "region": "US",
        "videoProducts": "[1732459133172486968]",
        "uniqueId": "anny.cachorro",
        "ratio": "720p"
      },
      {
        "totalVideoSaleCnt": 1,
        "videoDesc": "",
        "videoId": "7693306127353679134",
        "salesFlagText": "是",
        "officialUrl": "https://www.tiktok.com/@perico21351/video/7693306127353679134",
        "duration": 38,
        "sourceTool": "EchoTik-视频列表",
        "totalSharesCnt": 0,
        "totalFavoritesCnt": 0,
        "totalViewsCnt": 334,
        "createdByAiText": "否",
        "totalCommentsCnt": 0,
        "createDate": "2026-10-06 05:57:12",
        "height": "1280",
        "totalViews7dCnt": 334,
        "isAdText": "否",
        "totalDigg30dCnt": 2,
        "totalDigg7dCnt": 2,
        "dataSize": "1952623",
        "avatar": "https://echosell-images.tos-ap-southeast-1.volces.com/user-avatar/154/MS4wLjABAAAAQvdCvq4n_481xGiZGwDE4stgMuCHIIMvZTix1GmF_bBXN4q__PyxG9tNkQHqGUY-.jpeg",
        "totalDiggCnt": 2,
        "userId": "7528979822586332191",
        "totalDigg1dCnt": 0,
        "coverUrl": "https://agent-files.linkfox.com/tiktok/20261011/7693306127353679134.jpg",
        "totalViews1dCnt": 0,
        "productCategoryList": "[{ \"category_name\":\"Phones & Electronics\",\"category_id\":\"601739\"}]",
        "totalVideoSaleGmvAmt": 8,
        "sourceType": "Tiktok",
        "width": "720",
        "totalViews30dCnt": 334,
        "region": "US",
        "videoProducts": "[1732459133172486968]",
        "uniqueId": "perico21351",
        "ratio": "720p"
      }
    ],
    "columns": [
      {
        "filterable": true,
        "cellType": "text",
        "field": "videoId",
        "sortable": true,
        "title": "视频ID"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "officialUrl",
        "sortable": true,
        "title": "TikTok官方视频地址"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "userId",
        "sortable": true,
        "title": "达人ID"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "uniqueId",
        "sortable": true,
        "title": "TikTok账号ID(unique_id)"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "avatar",
        "sortable": true,
        "title": "达人头像"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "videoDesc",
        "sortable": true,
        "title": "视频描述"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "createDate",
        "sortable": true,
        "title": "视频发布日期"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "coverUrl",
        "sortable": true,
        "title": "视频封面URL"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "region",
        "sortable": true,
        "title": "区域代码"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "duration",
        "sortable": true,
        "title": "视频时长(秒)"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "ratio",
        "sortable": true,
        "title": "视频清晰度"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "width",
        "sortable": true,
        "title": "视频宽度"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "height",
        "sortable": true,
        "title": "视频高度"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "dataSize",
        "sortable": true,
        "title": "视频文件大小"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "isAdText",
        "sortable": true,
        "title": "是否投流视频"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "salesFlagText",
        "sortable": true,
        "title": "是否带货视频"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "createdByAiText",
        "sortable": true,
        "title": "是否AI视频"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "productCategoryList",
        "sortable": true,
        "title": "商品分类"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "videoProducts",
        "sortable": true,
        "title": "视频带货商品"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "totalViewsCnt",
        "sortable": true,
        "title": "总播放量"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "totalViews1dCnt",
        "sortable": true,
        "title": "最近1天播放量增量"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "totalViews7dCnt",
        "sortable": true,
        "title": "最近7天播放量增量"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "totalViews30dCnt",
        "sortable": true,
        "title": "最近30天播放量增量"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "totalDiggCnt",
        "sortable": true,
        "title": "总点赞量"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "totalDigg1dCnt",
        "sortable": true,
        "title": "最近1天点赞量增量"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "totalDigg7dCnt",
        "sortable": true,
        "title": "最近7天点赞量增量"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "totalDigg30dCnt",
        "sortable": true,
        "title": "最近30天点赞量增量"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "totalCommentsCnt",
        "sortable": true,
        "title": "总评论数"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "totalSharesCnt",
        "sortable": true,
        "title": "总分享数"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "totalFavoritesCnt",
        "sortable": true,
        "title": "总收藏数"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "totalVideoSaleCnt",
        "sortable": true,
        "title": "视频销量(估算)"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "totalVideoSaleGmvAmt",
        "sortable": true,
        "title": "视频销售GMV(估算)"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "sourceTool",
        "sortable": true,
        "title": "来源工具"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "sourceType",
        "sortable": true,
        "title": "商品来源"
      }
    ],
    "type": "tableListWorkbenches"
  }
}

Ver el formato de solicitud y respuesta MCP

Ejemplos