Docs menu
Get started
What is Opus GrowthQuickstartAdd to your AIHow it worksSafety and approvalCreditsPlansFAQAI apps
All AI appsChatGPTClaudeGrokPerplexityClaude CodeCodexGemini CLIOpenClawCursorVS CodeWindsurfOther MCPConnect ad platforms
Google AdsMeta AdsLinkedIn AdsMicrosoft AdvertisingTikTok AdsChatGPT AdsAgencies and MCCConnect data sources
Search ConsoleGoogle AnalyticsYouTubeBusiness ProfileTag ManagerWebsites and SEO
AI ServerWordPressSEO IntelligenceClick fraudTool reference
All toolsGoogle AdsMeta AdsTikTok AdsLinkedIn AdsMicrosoft AdvertisingChatGPT AdsSearch ConsoleGoogle AnalyticsYouTubeBusiness ProfileTag ManagerWordPressAI ServerSEO IntelligenceClick fraudCross-channelAccount and billingLanguage
TikTok Report Query
Free-form READ of TikTok's integrated report endpoint (/report/integrated/get/): any metric and dimension TikTok supports.
- Type
- Reads only
- Credits
- 2
- Platform
- TikTok Ads
- Approval
- Not needed, nothing changes
What it does
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.
MCP: tiktok_report_query
How to use it
You don't call tools by name. Write what you want in ChatGPT, Claude or another assistant connected to Opus Growth, in your own words; it picks this tool when it fits.
Parameters
| Name | Type | Required | Default | |
|---|---|---|---|---|
| metrics | array | Optional | · | Metrics to return or configure, using provider-supported metric names and the documented item format. |
| dimensions | array | Optional | · | Dimensions by which to group or select data, using provider-supported dimension names. |
| advertiser_id | string | Optional | · | 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 | Optional | BASIC | Provider-specific report type accepted by this operation. Use a supported value from the tool documentation or returned provider data. |
| data_level | string | Optional | 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 | Optional | 30 | Number of calendar days to look back from now for this analysis or report. |
| start_date | string | Optional | · | Inclusive start date for the requested period, in the format required by this tool. |
| end_date | string | Optional | · | Inclusive end date for the requested period, in the format required by this tool. |
| lifetime | boolean | Optional | false | Whether to enable lifetime for this operation. |
| filtering | array | Optional | · | Filtering value for tiktok report query. Follow the documented provider format and use values returned by Opus Growth discovery tools where possible. |
| limit | integer | Optional | 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 | Optional | · | 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. |
Related tools
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