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())