Discover Meta Assets

User wants to browse existing images in their Meta Ad Library for reuse in new campaigns.

This tool retrieves existing images that have been uploaded to Meta’s Ad Library, allowing users to reuse them in new campaigns without uploading again.

Returns:

List of existing images with their hashes
Image dimensions and thumbnails
Created timestamps
Instructions for using images in campaigns

When to use this tool:

“Show me my existing Meta ad images”
“What images do I already have in Meta?”
“I want to reuse an existing image for my campaign”
“List my Facebook ad library images”
Before uploading new images - check if they already exist

Parameters:

ad_account_id: Required for multi-account users. Get from list_connected_accounts
limit: Max images to return (default 50, max 100)

Execution time: 2-5 seconds Data source: Meta Ad Library API (live)

Workflow:

Use discover_meta_assets to find existing images
Copy the image_hash from an image you want to use
Use that hash with create_meta_image_campaign via the existing_image_hash parameter

POST

/

api

/

v1

/

tools

/

discover_meta_assets

/

execute

Discover Meta Assets

curl --request POST \
  --url https://api.adspirer.ai/api/v1/tools/discover_meta_assets/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "arguments": {
    "ad_account_id": "string",
    "limit": 50
  }
}
'

{
  "data": {
    "quota": {
      "limit": 150,
      "period_end": "2026-05-01",
      "tier": "plus",
      "used": 42
    },
    "text": "(tool-specific textual output for discover_meta_assets)"
  },
  "success": true,
  "tool": "discover_meta_assets"
}

Authorizations

Authorization

string

header

required

API key from https://adspirer.ai/keys. Prefix sk_live_. Treat as a secret — never commit.

Headers

Idempotency-Key

string<uuid>

Client-generated UUID to make writes idempotent. Strongly recommended for write tools. A repeat call with the same key returns the cached result instead of re-executing. Example: 550e8400-e29b-41d4-a716-446655440000

Body

application/json

All tool arguments are wrapped in an arguments object. The fields accepted inside arguments are listed below — required fields are marked with a red asterisk.

arguments

object

required

Input schema for discovering existing Meta ad images

Show child attributes

Response

Tool executed successfully. data.text carries the human-readable result (markdown-friendly). data.quota shows your current usage against the plan limit. data.structured appears when the tool emits machine-parseable structured content. data.content appears for tools that return non-text blocks (images, resources).

Returned on HTTP 200. data.text is the primary human-readable output. data.quota is always present for billable calls. data.structured is set only when the tool emits machine-parseable structured content. data.content is set only when the tool emits non-text content blocks.

data

object

required

Show child attributes

success

boolean

required

tool

string

required

Echoed tool_name from the request URL.

Last modified on April 23, 2026

Duplicate Meta CampaignUser wants to duplicate/copy an existing Meta campaign with all its ad sets, ads, and settings. IMPORTANT: This creates a NEW real campaign in Meta Ads. The duplicate starts in PAUSED status by default for review. This tool copies the entire campaign structure including: - Campaign settings (objective, budget strategy) - All ad sets (targeting, budgets, schedules) - All ads (creatives, text, CTAs) Returns: - Original and new campaign IDs - New campaign status - Ads Manager URL for the new campaign - Next steps for review and activation When to use this tool: - "Duplicate my campaign" - "Copy campaign [ID]" - "Create a copy of this campaign" - "I want to A/B test with a copy of my campaign" - "Clone my campaign with different targeting" Parameters: - campaign_id: The Meta Campaign ID to duplicate (required) - new_name: Name for the new campaign (optional, defaults to original + " - Copy") - status: Status for new campaign — 'PAUSED' (default, recommended) or 'ACTIVE' Execution time: 10-30 seconds (depends on campaign size) Creates: New real campaign in Meta Ads Common use cases: 1. A/B Testing: Duplicate, then modify targeting or creative on the copy 2. Seasonal variants: Copy a proven campaign, update copy and dates 3. New market expansion: Duplicate, change location targeting 4. Budget testing: Copy, change budget levels Workflow: 1. Use `list_meta_campaigns` to find the campaign ID 2. Use `duplicate_meta_campaign` to create the copy 3. Use `update_meta_campaign` or `update_meta_ad_set` to modify the copy 4. Use `resume_meta_campaign` when ready to launch

Discover Meta Assets

curl --request POST \
  --url https://api.adspirer.ai/api/v1/tools/discover_meta_assets/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "arguments": {
    "ad_account_id": "string",
    "limit": 50
  }
}
'

{
  "data": {
    "quota": {
      "limit": 150,
      "period_end": "2026-05-01",
      "tier": "plus",
      "used": 42
    },
    "text": "(tool-specific textual output for discover_meta_assets)"
  },
  "success": true,
  "tool": "discover_meta_assets"
}