List Meta ads by page ID | Meta Ads API

Lists ads from the public Meta Ad Library for one advertiser, identified by required page_id. Filter by country, status, media type, dates, language, and platform. Use cursor to page; page_size is 1-50.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

page_id*string

Numeric advertiser Page ID, from a Search Pages result or Resolve Page ID.

Length1 <= length

country?string

ISO 3166-1 alpha-2 country code. Examples: IN, US, GB, DE.

Length2 <= length <= 2

active_status?string

Ad delivery status. all = active and inactive ads, active = currently running ads, inactive = stopped ads.

Value in

"all"
"active"
"inactive"

media_type?string

Creative format filter. all = every format, image = static images, video = videos, meme = image/text meme-style creatives.

Value in

"all"
"image"
"video"
"meme"

sort_mode?"total_impressions"

Sort by total impressions.

Value in

"total_impressions"

sort_direction?"desc"

Sort direction. Use with sort_mode.

Value in

"desc"

date_min?string

Start Date in YYYY-MM-DD format.

Match^\d{4}-\d{2}-\d{2}$

date_max?string

End Date in YYYY-MM-DD format.

Match^\d{4}-\d{2}-\d{2}$

cursor?string

Pass pageInfo.cursor from the previous response to get the next page. Omit for the first page.

page_size?integer

Number of ads to return per request. Accepted range: 1-50.

Range1 <= value <= 50

content_languages?string

Comma-separated ISO 639-1 language codes, for example en,hi.

publisher_platforms?string

Comma-separated platforms. Accepted values: FACEBOOK, INSTAGRAM, AUDIENCE_NETWORK, MESSENGER.

raw?boolean

Set to true to return the unprocessed Ad Library payload instead of the normalized response.

curl -X GET "https://example.com/v1/meta/page?page_id=102988293558" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "items": [      {        "ad_archive_id": "string",        "page_id": "string",        "property1": null,        "property2": null      }    ],    "pageInfo": {      "cursor": "string",      "hasNextPage": true    }  }}