Meta advertiser's ads
Get the ads an advertiser (a Facebook page) is running now in the Meta Ad Library, by the page's ID: text, headline, images and videos, landing page, first and last day shown; can be limited to a country and to image or video ads, sorted by impressions or newest first. 30 ads a page.
Price: $0.002 per call.
30 items on a usual page, 30 at most. A cursor is valid for 3600 seconds.
An advertiser that does not exist cannot be told from one with no ads running: both return an empty result, not a 404.
Preview: the returned object may change, announced beforehand.
Request
- Base URLhttps://api.dataxapi.com
- AuthHTTP bearer
Query parameters
The advertiser's ID, the number its page goes by in the ad library, a string of digits; the Meta advertiser search finds it by name, and a Facebook page profile gives it as ext.ad_library_id (the profile's id is another number)
Only ads delivered in this country or region, by its two-letter code; all of them when left out
By impressions, highest first, or newest first
Only image ads or only video ads; all of them when left out
The next_cursor of the previous page. A new page is a new call.
How much of each item: compact (the most used fields, long text cut short), standard, or full (adds ext).
Return only these fields of each item, by path (author.name).
Response
OK
Changes
No recorded changes to this operation across all 1 revision of this API.