Skip to main content
POST
Get LinkedIn Ad Library Search

LinkedIn Ad Library Search

results_limit must be a multiple of the 24-record page size.

Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null.

Completed Task Response

Use with MCP and CLI

The endpoint uses the asynchronous task flow and returns a task_id. Poll the task endpoint to read normalized results.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
company
string
required
Minimum string length: 1
company_id
string
Minimum string length: 1
countries
string[]
Minimum array length: 1
Pattern: ^[A-Za-z]{2}$
end_date
string
Minimum string length: 1
keyword
string
Minimum string length: 1
results_limit
integer
default:24
Required range: 24 <= x <= 2000Must be a multiple of 24
start_date
string
Minimum string length: 1

Response

200 - application/json

Task accepted

code
integer
data
object