List TikTok campaigns
Lists the campaigns in a TikTok advertiser account with objective, on/off state, budget and budget mode, and the delivery status TikTok computed for each one. Use when: you need campaign ids before reading performance or changing anything, or the user asks what is running on TikTok. Do not use it to compare results — that is tiktok_get_campaign_performance; this returns configuration only, with no spend or views in it. Returns two different status fields, and the difference matters: "status" is what the advertiser set (active or paused), while "delivery" is what TikTok computed. A campaign can be active and still deliver nothing because its budget is exhausted, its ad groups are all paused, or its ads are still in review. When every number in a report is zero, read this first. Budgets are decimals in the account currency. A campaign with budget mode BUDGET_MODE_INFINITE holds no budget of its own — the ad groups underneath do, so look there with tiktok_list_ad_groups. If the user names a campaign you cannot find here, say so and ask; never guess an id.
Request
- Base URL: https://adako.ai
- URL: https://adako.ai/api/v1/tools/tiktok_list_campaigns/execute
- Auth: HTTP bearer
Headers
Optional 8-128 character key. A successful envelope is cached for 24 hours; replaying the key with the same arguments returns it again with Idempotent-Replayed: true, and replaying it with different arguments answers 409.
Request body
Response
The tool ran. A write returns proposal_id and approve_url while the change waits for approval.
Changes
No recorded changes to this operation across all 1 revision of this API.