FastFetchz

LinkedIn Ad Library

Ad / Search

per_call

Returns LinkedIn ads with headline and body copy, creative images or video, advertiser company, targeting country, ad format, impressions range and run dates. The fastest way to see how competitors position themselves to a B2B buying committee.

What you get

Each call returns up to 24 ads, plus a cursor for the next 24.

Endpoint

GET /v1/linkedin-ad-library/ad-search

Price

$1.50

per 1,000 calls · $0.0015 per call

Cost per call

1 credit

Failed calls never charged

Parameters

target
required
string

The LinkedIn Ad Library handle, URL or identifier to resolve.

limit
optional
integer

Maximum records to return, capped at this service's page size (see Limits below). Omit it to receive the whole page. It shapes the response, not the price — a call costs the same either way.

cursor
optional
string

Pagination cursor returned by a previous response.

fresh
optional
enum

Bypass cached data and force a live fetch for this one call. Use it for daily monitoring or any figure you are tracking over time. Accepts `true`, `1`, `false` or `0`; anything else returns 400 `invalid_fresh`. Defaults to false and costs exactly the same as a cached call.

One of: true, 1, false, 0

Example request

Live call. Successful calls are charged; failed and empty results are not.

curl
curl "https://fastfetchz.com/v1/linkedin-ad-library/ad-search?target=nasa" \
  -H "X-API-Key: $FASTFETCHZ_KEY"

Example response

200 application/json
{
  "success": true,
  "service": {
    "platform": "LinkedIn Ad Library",
    "name": "Ad / Search",
    "slug": "ad-search"
  },
  "credits_charged": 1,
  "credits_remaining": 99,
  "latency_ms": 214,
  "data": {
    "ads": [
      {
        "id": "1521619003",
        "description": "Watch a #Microsoft MVP live-demo how to onboard users, create mailboxes & manage distribution lists in Exchange Online with #PowerShell.",
        "headline": "Automate Exchange Onboarding with PowerShell",
        "poster": "ScriptRunner - The #1 Microsoft Automation Platform",
        "posterTitle": "Promoted",
        "promotedBy": null,
        "targeting": {
          "language": "Targeting includes English",
          "location": "Targeting includes Germany, Switzerland and\n      \n        8 others\n      \n      Netherlands, Benelux, DACH, United States, Canada, Austria, Belgium, United Kingdom"
        },
        "image": "https://media.licdn.com/dms/image/v2/D4D10AQEWSbiRJyS1Rg/image-shrink_1280/B4DaBslHeQJcAc-/0/1788528065467/DamianScolesWebinar?e=2147483647&v=beta&t=iYooZ0YE1UOLNuuhBUSkIbOFw7-DKPJvKycN2plD614",
        "video": null,
        "preRollVideo": null,
        "organicVideo": null,
        "preRollAdvertiser": null,
        "carouselImages": [],
        "url": "https://www.linkedin.com/ad-library/detail/1521619003",
        "adType": "Single Image Ad",
        "creativeType": "SPONSORED_STATUS_UPDATE",
        "advertiser": "ScriptRunner - The #1 Microsoft Automation Platform",
        "advertiserLinkedinPage": "https://www.linkedin.com/company/16217038",
        "advertiserLogo": "https://media.licdn.com/dms/image/v2/C4D0BAQFYeG3JIAlUQg/company-logo_100_100/company-logo_100_100/0/1630544718632/scriptrunner_logo?e=1790208000&v=beta&t=vt57LYotRH9D98eWylbsA_HsotvmD35mY19dY1gPLYE",
        "cta": "Learn more",
        "sponsoredMessageSender": null,
        "sponsoredMessageSenderAvatar": null,
        "sponsoredMessageButtons": [],
        "destinationUrl": "https://scriptrunner.wistia.com/medias/g5jnpjdm4h/manage?utm_campaign=32735245-PowerHouse&utm_source=linkedin&utm_medium=paidsocial&utm_term=webinar&utm_content=damian%20scoles%20(ungated)&utm_id=916106903&hsa_acc=503112669&hsa_cam=916106903&hsa_grp=664607973&hsa_ad=1521636543&hsa_net=linkedin&hsa_ver=3&trk=ad_library_ad_preview_headline_content",
        "landingPage": "https://scriptrunner.wistia.com/medias/g5jnpjdm4h/manage?utm_campaign=32735245-PowerHouse&utm_source=linkedin&utm_medium=paidsocial&utm_term=webinar&utm_content=damian%20scoles%20(ungated)&utm_id=916106903&hsa_acc=503112669&hsa_cam=916106903&hsa_grp=664607973&hsa_ad=1521636543&hsa_net=linkedin&hsa_ver=3&trk=ad_library_ad_preview_headline_content",
        "adDuration": "Ran from Sep 4, 2026 to Sep 7, 2026",
        "startDate": "2026-09-04T00:00:00.000Z",
        "endDate": "2026-09-07T00:00:00.000Z",
        "totalImpressions": "< 1k",
        "impressionsByCountry": [
          {
            "country": "Canada",
            "impressions": "43%"
          },
          {
            "country": "United States",
            "impressions": "36%"
          }
        ]
      },
      {
        "id": "1521727443",
        "description": "DIY looks cheap upfront — until you count developer hours, maintenance, and troubleshooting. ScriptRunner lowers total cost of ownership with built-in scale and support.",
        "headline": "What's The Cost of DIY Below the Surface?\"",
        "poster": "ScriptRunner - The #1 Microsoft Automation Platform",
        "posterTitle": "Promoted",
        "promotedBy": null,
        "targeting": {
          "language": "Targeting includes English",
          "location": "Targeting includes Germany, Switzerland and\n      \n        9 others\n      \n      Netherlands, Benelux, DACH, United States, Canada, Austria, Luxembourg, Belgium, United Kingdom"
        },
        "image": "https://media.licdn.com/dms/image/v2/D4D10AQG4lf749D6T9g/image-shrink_1280/B4DaBsyw_WGkAc-/0/1788531642601/9png?e=2147483647&v=beta&t=tTcg0Y8PIyWWgeiTw9tzmqYYujMV-ozB1ik2gns-W9Q",
        "video": null,
        "preRollVideo": null,
        "organicVideo": null,
        "preRollAdvertiser": null,
        "carouselImages": [],
        "url": "https://www.linkedin.com/ad-library/detail/1521727443",
        "adType": "Single Image Ad",
        "creativeType": "SPONSORED_STATUS_UPDATE",
        "advertiser": "ScriptRunner - The #1 Microsoft Automation Platform",
        "advertiserLinkedinPage": "https://www.linkedin.com/company/16217038",
        "advertiserLogo": "https://media.licdn.com/dms/image/v2/C4D0BAQFYeG3JIAlUQg/company-logo_100_100/company-logo_100_100/0/1630544718632/scriptrunner_logo?e=1790208000&v=beta&t=vt57LYotRH9D98eWylbsA_HsotvmD35mY19dY1gPLYE",
        "cta": "Learn more",
        "sponsoredMessageSender": null,
        "sponsoredMessageSenderAvatar": null,
        "sponsoredMessageButtons": [],
        "destinationUrl": "https://www.scriptrunner.com/competitors/diy---do-it-yourself?utm_campaign=FrankenScript&utm_source=linkedin&utm_medium=paidsocial&utm_term=comparison%20page&utm_content=DIY&utm_id=1064911883&hsa_acc=503112669&hsa_cam=1064911883&hsa_grp=681610403&hsa_ad=1521727443&hsa_net=linkedin&hsa_ver=3&trk=ad_library_ad_preview_headline_content",
        "landingPage": "https://www.scriptrunner.com/competitors/diy---do-it-yourself?utm_campaign=FrankenScript&utm_source=linkedin&utm_medium=paidsocial&utm_term=comparison%20page&utm_content=DIY&utm_id=1064911883&hsa_acc=503112669&hsa_cam=1064911883&hsa_grp=681610403&hsa_ad=1521727443&hsa_net=linkedin&hsa_ver=3&trk=ad_library_ad_preview_headline_content",
        "adDuration": "Ran from Sep 4, 2026 to Sep 8, 2026",
        "startDate": "2026-09-04T00:00:00.000Z",
        "endDate": "2026-09-08T00:00:00.000Z",
        "totalImpressions": "< 1k",
        "impressionsByCountry": [
          {
            "country": "United States",
            "impressions": "32%"
          },
          {
            "country": "Canada",
            "impressions": "26%"
          }
        ]
      }
    ],
    "paginationToken": "1521735703-1788529757967",
    "isLastPage": false,
    "totalAds": 27111
  }
}

Getting more results

Each response includes a cursor. Pass it back as cursor to fetch the next 24 ads. Repeat until no cursor is returned.

two calls
# Call 1 — first 24 ads
curl "https://fastfetchz.com/v1/linkedin-ad-library/ad-search?target=nasa" \
  -H "X-API-Key: $FASTFETCHZ_KEY"
# -> { "data": { ... }, "cursor": "eyJwYWdlIjoyfQ" }

# Call 2 — next 24 ads
curl "https://fastfetchz.com/v1/linkedin-ad-library/ad-search?target=nasa&cursor=eyJwYWdlIjoyfQ" \
  -H "X-API-Key: $FASTFETCHZ_KEY"

Limits

  • Maximum per call: 24 ads.
  • Minimum per call: 1 ad — a target with less data returns fewer ads, and an empty result is still a successful call.
  • Each call fetches a full page of up to 24 and costs the same either way. Pass limit to receive fewer than that in the response.
  • Larger jobs are paginated with a cursor; there is no cap on how many pages you fetch.

What this costs in practice

240,000 ads = 10,000 calls × 1 credits per call = 10,000 credits = $0.00

Priced at the Custom pack rate: 1,000,000 credits for $0.00.

Open in the pricing calculator

Error codes

401invalid_api_keyMissing or unrecognized X-API-Key header. No credits are charged.
402insufficient_creditsYour balance is below the cost of the call. Top up to continue.
403account_suspended / key_revokedThe account is suspended or the key was revoked.
429rate_limitedOver your account's requests-per-second limit. Retrying helps: the body carries retry_after_seconds and the response carries a Retry-After header. Not charged.
429monthly_cap_reachedThis key used the monthly call cap you set for it. Retrying will not help — raise the cap, use another key, or wait for the next calendar month. No Retry-After header is sent. Not charged.
500upstream_errorUnexpected failure while fulfilling the request. Not charged.