Fetch the active Facebook & Instagram (Meta) ads for a company by domain or Facebook page URL. Returns one page of ads p…
Authentication
No API key — create one in the dashboard
Body
Company website without protocol or www (e.g. 'coldiq.com'). Provide this or facebook_url.
Full Facebook page URL (must start with https://). Provide this or company_domain.
ISO country code to filter ads (e.g. 'US')
Filter ads by creative media type
Which ads to return (default: active). "all" returns active + inactive.
Detect user-generated-content style video ads. Requires media_type=video.
Pagination token from a previous response to fetch the next 30 ads.
import requests url = "https://api.coldiq.com/v1/adyntel/facebook" headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, headers=headers) print(response.json())