Explore · Meta Ads

List (or batch-hydrate) Meta ads from your tracked advertisers

get/api/v1/explore/meta/ads

Request

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

Query parameters

advertiser_idstring

Filter to one advertiser (id token).

querystring

Free-text search across creative text.

activestring

true | false — active vs ended.

started_afterstring

Created on/after (ISO 8601).

updated_afterstring

Ingested on/after (ISO 8601).

format'video' | 'image'
sort'newest' | 'oldest' | 'reach_desc'
cursorstring

Opaque pagination cursor.

limitnumber
idsstring

Batch-hydrate ad id tokens (comma-separated, max 25). When set, filters/pagination are ignored.

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.

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"
  }
]

Changes

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