Meta Ads API: Get Meta ad details

Returns public metadata for one Meta ad, including its advertiser. Requires ad_archive_id and the advertiser page_id, both from a search or page-ads result. Optional country sets the region; raw returns the unprocessed payload.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

ad_archive_id*string

Ad archive ID, from the ad_archive_id field of a search or page-ads result.

Length1 <= length

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

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/ad-details?ad_archive_id=527778036512305&page_id=102988293558" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "advertiser": {      "page": {        "id": "string",        "property1": null,        "property2": null      },      "property1": null,      "property2": null    },    "property1": null,    "property2": null  }}