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; for their organic LinkedIn posts, get_linkedin_company_posts.
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
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:
{
"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_adsfor the same brand on Facebook and Instagram.get_linkedin_company_postsfor the organic posts.
This page as Markdown: /docs/tools/search_linkedin_ads.md. Something wrong or missing: hello@parel.si.