Explore · LinkedIn Ads

Get one LinkedIn ad

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

Request

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

Path parameters

id_tokenstring required

Query parameters

includestring

Comma-separated heavy includes: full_targeting, transcript.

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.

headlinestring nullable required
commentarystring nullable required
cta_textstring nullable required
destination_urlstring nullable required
creative_typestring nullable required
ad_formatstring nullable required
payer_namestring nullable required

"Paid for by" entity from the ad detail page.

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",
  "country_impressions": [
    {
      "country": "Germany",
      "percent": 34
    }
  ],
  "targeting": {
    "segments": [
      {
        "category": "Location"
      }
    ],
    "parameters": [
      {
        "parameter": "Member skills"
      }
    ]
  }
}

Changes

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