Explore · Meta Ads

Get one Meta ad

get/api/v1/explore/meta/ads/{id_token}

Request

  • Base URL: https://api.adsmom.com
  • URL: https://api.adsmom.com/api/v1/explore/meta/ads/{id_token}
  • Auth: HTTP bearer

Path parameters

id_tokenstring required

Query parameters

includestring

Comma-separated heavy includes: full_targeting.

Response

gidstring required
id_tokenstring required
api_idstring required

Native Meta Ad Library archive ID.

platform'meta' required
is_activeboolean required
start_datestring nullable required
end_datestring nullable required

Delivery stop date; null while active.

reach_totalnumber nullable required

Lifetime breakdown reach from the Meta Ad Library.

format'video' | 'image' | 'unknown' required
headlinestring nullable required

First creative link title.

primary_textstring nullable required

First creative body (truncated).

thumbnail_urlstring nullable required

Signed, short-lived (~10 min). Fetch promptly or re-request.

bodiesstring[] required

All creative bodies.

link_titlesstring[] required

All creative link titles.

link_captionsstring[] required

All creative link captions.

link_descriptionsstring[] required

All creative link descriptions.

languagesstring[] required

Ad languages (ISO codes).

Example response

{
  "gid": "gid://adsmom/facebook/ad/0192f1c3-...",
  "id_token": "meta.ad.0192f1c3-...",
  "api_id": "1234567890123456789",
  "platform": "meta",
  "advertiser": {
    "gid": "gid://adsmom/facebook/advertiser/0192f1c3-...",
    "id_token": "meta.advertiser.0192f1c3-...",
    "name": "Kaufland"
  },
  "is_active": true,
  "start_date": "2026-05-01",
  "targeting": {
    "age_range": "25-54",
    "gender": "All"
  }
}

Changes

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