linkedin-ad-library/
ad

The LinkedIn Ad Library Ad API retrieves one public LinkedIn Ad Library record from its exact detail URL, returning normalized advertiser, creative, delivery, destination, impression, and media fields when disclosed.

LinkedIn Ad Library Ad API

Exact detail URL
Public ad disclosure
Nullable transparency fields
0.5 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

LinkedIn Ad Library Ad

LinkedIn Ad Library detail pages are time-bounded public disclosures for ads that ran on LinkedIn, with creative, advertiser, delivery, destination, impression, and media context when available. A collected record documents what was observable at that time and can become partial or unavailable as retention, restriction, or source conditions change.

LinkedIn Ad Library Ad API Features

  • Exact detail resolutionResolve one linkedin.com URL whose path contains /ad-library/detail/ into at most one normalized public ad record.
  • Creative and advertiser contextPreserve available ad identity, text, advertiser reference, format, destination, and media in the stable SocQ ad shape.
  • Public delivery disclosureThe LinkedIn Ad Library Ad API returns available first and latest dates, countries, placements, and a safely normalized scalar impression value without reconstructing private targeting.
  • Restricted-record safetyKeep unavailable advertiser, text, destination, impression, or media values nullable rather than inferring information withheld by the source.

LinkedIn Ad Library Ad API Parameters

ParametersRequiredDescription
urlRequiredRequired public LinkedIn Ad Library detail URL. The scheme must be http or https, the host must end with linkedin.com, and the path must contain /ad-library/detail/.

How to Use the LinkedIn Ad Library Ad API

Give the LinkedIn Ad Library Ad API one exact public detail URL, follow the asynchronous task, and read the normalized record when available.

  1. Copy one http or https LinkedIn Ad Library URL whose path contains /ad-library/detail/.
  2. POST url to /v1/linkedin-ad-library/ad and save the returned task_id.
  3. Poll /v1/tasks/{task_id} until the task succeeds or fails.
  4. Read data.results.items; the detail operation returns at most one record and does not broaden an unavailable URL into a search.
curl -X POST "https://api.socq.ai/v1/linkedin-ad-library/ad" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.linkedin.com/ad-library/detail/666281156"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items; this detail operation returns at most one item

LinkedIn Ad Library Ad API Use Cases

  • Enrich a discovered LinkedIn ad: Retrieve available creative, advertiser, delivery, destination, impression, and media fields for a known public detail URL.
  • Preserve a disclosure snapshot: Store the normalized LinkedIn Ad Library Ad API record and collected_at value before a time-bounded or restricted public entry changes or disappears.
  • Compare public creative evidence: Review messaging, format, assets, and disclosed delivery context across selected ads without treating the record as campaign-performance data.

LinkedIn Ad Library Ad API Pro Tips

  • Submit the complete detail URL rather than a bare ad ID, company page, search URL, or list of URLs.
  • Distinguish a succeeded task with no usable item from a provider failure; neither proves that the ad never existed.
  • Preserve nullable fields because restricted or expired records can intentionally omit advertiser, preview, payer, text, media, or delivery information.
  • Use LinkedIn Ad Library Search for discovery; this operation only resolves the exact submitted detail URL.

Beyond the LinkedIn Ad Library Ad API, use these APIs when you need a different type of public LinkedIn Ad Library data.

Explore other platforms

Combine LinkedIn Ad Library data with public data from other supported social platforms.

LinkedIn Ad Library Ad API — FAQ

LinkedIn Ad Library Ad API is a programmatic interface for retrieving one public LinkedIn Ad Library record from its exact detail URL. It returns normalized advertiser, creative, delivery, destination, impression, and media fields when the public record exposes them.

Submit one http or https URL on linkedin.com whose path contains /ad-library/detail/. Bare IDs, company pages, search URLs, and URL lists are not accepted.

The source may expose richer disclosures in some regions, but the stable contract does not promise payer identity, targeting rules, country-level impression breakdowns, calls to action, or restricted status.

The ad can be removed, expired under the public retention window, restricted, malformed at the source, or unavailable through the current provider. The operation does not substitute another ad.

The LinkedIn Ad Library Ad API charges 0.5 SocQ credits for each returned record. A successful empty result incurs only the configured zero-credit base charge.