Menú de documentación
Primeros pasos
Qué es Opus GrowthInicio rápidoAñádelo a tu IACómo funcionaSeguridad y aprobaciónCréditosPlanesPreguntas frecuentesApps de IA
Todas las appsChatGPTClaudeGrokPerplexityClaude CodeCodexGemini CLIOpenClawCursorVS CodeWindsurfOtros MCPPlataformas publicitarias
Google AdsMeta AdsLinkedIn AdsMicrosoft AdvertisingTikTok AdsChatGPT AdsAgencias y MCCFuentes de datos
Search ConsoleGoogle AnalyticsYouTubePerfil de EmpresaTag ManagerWebs y SEO
AI ServerWordPressSEO IntelligenceFraude de clicsReferencia de herramientas
Todas las herramientasGoogle AdsMeta AdsTikTok AdsLinkedIn AdsMicrosoft AdvertisingChatGPT AdsSearch ConsoleGoogle AnalyticsYouTubePerfil de EmpresaTag ManagerWordPressAI ServerSEO IntelligenceFraude de clicsMulticanalCuenta y facturaciónIdioma
TikTok Report Query
Free-form READ of TikTok's integrated report endpoint (/report/integrated/get/): any metric and dimension TikTok supports.
- Tipo
- Solo lectura
- Créditos
- 2
- Plataforma
- TikTok Ads
- Aprobación
- No hace falta, nada cambia
Qué hace
Free-form READ of TikTok's integrated report endpoint (/report/integrated/get/): any metric and dimension TikTok supports. report_type: BASIC (performance) | AUDIENCE (age, gender, country_code, province_id, platform, placement...) | PLAYABLE_MATERIAL | CATALOG | BC | TT_SHOP. data_level: AUCTION_ADVERTISER | AUCTION_CAMPAIGN | AUCTION_ADGROUP | AUCTION_AD. dimensions: a list such as ['campaign_id'], ['adgroup_id','stat_time_day'], ['ad_id','gender']. metrics: spend, impressions, clicks, ctr, cpc, cpm, reach, frequency, conversion, cost_per_conversion, result, cost_per_result, video_play_actions, video_watched_6s, average_video_play, likes, comments, shares, follows, profile_visits, … lifetime=true returns totals since the start of each object (no date range). Otherwise days = last N full days excluding today, or start_date/end_date (YYYY-MM-DD); TikTok limits the range (30 days with stat_time_day) and rejects longer ranges with an explanatory error. filtering: TikTok filter objects with field_name, filter_type and filter_value. Reference: https://business-api.tiktok.com/portal/docs?id=1740302848100353. Read-only; reply carries the exact `period` or lifetime=true. limit controls the response page; page_token=next_page_token returns later pages without another API call or credit.
La descripción está en inglés porque es el texto oficial que ve tu IA.
MCP: tiktok_report_query
Cómo usarla
No llamas a las herramientas por su nombre. Escribe lo que quieres en ChatGPT, Claude u otro asistente conectado a Opus Growth; la IA elige esta herramienta cuando encaja.
Parámetros
| Nombre | Tipo | Obligatorio | Por defecto | |
|---|---|---|---|---|
| metrics | array | Opcional | · | Metrics to return or configure, using provider-supported metric names and the documented item format. |
| dimensions | array | Opcional | · | Dimensions by which to group or select data, using provider-supported dimension names. |
| advertiser_id | string | Opcional | · | TikTok advertiser account ID to query or change. Use the exact ID returned by list_tiktok_advertisers or list_tiktok_bc_advertisers. |
| report_type | string | Opcional | BASIC | Provider-specific report type accepted by this operation. Use a supported value from the tool documentation or returned provider data. |
| data_level | string | Opcional | AUCTION_CAMPAIGN | Exact data level value for tiktok report query. Supply text in the provider's required format; when it selects an existing resource, use the exact identifier returned by the relevant list or search operation. |
| days | integer | Opcional | 30 | Number of calendar days to look back from now for this analysis or report. |
| start_date | string | Opcional | · | Inclusive start date for the requested period, in the format required by this tool. |
| end_date | string | Opcional | · | Inclusive end date for the requested period, in the format required by this tool. |
| lifetime | boolean | Opcional | false | Whether to enable lifetime for this operation. |
| filtering | array | Opcional | · | Filtering value for tiktok report query. Follow the documented provider format and use values returned by Opus Growth discovery tools where possible. |
| limit | integer | Opcional | 0 | Maximum number of rows returned in this response. When the result has_more flag is true, continue with next_page_token rather than assuming the list is complete. |
| page_token | string | Opcional | · | Continuation token returned as next_page_token by a previous call. Leave empty for the first page; pass it unchanged to retrieve the cached next page. |
Herramientas relacionadas
connect_tiktok_adsCreate TikTok Adcreate_tiktok_adCreate TikTok Ad Groupcreate_tiktok_adgroupCreate TikTok Welcome-Chat Templatecreate_tiktok_auto_messageCreate TikTok Campaigncreate_tiktok_campaignCreate TikTok Customer-List Audiencecreate_tiktok_customer_file_audienceCreate TikTok Ad Identitycreate_tiktok_identityCreate TikTok Lookalike Audiencecreate_tiktok_lookalike_audienceCreate TikTok Pixelcreate_tiktok_pixel