TikTok Ads

List TikTok ads

Lists individual ads with their on/off state, delivery status, the video and cover images behind each one, the ad text and call to action, the destination URL and — most usefully — TikTok's review verdict, read from the ad's delivery status. Use when: you need ad ids, the user asks what creative is live, or an ad is not delivering and review might be why. Do not use it to judge creative quality: get the numbers from tiktok_get_ad_performance first, then look at the copy. Do not invent a rejection reason: TikTok's API says an ad was not approved but never why, so ask the user to read the reason next to the ad in Ads Manager. Returns video_id for each ad, which is what tiktok_add_ad needs to reuse a creative that already works, and tiktok_list_ad_videos can turn into the video's dimensions and duration. Pass adgroup_id or campaign_id to scope the list; without either you get every ad in the advertiser account.

post/api/v1/tools/tiktok_list_ads/execute

Request

  • Base URL: https://adako.ai
  • URL: https://adako.ai/api/v1/tools/tiktok_list_ads/execute
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

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.

successunknown required
toolstring required
dataobject required

Machine-readable result.

markdownstring required

The same result written for a person or a model.

proposal_idstring

Present for writes. Nothing changes on the ad platform until it is approved.

approve_urlstring

Where a person approves the proposal.

request_idstring required

Changes

No recorded changes to this operation across all 1 revision of this API.