{
  "x402Version": 2,
  "id": 4759,
  "slug": "4759",
  "resource": "https://ads.apitoll.cloud/v1/ads/facebook/search",
  "description": "Facebook Ad Library search by keyword — every live and recent ad matching a search term across all advertisers on Facebook, Instagram, Messenger and Threads. Returns the full ad creative (headline, body copy, CTA button + destination link, image and video URLs), the advertiser, run dates and days-running, and platform mix. Commercial and political ads, no Meta API or login. Competitor ad intelligence, ad spy, and creative research for AI agents.",
  "type": "http",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0x4ce88238F669d04351937420C931988e464a975a",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "30000",
      "maxTimeoutSeconds": 150
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "HZ5rN5HmZpu2H16auY5Zt5SuJjCMBG77odVhAVSuhK1x",
      "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "amount": "30000",
      "maxTimeoutSeconds": 150
    }
  ],
  "outputSchema": {
    "bazaar": {
      "info": {
        "input": {
          "method": "GET",
          "queryParams": {
            "country": "US",
            "q": "running shoes"
          },
          "type": "http"
        },
        "output": {
          "example": {
            "ads": [
              {
                "adArchiveId": "1234567890123456",
                "bodyText": "Lightweight cushioning for your longest runs. Free shipping this week.",
                "country": "US",
                "ctaText": "Shop Now",
                "ctaType": "SHOP_NOW",
                "daysRunning": 28,
                "displayFormat": "VIDEO",
                "imageUrls": [
                  "https://scontent.xx.fbcdn.net/v/img1.jpg"
                ],
                "isActive": true,
                "linkUrl": "https://acmefootwear.com/aeroglide?utm_source=fb",
                "linkUrlType": "destination",
                "mediaExpiresAt": "2026-06-29T22:19:28Z",
                "pageId": "100066543210987",
                "pageName": "Acme Footwear",
                "pageVerified": true,
                "publisherPlatform": [
                  "FACEBOOK",
                  "INSTAGRAM"
                ],
                "scrapedAt": "2026-06-25T14:32:09Z",
                "sourceUrl": "https://www.facebook.com/ads/library/?q=running%20shoes&country=US",
                "startDate": 1717200000,
                "templatedText": false,
                "title": "Run Further in the new AeroGlide",
                "videoUrl": "https://video.xx.fbcdn.net/v/ad_hd.mp4"
              }
            ],
            "asOf": "2026-06-25T14:32:10Z",
            "count": 25,
            "country": "US",
            "query": {
              "keyword": "running shoes"
            },
            "source": {
              "name": "Facebook Ad Library",
              "via": "Apify"
            }
          },
          "type": "json"
        }
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "input": {
            "additionalProperties": false,
            "properties": {
              "method": {
                "enum": [
                  "GET"
                ],
                "type": "string"
              },
              "queryParams": {
                "properties": {
                  "active_status": {
                    "description": "Filter by whether the ad is still running.",
                    "enum": [
                      "all",
                      "active",
                      "inactive"
                    ],
                    "type": "string"
                  },
                  "ad_type": {
                    "description": "Ad category filter. political_and_issue_ads MAY add spend + impressions ranges when Meta discloses them (often absent).",
                    "enum": [
                      "all",
                      "political_and_issue_ads",
                      "housing_ads",
                      "employment_ads",
                      "credit_ads",
                      "financial_products_and_services_ads"
                    ],
                    "type": "string"
                  },
                  "country": {
                    "description": "Two-letter ISO country (US, GB, DE, BR…) the ads target, or ALL for a bounded multi-region sweep (slower). Default US.",
                    "type": "string"
                  },
                  "limit": {
                    "description": "Max ads to return (1-60).",
                    "maximum": 60,
                    "minimum": 1,
                    "type": "integer"
                  },
                  "media_type": {
                    "description": "Creative format filter.",
                    "enum": [
                      "all",
                      "image",
                      "video",
                      "meme",
                      "image_and_meme",
                      "none"
                    ],
                    "type": "string"
                  },
                  "period": {
                    "description": "Limit to ads active in this window. Blank = all time.",
                    "enum": [
                      "",
                      "last24h",
                      "last7d",
                      "last14d",
                      "last30d"
                    ],
                    "type": "string"
                  },
                  "platforms": {
                    "description": "Comma-separated publisher filter: FACEBOOK,INSTAGRAM,MESSENGER,AUDIENCE_NETWORK,THREADS,WHATSAPP. Blank = all.",
                    "type": "string"
                  },
                  "q": {
                    "description": "Keyword/phrase to search ads for (e.g. \"running shoes\", \"crypto wallet\"). Defaults to a demo query if omitted.",
                    "type": "string"
                  },
                  "resolve_advertiser": {
                    "description": "Also resolve each advertiser’s page identity (verified status, categories, profile pic). Slower. Default false.",
                    "type": "boolean"
                  },
                  "sort_by": {
                    "description": "most_recent (newest/currently-running first — default) or impressions_desc (all-time highest-impression ads, often older/ended).",
                    "enum": [
                      "impressions_desc",
                      "most_recent"
                    ],
                    "type": "string"
                  }
                },
                "required": [
                  "q"
                ],
                "type": "object"
              },
              "type": {
                "const": "http",
                "type": "string"
              }
            },
            "required": [
              "type",
              "method"
            ],
            "type": "object"
          },
          "output": {
            "properties": {
              "example": {
                "properties": {
                  "ads": {
                    "items": {
                      "properties": {
                        "adArchiveId": {
                          "type": "string"
                        },
                        "bodyText": {
                          "type": "string"
                        },
                        "country": {
                          "type": "string"
                        },
                        "ctaText": {
                          "type": "string"
                        },
                        "ctaType": {
                          "type": "string"
                        },
                        "daysRunning": {
                          "type": "number"
                        },
                        "displayFormat": {
                          "type": "string"
                        },
                        "imageUrls": {
                          "items": {
                            "type": "string"
                          },
                          "type": "array"
                        },
                        "isActive": {
                          "type": "boolean"
                        },
                        "linkUrl": {
                          "type": "string"
                        },
                        "linkUrlType": {
                          "type": "string"
                        },
                        "mediaExpiresAt": {
                          "type": "string"
                        },
                        "pageId": {
                          "type": "string"
                        },
                        "pageName": {
                          "type": "string"
                        },
                        "pageVerified": {
                          "type": "boolean"
                        },
                        "publisherPlatform": {
                          "items": {
                            "type": "string"
                          },
                          "type": "array"
                        },
                        "scrapedAt": {
                          "type": "string"
                        },
                        "sourceUrl": {
                          "type": "string"
                        },
                        "startDate": {
                          "type": "number"
                        },
                        "templatedText": {
                          "type": "boolean"
                        },
                        "title": {
                          "type": "string"
                        },
                        "videoUrl": {
                          "type": "string"
                        }
                      },
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "asOf": {
                    "type": "string"
                  },
                  "count": {
                    "type": "number"
                  },
                  "country": {
                    "type": "string"
                  },
                  "query": {
                    "properties": {
                      "keyword": {
                        "type": "string"
                      }
                    },
                    "type": "object"
                  },
                  "source": {
                    "properties": {
                      "name": {
                        "type": "string"
                      },
                      "via": {
                        "type": "string"
                      }
                    },
                    "type": "object"
                  }
                },
                "type": "object"
              },
              "type": {
                "type": "string"
              }
            },
            "required": [
              "type"
            ],
            "type": "object"
          }
        },
        "required": [
          "input"
        ],
        "type": "object"
      }
    }
  },
  "tags": [
    "bazaar"
  ],
  "sourceHost": "ads.apitoll.cloud",
  "lastUpdated": "2026-09-18T07:50:52.241Z",
  "quality": {
    "calls30d": 4,
    "uniquePayers30d": 4,
    "lastCalledAt": "2026-09-18T07:50:51.74Z"
  },
  "liveness": {},
  "verified": false,
  "featured": false,
  "provider": {
    "host": "ads.apitoll.cloud",
    "manifest_name": "ads.apitoll.cloud",
    "source": "cdp-mirror",
    "source_manifest_url": "https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources",
    "submitted_at": "2026-09-18T22:00:31.484Z"
  }
}