meta

Meta Ad Library search

Search the ads running now in the Meta Ad Library (Facebook, Instagram and Meta's other apps) by keyword: advertiser, 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.

Preview: the returned object may change, announced beforehand.

get/v1/meta/ads/search

Request

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

Query parameters

querystring required

Search terms

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.