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.
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 disclosureReturn 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.
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
Submit one exact public LinkedIn Ad Library 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 itemBest 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 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.
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
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.