Search LinkedIn ads

When to use this

One page of Ad Library previews, up to about 24 ads. Pass company (advertiser name), keyword, or both. Search previews may truncate ad text; use ad details to inspect one creative and its disclosures. Each page costs one credit and does not fetch the individual ad detail pages. Pass paginationToken with the same filters for the next page. Country codes are comma-separated and run dates use YYYY-MM-DD. LinkedIn covers roughly the last year; delivery and targeting disclosures depend on the ad and region. A missing total on pagination pages is null. Block pages and malformed pagination metadata are upstream failures.

Parameters

All parameters go in the query string.

Example request

Replace YOUR_API_KEY with your key, or set LURKAPI_KEY for the code. Get a free key.

curl "https://api.lurkapi.com/v1/linkedin/ads/search?keyword=hubspot" \
  -H "x-api-key: YOUR_API_KEY"

const params = new URLSearchParams({
  keyword: "hubspot",
});
const res = await fetch(`https://api.lurkapi.com/v1/linkedin/ads/search?${params}`, {
  headers: { "x-api-key": process.env.LURKAPI_KEY },
});
const data = await res.json();
if (!data.success) throw new Error(`${data.code}: ${data.error}`);
console.log(data.ads);

import os
import requests

res = requests.get(
    "https://api.lurkapi.com/v1/linkedin/ads/search",
    params={
        "keyword": "hubspot",
    },
    headers={"x-api-key": os.environ["LURKAPI_KEY"]},
    timeout=60,
)
data = res.json()
if not data["success"]:
    raise RuntimeError(f"{data['code']}: {data['error']}")
print(data["ads"])

Example response

A real response from this endpoint, captured from the live API and trimmed to a couple of items. Strings over 96 characters (mostly signed media URLs) are cut short and end in ….

{
  "success": true,
  "credits_remaining": 999997,
  "credits_charged": 1,
  "ads": [
    {
      "id": "1629910236",
      "adLibraryUrl": "https://www.linkedin.com/ad-library/detail/1629910236",
      "advertiser": {
        "name": "SparkGrid Software",
        "url": null
      },
      "creativeType": "SPONSORED_STATUS_UPDATE",
      "format": "Single Image Ad",
      "text": "Keep sensitive files in Box while HubSpot workflows create folders, send…",
      "headline": "Governed Box document workflows, run from HubSpot.",
      "images": [
        "https://media.licdn.com/dms/image/v2/D5610AQEL3M7oKHGAzw/image-shrink_12…"
      ],
      "videos": [],
      "cta": null
    },
    {
      "id": "1578246174",
      "adLibraryUrl": "https://www.linkedin.com/ad-library/detail/1578246174",
      "advertiser": {
        "name": "Bill Stathopoulos",
        "url": null
      },
      "creativeType": "SPONSORED_STATUS_UPDATE",
      "format": "Single Image Ad",
      "text": "My team ran outbound campaigns on signals and got 53 positive replies fr…",
      "headline": null,
      "images": [
        "https://media.licdn.com/dms/image/v2/D4D22AQGvafUbekf-RQ/feedshare-shrin…"
      ],
      "videos": [],
      "cta": null
    }
  ],
  "total": 52399,
  "isLastPage": false,
  "paginationToken": "1578246174-1790604283338"
}

Response fields

Every field of a successful response. [] marks a list: a[].b is the b of each item in a. nullable fields can be null; optional fields can be missing.

Caching and freshness

Responses are cached for up to 1 hour, so a repeat call within that window can return the same data. It still costs 1 credit.

Errors

Errors return { success: false, error, code, docs } with the HTTP status below. Validation errors, 401/402/429 rejections and 5xx failures are free; not_found is charged (how charging works). All error codes.

Use it in Claude

Once LurkAPI is connected to Claude, this endpoint is the linkedin_search_ads tool. Ask in plain English, for example:

Use LurkAPI's linkedin_search_ads with keyword "hubspot" and summarize what you find.

Claude calls linkedin_search_ads with arguments like these, and each call costs 1 credit:

{
  "keyword": "hubspot"
}

Tool results skip nulls and empty lists to save tokens.