ChatGPT Ads

List ChatGPT Ads ads

Lists individual ads with their status, the chat card behind each one (title, body, destination) and — most usefully — the platform's review verdict and reason. Use when: you need ad ids, or the user asks what creative is live, or an ad is not delivering and you need to know whether review is the reason. Do not use to judge creative quality — get the numbers from chatgpt_get_performance first, then look at the copy. Returns review_status: an ad that is in_review is not delivering yet, and one that is rejected never will until the copy or destination changes. The rejection reason is the single most useful field on this platform, so quote it to the user verbatim rather than paraphrasing. Pass ad_group_id to scope the list; without it you get every ad in the account.

post/api/v1/tools/chatgpt_list_ads/execute

Request

  • Base URL: https://adako.ai
  • URL: https://adako.ai/api/v1/tools/chatgpt_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.