Meta Ads

List the images and videos already in a Meta ad account

Lists the images and videos that already exist in the ad account's library, with the image hash or video id an ad is built from. Use when: the user says the file is "already in the account", asks to reuse a creative from an earlier ad, or has a file but no public link — uploading it once in Ads Manager and reusing it here needs no hosting anywhere. Do not use to check a file the user has only as a link; that is check_media, which is free. Returns each image's hash, name and pixel size, and each video's id, title and length. Those ids go straight into the create tools as image_hash or video_id, and skip the upload entirely. If the library is empty, say so and offer the two other ways in: a public link to the file, or an upload in Ads Manager first.

post/api/v1/tools/meta_list_media/execute

Request

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