Inteligencia comercial de TikTok CJ
API de búsqueda de anuncios de TikTok MCP
Búsqueda TikTok anuncios para la competencia y la investigación creativa. Llama a la TikTok Búsqueda de anuncios API mediante REST o MCP con tu clave de API de Nexscope.
Prompts y casos de uso de API de búsqueda 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. Búsqueda TikTok anuncios para la competencia y la investigación creativa
Prompt: Búsqueda TikTok anuncios para la competencia y la investigación creativa 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 anuncios para la competencia y la investigación creativa 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 anuncios para la competencia y la investigación creativa 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 anuncios por View Count
Prompt: Búsqueda TikTok anuncios para la competencia y la investigación creativa para [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen view count range]. Mantener los límites inferiores y superiores consistentes y mostrar sólo los registros coincidentes.
5. Buscar anuncios por Gmv
Prompt: Búsqueda TikTok anuncios para la competencia y la investigación creativa 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 anuncios por Days Running
Prompt: Búsqueda TikTok anuncios para la competencia y la investigación creativa para [search phrase] dentro [target marketplace]. Limitación de los resultados [my chosen days running 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 anuncios para la competencia y la investigación creativa 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 coincidencias en un tipo de anuncio seleccionado
Prompt: Búsqueda TikTok anuncios para la competencia y la investigación creativa para [search phrase] dentro [target marketplace]. Reducir esta búsqueda [my selected ad type] después de confirmar su valor soportado en la documentación del proveedor, y resumir los registros coincidentes.
9. Excluir Spark Ads
Prompt: Búsqueda TikTok anuncios para la competencia y la investigación creativa para [search phrase] dentro [target marketplace]. Exclude Spark Anuncios de la búsqueda. 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/jsonAutenticació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
nexscope_chuhaijiang_tiktok_ad_searchhttps://api.nexscope.ai/mcptools/callInicializa 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-search-1",
"method": "tools/call",
"params": {
"name": "nexscope_chuhaijiang_tiktok_ad_search",
"arguments": {
"country": "us",
"page": 1,
"pageSize": 3
}
}
}MCP 2025-11-25 · Streamable HTTPLa 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 de búsqueda de anuncios. Ejemplo: beauty |
category | string | opcional | Categoría de productos aprobados por el proveedor. Ejemplo: |
adType | string | opcional | Valor de anuncio aprobado por el proveedor; no enum se publica. Ejemplo: |
excludeSparkAds | boolean | opcional | Ya sea para excluir Spark Ads. Ejemplo: true |
minViews | number | opcional | Valor de filtro del proveedor; mantener la definición métrica del proveedor sin conversión de unidad. Ejemplo: 0 |
maxViews | 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 |
minDays | number | opcional | Valor de filtro del proveedor; mantener la definición métrica del proveedor sin conversión de unidad. Ejemplo: 0 |
maxDays | 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 | Datos empresariales, lista `data.items[]`, número total `data.total_count` |
total_sc | number | opcional | Total SC Metrices |
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 anuncios para la competencia y la investigación creativa. Concéntrate en Italia.
Respuesta de ejemplo
En la muestra publicada, su categoría l1 del producto reportado es 601450. Su tasa de video comunicado es 0.003375074034236909. Su duración notificada es de 57100. 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": "it",
"page": 1,
"pageSize": 10,
"sort": "gmv:desc"
}Respuesta
{
"code": 0,
"msg": null,
"data": {
"data": {
"total_count": 6000,
"items": [
{
"product_l1_category": "601450",
"total_gmv": {
"unit": "IT",
"value": 218275.83282969592
},
"video_like_rate": 0.003375074034236909,
"ad_title": "Questa è la maschera perfetta, se soffre di pelle grassa e hai i pori visibili @medicube Italia #offertestive #cavalcalondadeirisparmi #medicube #pellegrassa #maschera ",
"advertiser_id": "8648556814322080470",
"duration": 57100,
"video_like_count": 47554,
"video_play_count": 14089765,
"product_id": "1729765843626072790",
"ad_day_count": 30,
"ad_maximum_cost": {
"unit": "IT",
"value": 98342.1992352786
},
"ad_roas": 2.2195541133616743,
"id": "7652616390217616662",
"create_time": "1789430400000",
"product_l3_category": "601616",
"ad_url": "https://www.tiktok.com/@lu.linos/video/7652616390217616662?_r=1&u_code=f04769igfa4431&preview_pb=0&sharer_language=en&_d=f04m7e7bmli14m&share_item_id=7652616390217616662&source=h5_m",
"ad_create_time": "1781763616000",
"product_title": "[medicube Ufficiale] Zero Pore Blackhead Mud Mask | Maschera all’argilla anti-punti neri | Maschera all’argilla da 3 minuti | Azione intensiva contro i punti neri",
"video_engagement_rate": 0.0038304400392767373,
"video_popularity": 70261,
"last_update_time": "1791324721361",
"product_l2_category": "848776",
"video_gpm_30d": {
"unit": "IT",
"value": 47.248592089258835
},
"web_url": "https://shop.tiktok.com/view/product/1729765843626072790?region=IT",
"advertiser_name": "medicube Italia",
"advertiser_url": "shop.tiktok.com",
"button_text": "Shop now",
"total_sc": 13865,
"video_id": "7652616390217616662"
},
{
"product_l1_category": "601450",
"total_gmv": {
"unit": "IT",
"value": 196012.93142210477
},
"video_like_rate": 0.0026664825251415955,
"ad_title": "Finalmente è arrivato anche in Italia🤯 Il nuovo e già VIRALISSIMO stick di medicube con volufiline al 5%, PDRN e collagene che potrebbe aiutare a rimpolpare quelle zone del viso che iniziano a perdere un po’ di volume @medicube Italia #volufiline #rughe #skincarecoreana #offerteperte #freshforfall *i risultati possono variare ",
"advertiser_id": "8648556814322080470",
"duration": 52500,
"video_like_count": 7221,
"video_play_count": 2708062,
"product_id": "1729836253867580118",
"ad_day_count": 17,
"ad_maximum_cost": {
"unit": "IT",
"value": 67519.84247999999
},
"ad_roas": 2.9030418943907583,
"id": "7687351925133561120",
"create_time": "1790035200000",
"product_l3_category": "601646",
"ad_url": "https://www.tiktok.com/@rozalatina/video/7687351925133561120?_r=1&u_code=f1365b1kca53ei&preview_pb=0&sharer_language=en&_d=f136445hi0f3cf&share_item_id=7687351925133561120&source=h5_m",
"ad_create_time": "1789851100000",
"product_title": "[medicube Ufficiale] PDRN Pink Collagen Volume Multi Balm | Stick con PDRN, NAD e 5% Volufiline | Aiuta a migliorare linee sottili e compattezza | Contorno occhi, collo, fronte, pieghe nasolabiali e labbra | Skincare coreana",
"video_engagement_rate": 0.0030693536558616457,
"video_popularity": 11709,
"last_update_time": "1791160869461",
"product_l2_category": "848776",
"video_gpm_30d": {
"unit": "IT",
"value": 72.38155094645735
},
"web_url": "https://shop.tiktok.com/view/product/1729836253867580118?region=IT",
"advertiser_name": "medicube Italia",
"advertiser_url": "shop.tiktok.com",
"button_text": "Shop now",
"total_sc": 9411,
"video_id": "7687351925133561120"
},
{
"product_l1_category": "601739",
"total_gmv": {
"unit": "IT",
"value": 158119.37476307564
},
"video_like_rate": 0.006760770226731947,
"ad_title": "Ci sono andata anche al mare e non me lo sono mai tolta 😍😍 #smartwatch #orologio #offerteperte #essenzialiestivi #telefono ",
"advertiser_id": "8647194527526787177",
"duration": 120209,
"video_like_count": 76179,
"video_play_count": 11267799,
"product_id": "1729478541021845609",
"ad_day_count": 30,
"ad_maximum_cost": {
"unit": "IT",
"value": 76231.79896996808
},
"ad_roas": 2.0741918320118304,
"id": "7668362661096066336",
"create_time": "1789516800000",
"product_l3_category": "602083",
"ad_url": "https://www.tiktok.com/@fuorituttoitalia/video/7668362661096066336?_r=1&u_code=f13643flmh0ifb&preview_pb=0&sharer_language=en&_d=f13f9b42442l2f&share_item_id=7668362661096066336&source=h5_m",
"ad_create_time": "1785429817000",
"product_title": "Orologio intelligente multifunzione per uomo / donna, orologio fitness tracker da 1,83 inch con tracciatore di passi / attività, contapassi, orologio intelligente, risposta / effettuare chiamate compatibile con Android iOS, idea regalo per lui / lei",
"video_engagement_rate": 0.007331422933618181,
"video_popularity": 92988,
"last_update_time": "1791324693166",
"product_l2_category": "909576",
"video_gpm_30d": {
"unit": "IT",
"value": 42.124244304286705
},
"web_url": "https://shop.tiktok.com/view/product/1729478541021845609?region=IT",
"advertiser_name": "TOOBUR EU",
"advertiser_url": "shop.tiktok.com",
"button_text": "Shop now",
"total_sc": 5278,
"video_id": "7668362661096066336"
},
{
"product_l1_category": "601450",
"total_gmv": {
"unit": "IT",
"value": 131701.3434524996
},
"video_like_rate": 0.0018136602635922992,
"ad_title": "💗 PDRN + COLLAGENE 💧 Idratazione e luminosità ✨ Effetto pelle più rimpolpata 👀Ideale anche per il contorno occhi 💋 Perfetto per labbra e contorno labbra 🎀 Pratico formato stick da portare sempre con sé Un piccolo stick, tantissimo skincare! 💗 #Medicube #PDRN #PinkCollagen #MultiBalm #Skincare@medicube Italia ",
"advertiser_id": "8648556814322080470",
"duration": 82767,
"video_like_count": 3796,
"video_play_count": 2093005,
"product_id": "1729836253867580118",
"ad_day_count": 30,
"ad_maximum_cost": {
"unit": "IT",
"value": 50290.98172499999
},
"ad_roas": 2.6187864888513395,
"id": "7681359597231148320",
"create_time": "1789948800000",
"product_l3_category": "601646",
"ad_url": "https://www.tiktok.com/@valentinayoutube1/video/7681359597231148320?_r=1&u_code=elg3h1fc3k6jlm&preview_pb=0&sharer_language=en&_d=elh27lb9dff48b&share_item_id=7681359597231148320&source=h5_m",
"ad_create_time": "1788455903000",
"product_title": "[medicube Ufficiale] PDRN Pink Collagen Volume Multi Balm | Stick con PDRN, NAD e 5% Volufiline | Aiuta a migliorare linee sottili e compattezza | Contorno occhi, collo, fronte, pieghe nasolabiali e labbra | Skincare coreana",
"video_engagement_rate": 0.0023081645767688086,
"video_popularity": 6871,
"last_update_time": "1791247377843",
"product_l2_category": "848776",
"video_gpm_30d": {
"unit": "IT",
"value": 74.00777127195954
},
"web_url": "https://shop.tiktok.com/view/product/1729836253867580118?region=IT",
"advertiser_name": "medicube Italia",
"advertiser_url": "shop.tiktok.com",
"button_text": "Shop now",
"total_sc": 6252,
"video_id": "7681359597231148320"
},
{
"product_l1_category": "605196",
"total_gmv": {
"unit": "IT",
"value": 119516.95661968249
},
"video_like_rate": 0.004335338359119131,
"ad_title": "OOONO-CO DRIVER NO1 è il mio assistente alla guida, prima di averlo prendevo un sacco di multe! 🤩 #assistente #guida #multe #shoptiktok #tiktokshop ",
"advertiser_id": "8647568821734250911",
"duration": 50700,
"video_like_count": 10329,
"video_play_count": 2382513,
"product_id": "1729773809873361311",
"ad_day_count": 28,
"ad_maximum_cost": {
"unit": "IT",
"value": 41126.158635
},
"ad_roas": 2.906105519856863,
"id": "7675681472023399712",
"create_time": "1790208000000",
"product_l3_category": "931080",
"ad_url": "https://www.tiktok.com/@emanuelelodirizzini/video/7675681472023399712?_r=1&u_code=em3jlk8c312ld7&preview_pb=0&sharer_language=en&_d=em4bd8b5imeeec&share_item_id=7675681472023399712&source=h5_m",
"ad_create_time": "1787133861000",
"product_title": "OOONO-CO-DRIVER NO1 - Informazioni dal vivo su pericoli e Geschwindigkeitskontrollen",
"video_engagement_rate": 0.004818021979313439,
"video_popularity": 14361,
"last_update_time": "1791153628899",
"product_l2_category": "929928",
"video_gpm_30d": {
"unit": "IT",
"value": 87.04512202772703
},
"web_url": "https://shop.tiktok.com/view/product/1729773809873361311?region=IT",
"advertiser_name": "OOONO Italia",
"advertiser_url": "shop.tiktok.com",
"button_text": "Shop now",
"total_sc": 3872,
"video_id": "7675681472023399712"
},
{
"product_l1_category": "601450",
"total_gmv": {
"unit": "IT",
"value": 102907.27807096508
},
"video_like_rate": 0.0020597820838735787,
"ad_title": "Piastra a vapore #piastra #ukliss #vapore #infrarossi @UKLISS IT #backtoschool ",
"advertiser_id": "8647338929950923033",
"duration": 71667,
"video_like_count": 8596,
"video_play_count": 4173257,
"product_id": "1729769357868636441",
"ad_day_count": 26,
"ad_maximum_cost": {
"unit": "IT",
"value": 57561.81988490244
},
"ad_roas": 1.7877697104909644,
"id": "7678107832717151521",
"create_time": "1789430400000",
"product_l3_category": "874504",
"ad_url": "https://www.tiktok.com/@umaasmr1/video/7678107832717151521?_r=1&u_code=elg03d9434kf5j&preview_pb=0&sharer_language=en&_d=elh96794k01d7a&share_item_id=7678107832717151521&source=h5_m",
"ad_create_time": "1787731260000",
"product_title": "UKLISS LissVapor, Vapore e Infrarossi, Calore Delicato, Effetto Salone",
"video_engagement_rate": 0.0024537190017293446,
"video_popularity": 12800,
"last_update_time": "1791056122459",
"product_l2_category": "849416",
"video_gpm_30d": {
"unit": "IT",
"value": 40.8034815203694
},
"web_url": "https://shop.tiktok.com/view/product/1729769357868636441?region=IT",
"advertiser_name": "UKLISS IT",
"advertiser_url": "shop.tiktok.com",
"button_text": "Shop now",
"total_sc": 1820,
"video_id": "7678107832717151521"
},
{
"product_l1_category": "601450",
"total_gmv": {
"unit": "IT",
"value": 86497.60171111114
},
"video_like_rate": 0.001564326827268292,
"ad_title": "Styler asciugacapelli 5 in 1 #asciugacapelli5in1 #atopskins ",
"advertiser_id": "8647193597469039486",
"duration": 43834,
"video_like_count": 6429,
"video_play_count": 4109755,
"product_id": "1729480123203492734",
"ad_day_count": 30,
"ad_maximum_cost": {
"unit": "IT",
"value": 39886.51296104238
},
"ad_roas": 2.1685927219457453,
"id": "7682311453180693792",
"create_time": "1789516800000",
"product_l3_category": "874504",
"ad_url": "https://www.tiktok.com/@puffypom_lilly/video/7682311453180693792?_r=1&u_code=elfm1gl6cagb54&preview_pb=0&sharer_language=en&_d=elh46mk4042c3i&share_item_id=7682311453180693792&source=h5_m",
"ad_create_time": "1788677527000",
"product_title": "Atopskins Airstyler 5 in 1, asciugacapelli con ioni negativi, styler magico, spazzole termiche Foehn, spazzola dritta, barra riccia, set di spazzole ad aria calda",
"video_engagement_rate": 0.00184293224291959,
"video_popularity": 9859,
"last_update_time": "1791320304162",
"product_l2_category": "849416",
"video_gpm_30d": {
"unit": "IT",
"value": 21.87547067356597
},
"web_url": "https://shop.tiktok.com/view/product/1729480123203492734?region=IT",
"advertiser_name": "Atopskins IT",
"advertiser_url": "shop.tiktok.com",
"button_text": "Shop now",
"total_sc": 1509,
"video_id": "7682311453180693792"
},
{
"product_l1_category": "601450",
"total_gmv": {
"unit": "IT",
"value": 84430.67901218741
},
"video_like_rate": 0.006654348628238015,
"ad_title": "Pensavo fosse solo virale poi ho visto cosa ha tolto dal mio 👃😱 I Zero Pore Pad di @medicube Italia mi hanno fatto capire che non era pulito come pensavo #medicube #skincare #kbeauty #acnetips #pores ",
"advertiser_id": "8648556814322080470",
"duration": 115667,
"video_like_count": 53074,
"video_play_count": 7975837,
"product_id": "1729765843587209942",
"ad_day_count": 27,
"ad_maximum_cost": {
"unit": "IT",
"value": 38307.444773185685
},
"ad_roas": 2.204027951018203,
"id": "7656199948928617760",
"create_time": "1789948800000",
"product_l3_category": "601608",
"ad_url": "https://www.tiktok.com/@elisabetheustafievici/video/7656199948928617760?_r=1&u_code=elg6142mk6gidb&preview_pb=0&sharer_language=en&_d=elh1ic68m7kj0b&share_item_id=7656199948928617760&source=h5_m",
"ad_create_time": "1782597966000",
"product_title": "[medicube Ufficiale] Zero Pore Pad (AHA+BHA) | Pad tonici per una pelle liscia",
"video_engagement_rate": 0.007222815611703198,
"video_popularity": 74703,
"last_update_time": "1791252761967",
"product_l2_category": "848776",
"video_gpm_30d": {
"unit": "IT",
"value": 50.38135028582066
},
"web_url": "https://shop.tiktok.com/view/product/1729765843587209942?region=IT",
"advertiser_name": "medicube Italia",
"advertiser_url": "shop.tiktok.com",
"button_text": "Shop now",
"total_sc": 3983,
"video_id": "7656199948928617760"
},
{
"product_l1_category": "601450",
"total_gmv": {
"unit": "IT",
"value": 79737.32754999428
},
"video_like_rate": 0.0015853913001788605,
"ad_title": "ED È ANCHE SCONTATO!! #backtoschool #indispensabiliscuola #skincareitalia #medicube #antiage ",
"advertiser_id": "8648556814322080470",
"duration": 28667,
"video_like_count": 2910,
"video_play_count": 1835509,
"product_id": "1729836253867580118",
"ad_day_count": 29,
"ad_maximum_cost": {
"unit": "IT",
"value": 30343.11951
},
"ad_roas": 2.627855304189002,
"id": "7678263321505713440",
"create_time": "1789862400000",
"product_l3_category": "601646",
"ad_url": "https://www.tiktok.com/@dalilahome/video/7678263321505713440?_r=1&u_code=f00leeh9eg800e&preview_pb=0&sharer_language=en&_d=f00ld41gfbd9l3&share_item_id=7678263321505713440&source=h5_m",
"ad_create_time": "1787734997000",
"product_title": "[medicube Ufficiale] PDRN Pink Collagen Volume Multi Balm | Stick con PDRN, NAD e 5% Volufiline | Aiuta a migliorare linee sottili e compattezza | Contorno occhi, collo, fronte, pieghe nasolabiali e labbra | Skincare coreana",
"video_engagement_rate": 0.002039216369955146,
"video_popularity": 5167,
"last_update_time": "1791241850547",
"product_l2_category": "848776",
"video_gpm_30d": {
"unit": "IT",
"value": 74.39134250365419
},
"web_url": "https://shop.tiktok.com/view/product/1729836253867580118?region=IT",
"advertiser_name": "medicube Italia",
"advertiser_url": "shop.tiktok.com",
"button_text": "Shop now",
"total_sc": 3798,
"video_id": "7678263321505713440"
},
{
"product_l1_category": "601450",
"total_gmv": {
"unit": "IT",
"value": 78192.80983508681
},
"video_like_rate": 0.005732413800532372,
"ad_title": "Pensavo fosse solo virale poi ho visto cosa ha tolto dal mio viso La Maschera Zero Pore di @medicube Italia mi ha fatto capire cosa vuol dire avere una pelle pulita Contiene 5 tipi di argilla + AHA + BHA + PHA = questo vuol dire pori puliti almeno del 30% ✅💙 APPROVWTA AL 1000% #medicube #SkinCare #kbeauty #acnetips #pores",
"advertiser_id": "8648556814322080470",
"duration": 130100,
"video_like_count": 72374,
"video_play_count": 12625397,
"product_id": "1729765843626072790",
"ad_day_count": 30,
"ad_maximum_cost": {
"unit": "IT",
"value": 34742.53818736
},
"ad_roas": 2.250636076541318,
"id": "7656456897222020384",
"create_time": "1789430400000",
"product_l3_category": "601616",
"ad_url": "https://www.tiktok.com/@elisabetheustafievici/video/7656456897222020384?_r=1&u_code=elg6142mk6gidb&preview_pb=0&sharer_language=en&_d=elh1ic68m7kj0b&share_item_id=7656456897222020384&source=h5_m",
"ad_create_time": "1782657791000",
"product_title": "[medicube Ufficiale] Zero Pore Blackhead Mud Mask | Maschera all’argilla anti-punti neri | Maschera all’argilla da 3 minuti | Azione intensiva contro i punti neri",
"video_engagement_rate": 0.006376195536663124,
"video_popularity": 99262,
"last_update_time": "1791252761967",
"product_l2_category": "848776",
"video_gpm_30d": {
"unit": "IT",
"value": 40.611455891013556
},
"web_url": "https://shop.tiktok.com/view/product/1729765843626072790?region=IT",
"advertiser_name": "medicube Italia",
"advertiser_url": "shop.tiktok.com",
"button_text": "Shop now",
"total_sc": 4809,
"video_id": "7656456897222020384"
}
]
},
"request_id": "699c0ac8-8e7e-40e5-80e6-1683e8bdb8c7"
}
}Ver el formato de solicitud y respuesta MCP
Ejemplos
Se basa en una muestra de la documentación publicada, no en 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": "chuhaijiang-tiktok-ad-search-example",
"method": "tools/call",
"params": {
"name": "nexscope_chuhaijiang_tiktok_ad_search",
"arguments": {
"country": "it",
"page": 1,
"pageSize": 10,
"sort": "gmv:desc"
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "chuhaijiang-tiktok-ad-search-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"data\":{\"items\":[{\"id\":\"7652616390217616662\",\"product_l1_category\":\"601450\",\"total_gmv\":{\"value\":218275.83282969592,\"unit\":\"IT\"},\"video_like_rate\":0.003375074034236909,\"ad_title\":\"Questa è la maschera perfetta, se soffre di pelle grassa e hai i pori visibili @medicube Italia #offertestive #cavalcalondadeirisparmi #medicube #pellegrassa #maschera \",\"advertiser_id\":\"8648556814322080470\",\"duration\":57100,\"video_like_count\":47554,\"video_play_count\":14089765,\"product_id\":\"1729765843626072790\",\"ad_day_count\":30,\"ad_roas\":2.2195541133616743},{\"id\":\"7687351925133561120\",\"product_l1_category\":\"601450\",\"total_gmv\":{\"value\":196012.93142210477,\"unit\":\"IT\"},\"video_like_rate\":0.0026664825251415955,\"ad_title\":\"Finalmente è arrivato anche in Italia🤯 Il nuovo e già VIRALISSIMO stick di medicube con volufiline al 5%, PDRN e collagene che potrebbe aiutare a rimpolpare quelle zone del viso che iniziano a perdere un po’ di volume @medicube Italia #volufiline #rughe #skincarecoreana #offerteperte #freshforfall *i risultati possono variare \",\"advertiser_id\":\"8648556814322080470\",\"duration\":52500,\"video_like_count\":7221,\"video_play_count\":2708062,\"product_id\":\"1729836253867580118\",\"ad_day_count\":17,\"ad_roas\":2.9030418943907583}],\"total_count\":6000},\"request_id\":\"699c0ac8-8e7e-40e5-80e6-1683e8bdb8c7\"}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"data": {
"items": [
{
"id": "7652616390217616662",
"product_l1_category": "601450",
"total_gmv": {
"value": 218275.83282969592,
"unit": "IT"
},
"video_like_rate": 0.003375074034236909,
"ad_title": "Questa è la maschera perfetta, se soffre di pelle grassa e hai i pori visibili @medicube Italia #offertestive #cavalcalondadeirisparmi #medicube #pellegrassa #maschera ",
"advertiser_id": "8648556814322080470",
"duration": 57100,
"video_like_count": 47554,
"video_play_count": 14089765,
"product_id": "1729765843626072790",
"ad_day_count": 30,
"ad_roas": 2.2195541133616743
},
{
"id": "7687351925133561120",
"product_l1_category": "601450",
"total_gmv": {
"value": 196012.93142210477,
"unit": "IT"
},
"video_like_rate": 0.0026664825251415955,
"ad_title": "Finalmente è arrivato anche in Italia🤯 Il nuovo e già VIRALISSIMO stick di medicube con volufiline al 5%, PDRN e collagene che potrebbe aiutare a rimpolpare quelle zone del viso che iniziano a perdere un po’ di volume @medicube Italia #volufiline #rughe #skincarecoreana #offerteperte #freshforfall *i risultati possono variare ",
"advertiser_id": "8648556814322080470",
"duration": 52500,
"video_like_count": 7221,
"video_play_count": 2708062,
"product_id": "1729836253867580118",
"ad_day_count": 17,
"ad_roas": 2.9030418943907583
}
],
"total_count": 6000
},
"request_id": "699c0ac8-8e7e-40e5-80e6-1683e8bdb8c7"
}
},
"isError": false
}
}