Run large TikTok Ads performance pulls with the Asynchronous Reporting Task API
domain: business-api.tiktok.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Authenticate with an advertiser access token obtained via the Ads API OAuth flow.
POST /open_api/v1.3/report/task/create/ with advertiser_id, report_type, data_level, dimensions, metrics, start_date, and end_date to create the report task.
Poll GET /open_api/v1.3/report/task/check/ with the returned task ID until the status shows complete.
Call the dedicated download endpoint to retrieve the report output once ready.
Use POST /open_api/v1.3/report/task/cancel/ if you need to abandon a queued task.
Reserve this async flow for wide date ranges or account-wide breakdowns, and use the synchronous Integrated Reporting endpoint only for small, real-time pulls.
Known gotchas
Reporting endpoints have their own rate-limit quota separate from campaign and creative endpoints — sharing one rate budget across all endpoint families causes unexpected throttling.
Using the synchronous endpoint for a query that should be async (long range, many dimensions) burns through rate limits fast; picking the wrong endpoint is the most common mistake here.
Exact numeric rate-limit ceilings vary by account tier and aren't fixed published constants — pull current limits from your own developer portal rather than hardcoding a number.
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?