LinkedIn Ad Library API
Discover public LinkedIn ads with structured search inputs, then retrieve selected disclosure records by exact detail URL for research, review, and archiving.
Available LinkedIn Ad Library APIs
Use Ad Search to discover public records by company, company ID, or keyword, and Ad Details to retrieve one known record from its exact public URL.
What LinkedIn Ad Library data can you retrieve?
SocQ normalizes public disclosure fields without presenting them as private campaign analytics; unavailable source values remain null or empty.
Ad and advertiser identity
Retrieve stable ad IDs, public detail URLs, advertiser IDs, names, company URLs, and logos when exposed.
Creative and destination context
Collect available ad text, formats, image or video assets, placements, and landing-page destinations.
Public delivery disclosures
Preserve source-provided run dates, countries, platforms, impressions, and collection times.
SocQ vs LinkedIn Campaign Manager
SocQ collects public Ad Library disclosures. Campaign Manager is LinkedIn's separate product for authorized advertisers managing their own campaigns.
| Capability | SocQ | LinkedIn Campaign Manager |
|---|---|---|
| Primary use | Discover and normalize public ad records | Create and manage authorized campaigns |
| Inputs | Company or keyword search, or one exact detail URL | Authorized account and campaign identifiers |
| Authentication | SocQ API key | LinkedIn account and advertising permissions |
| Output | Public disclosure fields | Private campaign configuration and reporting |
How the LinkedIn Ad Library APIs work
Both endpoints use SocQ's asynchronous submit, poll, and read workflow; Search can return multiple pages, while Ad Details returns at most one record.
1. Choose an endpoint
Submit a company, company ID, or keyword to Search, or one exact public Ad Library detail URL to Ad Details.
2. Submit and track the task
POST the request, save task_id, and poll /v1/tasks/{task_id} until processing finishes.
3. Read normalized records
Process data.results.items and follow next_cursor while has_more is true; a detail request returns zero or one item.
Authenticate with your SocQ API key. Search defaults to 24 results; Ad Details accepts one exact detail URL and does not paginate.
curl -X POST "https://api.socq.ai/v1/linkedin-ad-library/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"company":"Microsoft","countries":["US"],"results_limit":24}'
# Or retrieve one known record:
# POST /v1/linkedin-ad-library/ad
# {"url":"https://www.linkedin.com/ad-library/detail/666281156"}
# Poll GET /v1/tasks/{task_id}Common LinkedIn Ad Library API use cases
Competitor ad discovery
Find observable public ads associated with selected companies and preserve their disclosure context for review.
Creative review
Retrieve selected records and inspect available text, media, formats, destinations, advertisers, and run windows.
Public advertising datasets
Store normalized ad identity, advertiser, creative, delivery, source, and collection fields for analysis.
Limits and public-data policy
Results reflect the public index and record visibility available at collection time and are not private Campaign Manager data.
- Search requires at least one of company, keyword, or company_id; combined fields use the source's matching behavior.
- countries accepts two-letter codes, dates must form a valid range, and results_limit is a multiple of 24 from 24 through 1,992.
- A completed search can contain no items or repeated source rows; an unavailable detail URL can also return no record.
- Advertiser, creative, delivery, impression, destination, format, and media fields can be absent and must not be interpreted as zero.
LinkedIn Ad Library API frequently asked questions
What can I submit?
Search accepts a company name, company ID, keyword, or a supported combination. Ad Details accepts one exact public LinkedIn Ad Library detail URL.
Does this API return private campaign analytics?
No. It returns available public disclosures and does not expose Campaign Manager spend, clicks, conversions, targeting rules, or account data.
How many records can the endpoints return?
Search defaults to 24 and accepts multiples of 24 through 1,992. Ad Details returns zero or one record.
How are results priced?
Each returned ad record costs 0.5 credits. A successful task with no records has no result charge.
Combine data across platforms for more complete business insights
Bring public profiles, content, and engagement data from different platforms into one workflow to track brands, creators, and topics and run cross-platform monitoring and analysis more efficiently.
Reddit API
Retrieve public Reddit posts and comments from known URLs, browse new, top, or hot subreddit posts, or search discussions by keyword and publication window.
Rednote API
Retrieve public profiles and notes, search notes or users, collect comments and nested replies, and capture one home recommendation page.
Pinterest API
Retrieve public Pinterest profile data, resolve known Pins, collect Pins from selected profiles, or search by keyword for creator, content, and visual trend research.
Threads API
Retrieve public Threads profiles, resolve known posts, or collect posts from selected profiles with normalized identity, content, media, engagement, and timestamp fields.
Bluesky API
Retrieve public Bluesky profiles, resolve known post URLs, or collect one page of account posts with normalized identity, content, media, timestamps, and visible engagement fields.
Snapchat API
Retrieve a known public Snapchat Spotlight as a normalized record with available creator, caption, media, audio, timestamp, duration, and engagement fields.