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
| Parameters | Required | Description |
|---|---|---|
url | Required | Required 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.
- Copy one http or https LinkedIn Ad Library URL whose path contains /ad-library/detail/.
- POST url to /v1/linkedin-ad-library/ad and save the returned task_id.
- Poll /v1/tasks/{task_id} until the task succeeds or fails.
- 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 itemLinkedIn 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.
Related APIs
Beyond the LinkedIn Ad Library Ad API, use these APIs when you need a different type of public LinkedIn Ad Library data.
- LinkedIn Ad Library Search API — Search public LinkedIn ads by company, company ID, or keyword with country, date, and result-limit controls.