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.

FieldTypeRequiredDescription
companystringone ofThe advertiser's name ("Zomato").
endDatestringnoLatest date, YYYY-MM-DD.
keywordstringone ofA word in the ad, instead of company.
companyIdstringone ofThe advertiser's LinkedIn company id, instead of company.
countriesstringnoComma-separated country codes to keep ("IN" or "IN,US").
startDatestringnoEarliest date the ad ran, YYYY-MM-DD.
paginationTokenstringnoThe 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 whenit fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0
Timeout30 s, then upstream_timeout (₹0, retryable)
Over MCPrun_tool with tool: "search_linkedin_ads"
Over RESTPOST https://api.parel.si/v1/run with "tool": "search_linkedin_ads"
Confirmationnot 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

This page as Markdown: /docs/tools/search_linkedin_ads.md. Something wrong or missing: hello@parel.si.