Meta Ads (Facebook & Instagram)
Meta Ads (Facebook & Instagram) · 54 endpoints
- Meta ad accounts you can accessList the Meta ad accounts you can access, with their names and currencies
- Campaigns in your Meta ad account — status, budgetList the campaigns in your Meta ad account with status, objective and budget
- Your Meta ads' spend, impressions, clicks, conversionsGet spend, impressions, clicks and conversions for your Meta ads
Advertiser ads
- Find a company's Facebook and Instagram adsReturn one page of Meta ads for a company or Facebook page.
- Facebook Company AdsList the Meta Ad Library ads a company is running by page ID or company name (creative text, format, platforms, and run dates) with cursor pagination.
- Meta Ad Library ads of one advertiserThe ads one Facebook page runs, as the Meta Ad Library shows them, one row per ad: dates, platforms, text, link, button, media, cards; spend and reach for political ads. `page` is the page id, its Ad Library or Facebook URL, a company name (Tolteck) or web domain (tolteck.com); a name or domain picks the page (1-2 more fetches); the warnings say which, or that none matched. `country` (ALL or two letters) and `active_status` (active or all), left empty, take an Ad Library URL's values, else ALL and active. No login. 2-8 s; refused: a residential exit, then a browser (20-45 s). Columns: ad_archive_id, ad_url, page_id, page_name, page_url, page_likes, is_active, start_date, end_date, platforms, display_format, title, body, link_url, link_caption, cta, cta_type, images, videos, cards, same_creative_ads, impressions, spend, currency, paid_for_by.
- Facebook ad library company ads by page id or nameFetches all ads currently running for a specific company from the Meta Ad Library.
- Ads a Facebook Page runs, by Page id — Meta ad libraryList every ad a specific Facebook Page is currently running
- meta-ads.library.advertiser — routed: best of 4 providers, own keys firstThe ads one Facebook page is running in the Meta Ad Library, by page id, company name, domain or Facebook URL — provider-native ad rows in `ads`
- EU ad reach and audience breakdown — Meta ad libraryGet the EU reach, audience breakdown and payer of ads delivered in Europe
- Political and issue ads with spend — Meta ad librarySearch political and issue ads and see who paid for them and roughly how much
Search ads
- Search Facebook and Instagram ads by keywordReturn one page of Meta Ad Library matches for a keyword.
- Scrape the Meta ad library by Page or search URLScrape publicly running Facebook and Instagram ads for a page or Ad Library search
- Meta Ad Library ads for a keywordThe ads the Meta Ad Library (Facebook, Instagram, Messenger) shows for a keyword search, one row per ad: advertiser page, dates, platforms, text, link, button, media, cards, and spend and impressions for political ads. `query` is the search text; `country` is ALL or two letters (US, GB, DE); `active_status` is active or all; `limit` up to 100. A view shows up to 30 ads; below `limit`, the recipe adds the search split by media type (4 more fetches, not in the Library's order). No login. 2-8 s; if Facebook refuses our address, a residential exit (3-10 s), then a browser: 20-45 s, up to 10 units. Columns: ad_archive_id, ad_url, page_id, page_name, page_url, page_likes, is_active, start_date, end_date, platforms, display_format, title, body, link_url, link_caption, cta, cta_type, images, videos, cards, same_creative_ads, impressions, spend, currency, paid_for_by.
- Search the Meta ad library by keywordSearch publicly running Facebook and Instagram ads by keyword
- Search Facebook ad library ads by keywordSearches the Meta Ad Library by keyword and returns matching ads.
Account and utility endpoints
- A company's Meta (Facebook/Instagram) ads by domainRetrieves Meta (Facebook/Instagram) advertisements for a specified company using their domain or name
- Ad accounts owned by a Business ManagerThe ad accounts a Business Manager owns
- Ad creatives in your Meta ad accountThe creatives — body, title, image/video, link and call-to-action
- Ad labels in your Meta ad accountLabels used to group campaigns, ad sets and ads
- Ad sets in your Meta ad account — budget, targetingEvery ad set in the account with budget, schedule, optimisation goal and targeting
- Ad sets inside one Meta campaignThe ad sets inside one campaign
- Ads inside one Meta ad setThe ads inside one ad set
- Ads inside one Meta campaignThe ads inside one campaign
- Automated rules on your Meta ad accountAutomated rules on the account — their conditions and actions
- Browse Meta's ad targeting taxonomy as a treeBrowse the targeting taxonomy as a tree
- Business Manager accounts for your Meta loginThe Business Manager accounts this login belongs to
- Change history of your Meta ad accountThe change log: who changed what on the account and when
- Create a Meta ad campaign — objective, statusCreate a campaign (objective, status, special ad categories)
- Create a Meta ad set — targeting, budget, scheduleCreate an ad set (targeting, budget, schedule, optimisation goal)
- Create an ad creative in your Meta ad accountCreate an ad creative
- Create an ad in a Meta ad set from a creativeCreate an ad from a creative inside an ad set
- Custom and lookalike audiences in your Meta ad accountCustom and lookalike audiences with approximate size and delivery status
- Custom conversions on your Meta ad accountCustom conversions defined on the account and their rules
- Estimate audience size for a Meta targeting specEstimated audience size for a targeting spec
- Estimate reach and bid for a Meta targeting specEstimated daily reach and bid range for a targeting spec, before you spend anything
- Every ad in your Meta ad account, with statusEvery ad in the account with its creative, status and effective review status
- Facebook ad library ad details by id or URLRetrieves detailed information about a specific Facebook ad by its ID or URL.
- Facebook ad library video ad transcript by id or URLRetrieves a transcript for a single Facebook Ad Library video ad by ID or URL.
- Images uploaded to your Meta ad accountImages uploaded to the ad account, with hash, dimensions and permalink
- Leads collected by one of your Meta lead adsThe leads a lead ad has collected
- Meta pixels on your ad account, with last fired timeMeta pixels on the account and when each last fired
- Meta targeting interests related to ones you targetInterests related to ones you already target
- One Meta ad set — targeting, budget, scheduleA single ad set — targeting, schedule, budget, optimisation goal and billing event
- One Meta ad — creative, status, review statusA single ad — its creative, status, tracking specs and review status
- One Meta campaign — objective, budget, statusA single campaign — objective, status, budget, bid strategy and spend cap
- Preview a Meta ad rendered in a placementA rendered preview of an ad in a given placement, as an iframe
- Search Facebook ad library companies by name — page idsSearches for companies by name in the Meta Ad Library and returns their page IDs for use with other ad library endpoints.
- Search Meta ad targeting options by keywordSearch Meta's targeting taxonomy (interests, behaviours, demographics) by keyword
- Update a Meta ad set — pause, budget, targetingUpdate an ad set — pause it, change budget, schedule or targeting
- Update a Meta ad — pause it or swap its creativeUpdate an ad — pause it or swap its creative
- Update a Meta campaign — pause, rename, budgetUpdate a campaign — pause it, rename it, change its budget
- Videos uploaded to your Meta ad accountVideos uploaded to the ad account
- Your Meta ad account — currency, spend cap, statusThe ad account itself — name, currency, timezone, spend cap, amount_spent, account_status
These endpoints are callable but not part of the catalog's browse surface.