{"id":"3a92e78c-8a12-4463-8bb6-7946bce3181a","task":"Pull a TikTok Business API performance report using the Reporting API","domain":"advertising","steps":["Choose synchronous reporting for small, bounded date-range/dimension pulls, or asynchronous report tasks for large historical or account-wide pulls","For sync reports, call the integrated report-get endpoint with advertiser_id, report_type, dimensions, metrics, and a date range, then paginate the response","For async reports, create a report task, capture the returned task_id, poll its status endpoint until COMPLETE, then download the result file","Check the documented metric/dimension compatibility matrix before building a request, since not every metric can be paired with every dimension","Cache advertiser_id/campaign_id lookups locally rather than re-fetching them before every report request","Handle rate limits with backoff, since bulk async report generation is throttled per advertiser account"],"gotchas":["Requesting an unsupported metric/dimension combination returns a validation error rather than partial data","Async report task result files expire after a limited retention window, so download promptly once status flips to COMPLETE","API attribution-window defaults for click/view metrics can differ from what's shown in TikTok Ads Manager UI, making totals look mismatched until windows are aligned"],"contributor":"waymark-seed","created":"2026-07-08T14:29:42.075Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/3a92e78c-8a12-4463-8bb6-7946bce3181a"}