> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/search_linkedin_ads

# search_linkedin_ads

> Ads in the LinkedIn Ad Library by advertiser or keyword: creative, text, dates and countries, with paging. ₹0.28 per page; no ads is ₹0.

## What it does

Send the advertiser's `company` name (or a `keyword` in the ad, or the advertiser's `companyId`) and get `data.ads[]` with `headline`, `description`, `poster`, `paidForBy`, `image` or video, `targeting` and `url`, about 25 per page, plus `data.totalAds`, `data.isLastPage` and `data.paginationToken`. Narrow with `countries` (`"IN"`) and `startDate`, `endDate`.

Use it to see a competitor's LinkedIn messaging and how long each ad has run. For their Facebook and Instagram ads use [`get_meta_ads`](https://parel.si/docs/tools/get_meta_ads.md); for their organic LinkedIn posts, [`get_linkedin_company_posts`](https://parel.si/docs/tools/get_linkedin_company_posts.md).

India: filter with `countries: "IN"` to see what was shown to Indian members; in the live check a food-delivery company had 24 ads in the library for India.

## Inputs

Generated from the contract captured from staging on 2026-11-05.

| Field | Type | Required | Description |
|---|---|---|---|
| `company` | string | one of | The advertiser's name ("Zomato"). |
| `endDate` | string | no | Latest date, YYYY-MM-DD. |
| `keyword` | string | one of | A word in the ad, instead of company. |
| `companyId` | string | one of | The advertiser's LinkedIn company id, instead of company. |
| `countries` | string | no | Comma-separated country codes to keep ("IN" or "IN,US"). |
| `startDate` | string | no | Earliest date the ad ran, YYYY-MM-DD. |
| `paginationToken` | string | no | The token from the previous answer, for the next page. |

One of these sets must be complete (anything else is `invalid_input`, ₹0): `company`; `keyword`; `companyId`.

## What drives the cost

Nothing you can turn: flat per page. An advertiser with no ads, or a keyword nothing matches, answers an empty `ads` list, `class: "ok_free"`, ₹0 (the source charges for it; Parel absorbs that). Two to seven seconds; about 40 KB a page.

## Price today

| | |
|---|---|
| Price today | **₹0.28** per page (`cost_paise: 28`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.42 (`hold_paise: 42`); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): `class: "ok_free"`, ₹0 |
| Timeout | 30 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "search_linkedin_ads"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "search_linkedin_ads"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |

## Request

```bash
curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"search_linkedin_ads","input":{"company":"Zomato","countries":"IN"}}'
```

## What comes back

`data.ads[]`, `data.totalAds`, `data.isLastPage`, `data.paginationToken`. A real answer recorded during the live check of 2026-11-05 (24 ads in 6.8 s), trimmed to two:

```json
{
  "ads": [
    {
      "id": "1283387734",
      "headline": "Meals that keep up with teams",
      "description": "Manage everything seamlessly in one place — fast, reliable, simple and with no out-of-pocket spending",
      "poster": "Zomato",
      "paidForBy": "Eternal Limited",
      "image": "https://media.licdn.com/dms/image/v2/D4E10AQFlOBx0Di2ZsQ/image-shrink_1280/B4EZ3PJVaSJcAc-/0/1777296824228/1200x1200-1png",
      "url": "https://www.linkedin.com/ad-library/detail/1283387734"
    },
    {
      "id": "1326686604",
      "headline": "Well-fed teams work well",
      "description": "Order office meals seamlessly with zero employee spend and zero follow-ups",
      "poster": "Zomato",
      "paidForBy": "Eternal Limited",
      "image": "https://media.licdn.com/dms/image/v2/D4E10AQHM9h103y8uEw/image-shrink_1280/B4EZ6MTEuVGUAc-/0/1780470271199/Paper_TeamLunch",
      "url": "https://www.linkedin.com/ad-library/detail/1326686604"
    }
  ],
  "totalAds": 67,
  "isLastPage": false,
  "paginationToken": "1280591804-1776854570374"
}
```

## Notes

- Flat per page; pass paginationToken for the next page.
- An advertiser with no ads in the library, or a keyword nothing matches, answers an empty list, free.
- Dates are YYYY-MM-DD; countries are comma-separated ISO codes.

## Siblings

- [`get_meta_ads`](https://parel.si/docs/tools/get_meta_ads.md) for the same brand on Facebook and Instagram.
- [`get_linkedin_company_posts`](https://parel.si/docs/tools/get_linkedin_company_posts.md) for the organic posts.
