LinkedIn
LinkedIn search ads API
Search ads in the LinkedIn ad library. Call the LinkedIn search ads API and get JSON back in one request. 1 credit per call. Failed calls cost nothing.
POST
Search ads in the LinkedIn ad library
Searches ads in the LinkedIn ad library.
Request
This method has no required parameters.Response
If successful, the response body contains the standard envelope.data.results[] contains the ads, each with its advertiser, text and images.
The following example is a real response, truncated: each list shows one item and long strings are cut.
For every field, see the response schema on this page.
Run dates, impressions and the paying entity are returned only by LinkedIn ad details, and only for ads shown in the EU. To retrieve them, set an EU country.
Optional parameters
Billing
Each successful request consumes 1 credit, regardless of the number of items returned. Requests that fail, or that return no items, are not billed.Pagination
Results are paginated. To retrieve the next page, pass the value ofdata.cursor as cursor in a subsequent request. A response that omits cursor is the last page.
Related methods
- LinkedIn ad details: Accepts
adUrl. Returns a LinkedIn ad’s details.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Maximum string length:
500Maximum string length:
500ISO 3166-1 alpha-2 country code, e.g. us. Any case is accepted.
Pattern:
^[A-Za-z]{2}$Available options:
month, year, all The cursor from the previous response. Send it as is.
Minimum string length:
1