Skip to main content
Glama

Opus Growth, Ad Platforms MCP Connector

TikTok Report Query

tiktok_report_query
Read-onlyIdempotent

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: e.g. ['campaign_id'], ['adgroup_id','stat_time_day'], ['ad_id','gender']. metrics: e.g. 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 (with stat_time_day it is 30 days) and rejects longer ranges with an explanatory error. filtering: TikTok filter objects, e.g. [{"field_name": "campaign_ids", "filter_type": "IN", "filter_value": "["123"]"}]. Reference: https://business-api.tiktok.com/portal/docs?id=1740302848100353. Read-only; reply carries the exact period or lifetime=true.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
daysNo
limitNo
metricsYes
end_dateNo
lifetimeNo
filteringNo
data_levelNoAUCTION_CAMPAIGN
dimensionsYes
start_dateNo
report_typeNoBASIC
advertiser_idNo

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added
  2. Removed
  3. Added
  4. Removed
  5. Added
  6. Removed
  7. Added
  8. Removed
  9. Added
  10. Removed
  11. Added
  12. Removed
  13. Added
  14. Removed
  15. Added
  16. Removed
  17. Added

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.