Pull campaign performance from The Trade Desk's Reporting (My Reports) API
domain: thetradedesk.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Authenticate with POST /v3/authentication using your credentials to get a token, then send it on every call as the TTD-Auth header.
Store your API key securely at creation time — the Partner Portal does not let you retrieve it again once issued.
Use the My Reports (REDS) endpoints, e.g. POST /v3/myreports/reportexecution/query/advertisers, to trigger execution of a pre-built report template.
Poll for completion, since reports generate asynchronously and can take several minutes for large date ranges.
Retrieve the download link once the report execution reports as complete.
Confirm whether report templates in your account were built via the UI or are programmatically creatable before assuming a fully API-driven workflow.
Known gotchas
Auth is a proprietary TTD-Auth header issued from a token endpoint, not OAuth2 — don't reuse a generic OAuth client against this API.
Reports are asynchronous; treating the execution call as synchronous and reading an empty initial response as 'no data' is a common mistake.
Don't confuse this Reporting/REDS API with the separate Data & Insights (Signal) API or the Platform API used for campaign/ad-group CRUD — they're distinct product areas with different endpoints.
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?