---
title: "LinkedIn Ads Search"
method: GET
path: "/linkedin/ads/search"
tags: ["LinkedIn"]
---

# LinkedIn Ads Search

`GET /linkedin/ads/search`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/linkedin/ads/search`
- Auth: API key in header `X-API-KEY`

Search the public LinkedIn Ad Library. Pages beyond the first are additional
upstream lookups and the count actually performed is returned in the response.

## Query parameters

- `keyword` string, required
- `countries[]` string[]
- `dateOption` 'custom-date-range' | 'last-30-days' | 'null', nullable
- `startdate` string, date, nullable
- `enddate` string, date, nullable
- `accountOwner` string, nullable
- `pagination_token` string, nullable

## Response `200`

- string

## Other responses

- `401`: Unauthorized - API key is missing or invalid
- `403`: LinkedIn answered with a full-size page carrying no ads, which is how it refuses a blocked request. Retrying usually succeeds. Not billed, so this is never mistaken for a search that matched nothing.
- `404`: LinkedIn returned an Ad Library page with no ads, which means this search matched nothing or the pagination token reached the end of the result set. Not billed.
- `422`: The keyword parameter is missing, or a filter value is out of range.
- `503`: LinkedIn answered with a non-success status that is neither a refusal wall nor an empty result. Failed requests are never billed. Scrappa could not send this request to LinkedIn at all, so no data was retrieved. Please try again in a mom...

---

[API](https://skmtc.dev/scrappa/apis/scrappa-api-documentation.md) · [All operations](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/revisions/1e1aa78ff103?raw)