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.

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

Items to return for list responses. Default 10, max 100.

cursor
optional
string

Pagination cursor returned by a previous response.

Example request

Sandbox calls return deterministic sample data in the live payload shape.

curl
curl "https://api.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": {
    "query": "nasa",
    "ads": [
      {
        "ad_id": "ad_172881",
        "advertiser": {
          "name": "Sandbox Advertiser 21",
          "page_id": "172881"
        },
        "creative": {
          "headline": "Try our product today",
          "body": "Sandbox ad copy.",
          "media_type": "video"
        },
        "first_seen": "2026-06-26T10:37:56.166Z",
        "last_seen": "2026-08-25T10:37:56.166Z",
        "platforms": [
          "feed",
          "stories"
        ],
        "estimated_impressions": {
          "lower": 10000,
          "upper": 50000
        }
      },
      {
        "ad_id": "ad_195262",
        "advertiser": {
          "name": "Sandbox Advertiser 22",
          "page_id": "195262"
        },
        "creative": {
          "headline": "Try our product today",
          "body": "Sandbox ad copy.",
          "media_type": "video"
        },
        "first_seen": "2026-06-25T10:37:56.166Z",
        "last_seen": "2026-08-24T10:37:56.166Z",
        "platforms": [
          "feed",
          "stories"
        ],
        "estimated_impressions": {
          "lower": 20000,
          "upper": 100000
        }
      }
    ]
  }
}

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_limitedThe key exceeded its monthly cap or the burst limit. Retry later.
500upstream_errorUnexpected failure while fulfilling the request. Not charged.