--- title: "LinkedIn Ad Library Search API" method: GET path: "/v1/ad-library/linkedin/search-ads" tags: ["LinkedIn Ad Library"] --- # LinkedIn Ad Library Search API `GET /v1/ad-library/linkedin/search-ads` ## Request - Base URL: `https://api.captapi.com` - URL: `https://api.captapi.com/v1/ad-library/linkedin/search-ads` - Auth: one of: - HTTP bearer - API key in header `X-API-Key` LinkedIn publishes run dates, impressions and targeting only on a subset of creatives. LinkedIn publishes run dates, impressions and targeting only on a subset of Ad Library creatives — missing firstShown/impressions/targeting means the detail page has no Ran-from line, not a scrape miss. Search returns SERP cards (id, advertiser, copy, optional media). advertiser.location is null in practice: LinkedIn's Ad Library shows no advertiser location (the key stays for the shared ad-library schema). It does not hydrate 20 detail pages (that path was ~120s, at the request time limit). Use /linkedin/ad-details to hydrate About-the-ad fields when LinkedIn shows them; unpublished keys are omitted. Dates are YYYY-MM-DD; startDate/endDate alias firstShown/lastShown (one Ran-from range). Envelope source is native — flat 2 credits; when the Ad Library can't be read the call is 503, retryable, 0 credits. Filter with q (advertiser), keyword, companyId, country or countries, startDate/endDate. Page with cursor / paginationToken. Docs: https://captapi.com/apis/linkedin-ad-library-search-ads ## Query parameters - `q` string - `company` string - `keyword` string - `companyId` string - `country` string - `countries` string - `startDate` string - `endDate` string - `cursor` string - `paginationToken` string - `limit` integer - `cache` boolean ## Response `200` Success. The data object for this endpoint. - object - `success` unknown, required - `data` object, required - `query` string: The search query you sent. - `keyword` unknown - `companyId` unknown - `country` string: Country for the request context. On popular-creators top-level: ISO feed market you queried (e.g. US) — not each creator's home country (see region). - `countries` string[]: Countries (array). - `startDate` unknown - `endDate` unknown - `totalAds` integer: Total ads matching the LinkedIn Ad Library search criteria. - `totalReturned` integer: Number of items returned in this response. - `paginationToken` string: Opaque LinkedIn Ad Library pagination token for the next page. - `nextCursor` string: Cursor to pass for the next page of results. May be null when the platform does not expose deep pagination (e.g. some Facebook Ad Library searches). - `isLastPage` boolean: Whether LinkedIn reports this search page as the last page. - `hasMore` boolean: Whether more results are available beyond this page. When true, pass nextCursor to fetch the next page. - `platformNote` string: LinkedIn publishes run dates, impressions and targeting only on a subset of Ad Library creatives. Search returns the SERP card. Use /linkedin/ad-details to hydrate About-the-ad fields when LinkedIn shows them. - `ads` object[] - `platform` string: Platform identifier for this response (matches the endpoint's platform). - `id` string: Id of this ads item. - `url` string: Canonical URL of the item. - `text` string: Text content. - `cta` string: Call-to-action text. - `landingUrl` string: Landing page the ad links to. - `adFormat` unknown - `firstShown` string: Ran-from start as YYYY-MM-DD when LinkedIn publishes it. Alias of startDate. - `lastShown` string: Ran-from end as YYYY-MM-DD when LinkedIn publishes it. Alias of endDate. - `impressions` string: Estimated ad impressions. - `country` string: Country for the request context. On popular-creators top-level: ISO feed market you queried (e.g. US) — not each creator's home country (see region). - `advertiser` object: Advertiser running the ad. - `id` string: Id of this ads item. - `name` string - `url` string: Canonical URL of the item. - `logo` string - `media` unknown[]: Media attached to the item. - unknown - `description` string, nullable: Description of this ads item. - `destinationUrl` string, nullable: Click-through / landing URL from the ad creative when LinkedIn publishes one. - `adDuration` string, nullable: LinkedIn 'Ran from … to …' availability string. - `startDate` string, nullable: Alias of firstShown — LinkedIn publishes one Ran-from range. - `endDate` string, nullable: Alias of lastShown — LinkedIn publishes one Ran-from range. - `totalImpressions` string, nullable: Estimated total impressions band from LinkedIn Ad Library (e.g. 1k-5k). - `impressionsByCountry` object[]: Per-country impression share rows ({country, impressions}). - `country` string: Country for the request context. On popular-creators top-level: ISO feed market you queried (e.g. US) — not each creator's home country (see region). - `impressions` string: Estimated ad impressions. - `targeting` object, nullable: LinkedIn Ad Library targeting segments (language, location, company, and related keys). - `language` string - `location` string - `carouselImages` unknown[]: Ordered carousel creative image URLs when the ad is a carousel. - unknown - `paidForBy` string, nullable: Payer entity string from LinkedIn's 'Paid for by' line. - `countries` string[]: Countries (array). - `headline` string - `source` unknown ## Other responses - `400`: Bad request: wrong platform URL, unknown endpoint, or an invalid parameter value. Not billed. - `401`: Missing, invalid or revoked API key. Not billed. - `402`: Not enough credits for this request. Not billed. - `404`: The resource does not exist or is not public. Not billed. - `422`: A required parameter is missing or has the wrong type. Not billed. - `429`: Rate limit reached. Wait for Retry-After seconds. Not billed. - `502`: The platform could not be reached or returned nothing usable. Retryable, not billed. 503 and 504 use the same envelope. --- [API](https://skmtc.dev/captapi/apis/captapi-api.md) · [All operations](https://skmtc.dev/captapi/apis/captapi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/captapi/apis/captapi-api/revisions/c9b9ac5ff1bd?raw)