# LinkedIn Ads Search API (https://www.socialcrawl.dev/platforms/linkedin/ads-search)

> Searches the LinkedIn Ad Library for ads by company, keyword, or filters. Returns matching ads with ad copy and sponsor info.

TL;DR: `GET /v1/linkedin/ads/search` costs 5 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `company` | no | The company name to search for. 'Microsoft' for example |
| `keyword` | no | The keyword to search for |
| `companyId` | no | The company id to search for |
| `countries` | no | Comma separated list of countries. Example: US,CA,MX |
| `startDate` | no | Start date to search for. Format: YYYY-MM-DD |
| `endDate` | no | End date to search for. Format: YYYY-MM-DD |
| `paginationToken` | no | Pagination token to paginate through results |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/linkedin/ads/search" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I search the LinkedIn Ad Library with an API?

Send a GET request to /v1/linkedin/ads/search with any of these optional parameters: company, keyword, companyId, countries (comma-separated ISO codes), startDate (YYYY-MM-DD), endDate, or paginationToken. At least one filter is required.

### What filters can I use to narrow down LinkedIn ads?

Filter by company name, keyword in ad copy, LinkedIn company ID, comma-separated country list (e.g. US,CA,MX), start date, end date, and pagination token. Combine filters to surface exactly the ads you need for competitor research or creative audits.

### How do I paginate through LinkedIn ads search results?

The response includes a paginationToken field. Pass it back as the paginationToken query parameter on the next request to fetch the next page. Continue until the token is empty or absent, which signals the end of the result set.

### How much does the LinkedIn Ads Search API cost per request?

Each search request costs 5 credits on the advanced tier — regardless of how many ads come back in the page. With 100 free credits on sign-up, you can run 20 searches before you ever need to upgrade.

### Can I build a competitor ad alert system with this endpoint?

Yes, it's a common pattern. Poll /v1/linkedin/ads/search with a fixed company filter on a schedule (daily or hourly), diff against your last result, and trigger alerts on new ads. Pair with /v1/linkedin/ad to pull full creative detail on each new result.

### What date range does the LinkedIn Ad Library cover?

LinkedIn's Ad Library launched in 2023 and retains ads served since then. You can filter startDate and endDate within that range. Older campaigns that ran before the library launched are not available from LinkedIn itself, so they're not available here either.

See the full LinkedIn API: https://www.socialcrawl.dev/platforms/linkedin

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to search the LinkedIn Ad Library by company
- Best API to filter LinkedIn ads by keyword and country
- Build a LinkedIn competitor ad alert system with SocialCrawl