meta

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.

get/v1/meta/advertisers/ads/list

Request

  • Base URL
    https://api.dataxapi.com
  • Auth
    HTTP bearer

Query parameters

idstring required

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)

regionstring

Only ads delivered in this country or region, by its two-letter code; all of them when left out

sort'popular' | 'latest'

By impressions, highest first, or newest first

type'image' | 'video'

Only image ads or only video ads; all of them when left out

cursorstring

The next_cursor of the previous page. A new page is a new call.

view'compact' | 'standard' | 'full'

How much of each item: compact (the most used fields, long text cut short), standard, or full (adds ext).

fieldsstring[]

Return only these fields of each item, by path (author.name).

Response

OK

code'ok' required
request_idstring uuid required

Changes

No recorded changes to this operation across all 1 revision of this API.