Go back
Meta Ads Library

Meta Ads Library

v1 · 2 endpoints

Meta Ads Library (2)

API Explorer

— credits
ColdIQ
APIs→Meta Ads Library
Ctrl + K
Switch provider
Ctrl + P
Switch endpoint
POSThttps://api.coldiq.com/v1/meta-ads/search0.16 cr

Start an async job to search the Facebook Ads Library by keyword or URL. Returns a `jobId` immediately — poll `GET /meta…

Authentication

No API key — create one in the dashboard

Body

Keyword to search in the Facebook Ads Library. Required when urls is not provided.

Two-letter country code to scope results (e.g. "US", "GB"). Defaults to "US" when not provided.

Filter by ad type. Use 'ALL' for all ads or 'POLITICAL_AND_ISSUE_ADS' for political ads only. Defaults to 'ALL' when search is provided.

One or more Facebook Ads Library URLs to scrape directly (e.g. a pre-filtered search or advertiser page URL). Use instead of search.

Maximum number of ads to return (1–200). Defaults to 20.

import requests

url = "https://api.coldiq.com/v1/meta-ads/search"

headers = {
    "Authorization": "Bearer ",
    "Content-Type": "application/json"
}

response = requests.post(url, headers=headers)
print(response.json())