linkedin-ad-library/
search

Use the LinkedIn Ad Library Search API to search public LinkedIn ads by company, company ID, or keyword with country and date filters, returning normalized advertiser, creative, delivery, destination, impression, and media fields.

LinkedIn Ad Library Search API

Company and keyword search
24-record pagination
Public ad disclosures
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 Search

LinkedIn Ad Library Search discovers retained public ad disclosures from a company name, exact company ID, keyword, or a combination of those inputs. Returned records normalize the available advertiser identity, creative text, source URL, delivery window, countries, impressions, format, destination, and media without treating absent disclosure fields as zero.

LinkedIn Ad Library Search API Features

  • Three discovery inputsSearch with a company name, keyword, exact LinkedIn company ID, or several of those fields in one request; at least one is required.
  • Country and date filtersNarrow the public index with two-letter country codes and an optional inclusive run-date range in YYYY-MM-DD format.
  • Normalized public ad recordsReturn stable ad identity, advertiser reference, creative text, detail URL, dates, markets, format, destination, impressions, and media when disclosed.
  • Bounded token paginationCollect 24 through 1,992 records per LinkedIn Ad Library Search API request, in multiples of 24, while SocQ follows new upstream pagination tokens until the limit or final usable page.
  • Search-to-detail workflowPass a returned /ad-library/detail/ URL to LinkedIn Ad Library Ad when one discovered record needs the available detail view.

LinkedIn Ad Library Search API Parameters

ParametersRequiredDescription
companyRequired (at least one)Company or advertiser name. At least one of company, keyword, or company_id is required.
keywordRequired (at least one)Text to match in the public ad search. Matching semantics come from the public source.
company_idRequired (at least one)Exact LinkedIn company ID used as a search input.
countriesOptionalOptional list of two-letter alphabetic country codes, preferably uppercase, such as US and CA.
start_dateOptionalOptional beginning of the public run-date filter in YYYY-MM-DD format.
end_dateOptionalOptional end of the public run-date filter in YYYY-MM-DD format; it cannot precede start_date.
results_limitOptionalMaximum records requested. Defaults to 24 and accepts multiples of 24 from 24 through 1,992.

How to Use the LinkedIn Ad Library Search API

Choose at least one discovery field for the LinkedIn Ad Library Search API, add only the filters that define your sample, and read the completed asynchronous task pages.

  1. Provide company, keyword, or company_id; combine them only when that narrower source-defined match is intended.
  2. Optionally add two-letter countries, a valid date range, and a results_limit that is a multiple of 24.
  3. POST the request to /v1/linkedin-ad-library/search and save the returned task_id.
  4. Poll /v1/tasks/{task_id}, then read data.results.items and follow next_cursor while has_more is true.
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}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

LinkedIn Ad Library Search API Use Cases

  • Advertiser ad discovery: Use a company name or exact company ID to assemble observable public ads associated with an advertiser at collection time.
  • Message and theme research: Search keywords for products, competitors, or themes and compare the returned creative text, formats, media, and destinations.
  • Market and window comparison: Repeat the same LinkedIn Ad Library Search API query with controlled country and date filters to compare public disclosures across defined samples.
  • Detail candidate selection: Use returned ad IDs and detail URLs to select individual records for closer inspection with the separate detail operation.

LinkedIn Ad Library Search API Pro Tips

  • Start with one discovery field, then combine company, keyword, and company_id only when a narrower source-defined result set is useful.
  • Use uppercase country codes for consistent stored inputs even though the current validator accepts either letter case.
  • Choose results_limit in 24-record increments and treat it as a collection ceiling, not a promise that every slot has a match.
  • Preserve the query, filters, and collected_at time when comparing LinkedIn Ad Library Search API runs because public availability and retained records change.
  • Treat missing advertiser, dates, country, impression, destination, format, or media values as unavailable disclosure data rather than zero.

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

  • LinkedIn Ad Library Ad API — Retrieve one known public LinkedIn Ad Library record by exact detail URL with normalized advertiser, creative, delivery, destination, impression, and media fields.

Explore other platforms

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

LinkedIn Ad Library Search API — FAQ

LinkedIn Ad Library Search API is a programmatic interface for discovering retained public LinkedIn ad records from a company name, exact company ID, keyword, or a supported combination. It returns the available fields in SocQ's normalized ad shape.

Provide at least one of company, keyword, or company_id. You may submit several together, but the upstream public search controls their exact matching and intersection behavior.

The endpoint accepts a list of two-letter countries plus optional start_date and end_date values. It does not expose a public sort option.

A record can include ad and advertiser identity, public detail URL, creative text, start and end dates, countries, scalar impressions, format, placements, destination, media, and collection time when available.

No retained public ad may match the submitted discovery fields and filters at collection time. An empty result does not prove that the advertiser never ran ads.

The upstream source returns up to 24 ads per page. SocQ follows each new pagination token until results_limit, the final page, an empty page, a missing token, or a repeated token.

The LinkedIn Ad Library Search API charges 0.5 SocQ credits for each returned normalized ad. A successful task with no returned records has no result charge.