Inteligencia comercial de TikTok CJ

API de detalles de anuncios de TikTok MCP

Buscar detalles de un TikTok ad. Los resultados se devuelven como datos JSON estructurados. Consulta esta API mediante REST o MCP con tu clave de API de Nexscope.

CosteRecent 19 créditos por llamadaPrueba en línea

Prompts y casos de uso de API de detalles de anuncios 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. Buscar detalles de un TikTok ad

Prompt: Buscar detalles de un anuncio de TikTok identificado por [record ID] dentro [target marketplace]. Mostrar los resultados disponibles e identificar claramente la información que falta.

2. Inspeccionar el formato y la entrega Duración

Prompt: Mira. TikTok ad [record ID] dentro [supported country] con sus detalles básicos. Informe el tipo de anuncio devuelto y el día de entrega cuentan junto con el título y el texto del botón. No inferir gasto o rentabilidad.

3. Comparar dos mensajes de anuncios

Prompt: Consulta los anuncios de TikTok [ad ID A] y [ad ID B] dentro [supported country] en exactamente dos solicitudes, incluyendo detalles básicos para cada una. Compare los títulos devueltos, el texto de llamada a acción, la duración del vídeo, el tipo de anuncio y el día de entrega cuenta lado a lado. Marcar valores ausentes y no inferir qué anuncio convertido mejor o gastado más.

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_ad_detail

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-ad-detail-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_chuhaijiang_tiktok_ad_detail",
    "arguments": {
      "country": "us",
      "id": "7658119807128046879",
      "include": "core"
    }
  }
}

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
`id`	`string`	obligatorio	Ad ID devuelto por su operación de búsqueda. Mantenga los identificadores como cadenas para evitar la pérdida de precisión. Ejemplo: 7658119807128046879
`include`	`string`	opcional	Expansiones separadas por el sistema: núcleo. Solicito sólo expansiones necesarias. Ejemplo: core

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 información básica está en `data.items[]`; cuando es `include=core`, también hay `data.core.items[]`
`id`	`string`	opcional	Publicidad
`ad_title`	`string`	opcional	Título de anuncio
`button_text`	`string`	opcional	texto del botón
`duration`	`number`	opcional	Duración del vídeo
`core_ad_type`	`string`	opcional	Tipo de anuncio
`core_ad_day_count`	`number`	opcional	Días de entrega

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

Buscar detalles de un TikTok ad. Registro de uso ID 7675135146261024014. Centrarse en el US.

Respuesta de ejemplo

En la muestra publicada, su tiempo de creación reportado es 1789171200000. El valor indicado de la fecha de creación del anuncio es 1787006680000. Su duración notificada es de 91000. 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",
  "id": "7675135146261024014",
  "include": "core"
}

Respuesta

{
  "code": 0,
  "msg": null,
  "data": {
    "data": {
      "core": {
        "total_count": 1,
        "items": [
          {
            "core_video_share_count": 862,
            "core_ad_gmv_ratio": 0.44085140210272894,
            "core_ad_type": 1,
            "core_video_like_count": 10200,
            "core_total_sc": 52,
            "core_ad_maximum_cost": {
              "unit": "US",
              "value": 3652.9713227931447
            },
            "core_video_collect_count": 701,
            "core_video_play_count": 422300,
            "core_video_gpm_30d": 25.097395944926173,
            "core_creative_id": "7675135146261024014",
            "core_video_popularity": 13345,
            "core_ad_roas": 1.8188781440461215,
            "id": "7675135146261024014",
            "core_total_gmv": {
              "unit": "US",
              "value": 6644.3096998557
            },
            "core_video_comment_count": 1582,
            "core_ad_day_count": 27,
            "core_ad_play_ratio": 0.7319582894697048
          }
        ]
      },
      "total_count": 1,
      "items": [
        {
          "create_time": "1789171200000",
          "ad_url": "https://www.tiktok.com/@beeing.bailey/video/7675135146261024014?_r=1&u_code=elf7b42mhe5cka&preview_pb=0&sharer_language=en&_d=elh01dg50cafmk&share_item_id=7675135146261024014&source=h5_m",
          "advertiser_avatar": {
            "thumb_url": "",
            "url": "https://oss-t.chuhaijiang.com/v1/os/ttm_shop/s-7495470098042489730/3d78e783fcbc474f9ccf51e0e2857a18~tplv-fhlh96nyum-resize-png:300:300.png?sign=REDACTED"
          },
          "ad_create_time": "1787006680000",
          "ad_title": "🧬 Your dog’s DNA can tell you WAY more than just their breed mix. We used Embark DNA testing to get a deeper look at Bailey THE Mini Hippo—and one of the biggest reasons I love testing is that it goes far beyond answering “what breed is my dog?” 🐾 Embark can give you insights into: ✨ Genetic health risks — screening for inherited conditions so you can be more proactive about your dog’s health 🧬 Traits & genetics — including things like coat, coloring, size, and other characteristics written into their DNA 🐶 Breed ancestry — a breakdown of the breeds that make your dog uniquely them 👨‍👩‍👧‍👦 Relatives — DNA matching can even help you discover dogs who share Bailey’s genetics ❤️ More informed care — results can give you information worth discussing with your veterinarian as you make decisions throughout your dog’s life Because knowing your dog’s DNA isn’t just fun—it can help you understand them on a whole different level. 🥹 Would you DNA test your dog just for the breed results, or are the health insights the part you’d be most interested in? 👇 Save this if you’ve been thinking about doing a dog DNA test! 🐾🧬 @Embark Vet ",
          "advertiser_id": "7495470098042489730",
          "duration": 91000,
          "last_update_time": "1790410892852",
          "web_url": "https://shop.tiktok.com/view/product/1731757183345398658?region=US",
          "advertiser_name": "Embark Vet",
          "button_text": "Shop now",
          "id": "7675135146261024014",
          "ad_cover": {
            "thumb_url": "",
            "url": "https://oss-t.chuhaijiang.com/v11/os/ttm_product_video/v-7675135146261024014/oIED7aDqFAwVgHH5ARf0ACkEwj9IQSAfgq4IWE~tplv-tiktokx-origin.image?sign=REDACTED"
          }
        }
      ]
    },
    "request_id": "54149c58-3ed1-4ec8-b903-f51fe1661d88"
  }
}

Ver el formato de solicitud y respuesta MCP

Ejemplos