Menu da documentação
Primeiros passos
O que é o Opus GrowthInício rápidoAdicione à sua IAComo funcionaSegurança e aprovaçãoCréditosPlanosPerguntas frequentesApps de IA
Todos os appsChatGPTClaudeGrokPerplexityClaude CodeCodexGemini CLIOpenClawCursorVS CodeWindsurfOutros MCPPlataformas de anúncios
Google AdsMeta AdsLinkedIn AdsMicrosoft AdvertisingTikTok AdsChatGPT AdsAgências e MCCFontes de dados
Search ConsoleGoogle AnalyticsYouTubeBusiness ProfileTag ManagerSites e SEO
AI ServerWordPressSEO IntelligenceFraude de cliquesReferência de ferramentas
Todas as ferramentasGoogle AdsMeta AdsTikTok AdsLinkedIn AdsMicrosoft AdvertisingChatGPT AdsSearch ConsoleGoogle AnalyticsYouTubeBusiness ProfileTag ManagerWordPressAI ServerSEO IntelligenceFraude de cliquesMulticanalConta e cobrançaIdioma
TikTok Report Query
Free-form READ of TikTok's integrated report endpoint (/report/integrated/get/): any metric and dimension TikTok supports.
- Tipo
- Somente leitura
- Créditos
- 2
- Plataforma
- TikTok Ads
- Aprovação
- Não precisa, nada muda
O que faz
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.
A descrição está em inglês porque é o texto oficial que sua IA vê.
MCP: tiktok_report_query
Como usar
Você não chama as ferramentas pelo nome. Escreva o que quer no ChatGPT, Claude ou outro assistente conectado ao Opus Growth; a IA escolhe esta ferramenta quando ela serve.
Parâmetros
| Nome | Tipo | Obrigatório | Padrão | |
|---|---|---|---|---|
| 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. |
Ferramentas 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