FeedMCP

Data APIs / LinkedIn

LinkedIn ad search API

Search the LinkedIn Ad Library by keyword or company: advertiser, copy, headline, images and videos, ad type and payer, 24 a page; filter by country.

Item Value
Endpoint GET https://api.feedmcp.com/v1/linkedin/ads/search
ID linkedin.ads.search
Price $0.002 / call
Returns A page of Ad objects
Auth Authorization: Bearer $FEEDMCP_API_KEY

24 a page. LinkedIn shows run dates and impressions only on some ads, mostly those shown in the EU.

Parameters

Name Type Required Description
keyword string one of Search keyword
company string one of Name of the company that advertises
country string no Only ads shown in these countries, two-letter codes separated by commas, such as US,CA
cursor string no Pagination cursor. Leave it out for the first page; pass page.next_cursor for the next. Each page is billed on its own

Every endpoint also takes view=full to include the platform's raw data as raw, at the same price.

Returned fields

data.items is a list of Ad objects, with the same fields on every platform:

Field Type Description
id string Ad ID, which the library's ad endpoint takes: the library ID on Meta, "AR…/CR…" on Google, a number on LinkedIn and TikTok
platform string Library: meta, google, linkedin or tiktok
url string | null Link to the ad in the library
advertiser.id string | null Advertiser ID: the Facebook page ID on Meta, the AR… ID on Google; pass it to that library's advertiser ads
advertiser.name string | null Advertiser name
format string | null Format, such as image, video, text, dpa (dynamic product ads) or Carousel Ad
headline string | null Headline
text string | null Body copy
cta string | null Call-to-action text, such as Shop now
landing_url string | null Landing page
images string[] Image URLs
videos string[] Video URLs
first_shown string | null First shown, ISO 8601, UTC
last_shown string | null Last shown (today for ads still running)
active boolean | null Still running (Meta only)
placements string[] Placements (Meta only): facebook, instagram, messenger, threads or audience_network
countries string[] Countries shown in, two-letter codes (when the library publishes them)
impressions {min, max} | null Impression range (when the library publishes it; reach range on TikTok)
paid_by string | null Who paid (LinkedIn, and political ads on Meta)

When you are charged

$0.002 per successful call, including an empty result (an empty search is still an answer). Bad parameters, platform errors and timeouts are free.

Each answer carries meta.billing: what this call cost and the balance left.

Request

cURL

curl "https://api.feedmcp.com/v1/linkedin/ads/search?company=Microsoft" \
  -H "Authorization: Bearer $FEEDMCP_API_KEY"

Python

import os, requests

r = requests.get(
    "https://api.feedmcp.com/v1/linkedin/ads/search",
    params={"company": "Microsoft"},
    headers={"Authorization": f"Bearer {os.environ['FEEDMCP_API_KEY']}"},
    timeout=30,
)
print(r.json())

JavaScript

const res = await fetch("https://api.feedmcp.com/v1/linkedin/ads/search?company=Microsoft", {
  headers: { Authorization: `Bearer ${process.env.FEEDMCP_API_KEY}` },
});
console.log(await res.json());

MCP

From an AI with FeedMCP installed, the call tool:

{
  "endpoint": "linkedin.ads.search",
  "params": {
    "company": "Microsoft"
  },
  "max_price": "0.002"
}

Response

The data below is made up; the shape is the real one.

{
  "code": "ok",
  "request_id": "req_7Qm2kXb9TzLp",
  "data": {
    "items": [
      {
        "id": "1691801521",
        "platform": "linkedin",
        "url": "https://www.linkedin.com/ad-library/detail/1691801521",
        "advertiser": {
          "id": "1035",
          "name": "Trail Outfitters",
          "avatar": "https://media.licdn.com/logo.png",
          "url": "https://www.linkedin.com/company/1035"
        },
        "format": "Single Image Ad",
        "headline": null,
        "text": "See what is new in our winter line 1",
        "cta": null,
        "landing_url": null,
        "images": [
          "https://media.licdn.com/ad.jpg"
        ],
        "videos": [],
        "first_shown": null,
        "last_shown": null,
        "active": null,
        "placements": [],
        "countries": [],
        "impressions": null,
        "paid_by": "Trail Outfitters"
      },
      {
        "id": "1691801522",
        "platform": "linkedin",
        "url": "https://www.linkedin.com/ad-library/detail/1691801522",
        "advertiser": {
          "id": "1035",
          "name": "Trail Outfitters",
          "avatar": "https://media.licdn.com/logo.png",
          "url": "https://www.linkedin.com/company/1035"
        },
        "format": "Single Image Ad",
        "headline": null,
        "text": "See what is new in our winter line 2",
        "cta": null,
        "landing_url": null,
        "images": [
          "https://media.licdn.com/ad.jpg"
        ],
        "videos": [],
        "first_shown": null,
        "last_shown": null,
        "active": null,
        "placements": [],
        "countries": [],
        "impressions": null,
        "paid_by": "Trail Outfitters"
      }
    ]
  },
  "page": {
    "next_cursor": "eyJjdXJzb3IiOjIwfQ",
    "has_more": true
  },
  "warnings": [],
  "meta": {
    "endpoint": "linkedin.ads.search",
    "platform": "linkedin",
    "fetched_at": "2026-11-19T08:00:00.000Z",
    "source": "FeedMCP",
    "catalog_revision": "d09a736bd39e8b3f",
    "billing": {
      "charged": true,
      "amount": "0.002",
      "currency": "USD",
      "balance": "9.98"
    }
  }
}

Errors are described in Errors: each says whether you were charged (charged) and whether to retry (retry).

Other LinkedIn endpoints

Questions

How much does the LinkedIn ad search endpoint cost?

$0.002 per successful call, including an empty result (an empty search is still an answer). Bad parameters, platform errors and timeouts are free.

Do I need a platform account?

No. Only public data is read.

A person is the part after /in/, a company the part after /company/; a post is its link or its activity number.

How do I get more items?

When the answer has page.next_cursor, pass it back as cursor for the next page. Each page is billed on its own.

How do I use it from an AI?

Install the MCP server and ask; your AI calls linkedin.ads.search.