Explore · LinkedIn Ads

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

get/api/v1/explore/linkedin/ads

Request

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

Query parameters

advertiser_idstring

Filter to one advertiser (id token).

querystring

Free-text search across headline and commentary.

activestring

true | false — active vs ended.

started_afterstring

Started on/after (ISO 8601).

format'video' | 'image'
sort'newest' | 'oldest' | 'impressions_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
platform'linkedin' required
api_idstring required

LinkedIn Ad Library ad id.

is_activeboolean required

True for active or recently-active evidence. False covers both confirmed-inactive and unknown — read activity_status for the distinction.

activity_status'active' | 'recently_active' | 'inactive' | 'unknown' required

Activity evidence at the latest observation. recently_active means the ad was seen in the library within the last crawl window; unknown means no evidence either way (never inferred as inactive).

start_datestring nullable required
end_datestring nullable required

Campaign end date; null while running.

impressions_upper_boundnumber nullable required

EU impressions bracket upper bound (null for non-EU ads).

impressions_lower_boundnumber nullable required

EU impressions bracket lower bound (null for non-EU ads).

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

Headline, falling back to sponsored-post commentary.

thumbnail_urlstring nullable required

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

Example response

[
  {
    "gid": "gid://adsmom/linkedin/ad/0192f1c3-...",
    "id_token": "linkedin.ad.0192f1c3-...",
    "platform": "linkedin",
    "api_id": "4623456789",
    "advertiser": {
      "gid": "gid://adsmom/linkedin/advertiser/0192f1c3-...",
      "id_token": "linkedin.advertiser.0192f1c3-...",
      "name": "Microsoft"
    },
    "is_active": true,
    "activity_status": "active",
    "start_date": "2026-05-01"
  }
]

Changes

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