Ad Library Search

GET/v1/linkedin/ads/search1 credit

Searches LinkedIn's public Ad Library by advertiser, keyword or company id and returns the ads with their creatives, advertiser, targeting, run dates and impressions.

01Query parameters

Name	Type	Description
companyoptional	string	Advertiser name, e.g. `microsoft`. At least one of `company`, `keyword` or `companyId` is required.
keywordoptional	string	Text to search in ads. At least one of `company`, `keyword` or `companyId` is required.
companyIdoptional	string	The numeric LinkedIn company id. At least one of `company`, `keyword` or `companyId` is required.
countriesoptional	string	Comma-separated two-letter country codes, e.g. `US,CA,MX`.
startDateoptional	string	Start of the date range, `YYYY-MM-DD`. Must be given together with `endDate`.
endDateoptional	string	End of the date range, `YYYY-MM-DD`. Must be given together with `startDate`.
paginationTokenoptional	string	The `paginationToken` of the previous answer, to fetch the next page.

02Request

curl "https://api.scrapesocial.ai/v1/linkedin/ads/search?company=microsoft" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/linkedin/ads/search?company=microsoft

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "ads": [
    {
      "id": "1658527466",
      "description": "Real demos. Real results. Real people. Real ROI. #MicrosoftFrontierTour is a one day, in-person experience for leaders like you. Request to attend.",
      "headline": null,
      "poster": "Microsoft in Business",
      "posterTitle": "Promoted",
      "promotedBy": null,
      "targeting": {},
      "image": "https://media.licdn.com/dms/image/v2/D5610AQHoFff0Kyfyhg/image-pad_1200_1200/B4DaFqojGmJcAQ-/0/1792790377167?e=1793556000&v=beta&t=hpPX8RXq4GdTKZYZMk6ImNX5MGQ8cquKe5USyhV6xps",
      "paidForBy": "Starcom Mediavest Group, Inc",
      "targetingTable": [],
      "video": null,
      "preRollVideo": null,
      "organicVideo": null,
      "preRollAdvertiser": null,
      "carouselImages": [
        "https://media.licdn.com/dms/image/v2/D560BAQGfxIUgUdeVww/company-logo_100_100/B56ZgZynj1HQAQ-/0/1752779356692?e=1794441600&v=beta&t=bBUsTdPotSMRELuKplZoxINU0E82LfVzbR-grzoT0fo",
        "https://media.licdn.com/dms/image/v2/D5610AQHoFff0Kyfyhg/image-pad_1200_1200/B4DaFqojGmJcAQ-/0/1792790377167?e=1793556000&v=beta&t=hpPX8RXq4GdTKZYZMk6ImNX5MGQ8cquKe5USyhV6xps"
      ],
      "url": "https://www.linkedin.com/ad-library/detail/1658527466",
      "adType": "Carousel Ad",
      "creativeType": "SPONSORED_UPDATE_CAROUSEL",
      "advertiser": "Microsoft in Business",
      "advertiserLinkedinPage": "https://www.linkedin.com/company/107855954",
      "advertiserLogo": "https://media.licdn.com/dms/image/v2/D560BAQGfxIUgUdeVww/company-logo_100_100/B56ZgZynj1HQAQ-/0/1752779356692?e=1794441600&v=beta&t=bBUsTdPotSMRELuKplZoxINU0E82LfVzbR-grzoT0fo",
      "cta": null,
      "sponsoredMessageSender": null,
      "sponsoredMessageSenderAvatar": null,
      "sponsoredMessageButtons": [],
      "destinationUrl": null,
      "landingPage": null,
      "adDuration": "",
      "startDate": null,
      "endDate": null,
      "totalImpressions": null,
      "impressionsByCountry": [],
      "imageSources": [
        "https://media.licdn.com/dms/image/v2/D5610AQHoFff0Kyfyhg/image-pad_1200_1200/B4DaFqojGmJcAQ-/0/1792790377167?e=1793556000&v=beta&t=hpPX8RXq4GdTKZYZMk6ImNX5MGQ8cquKe5USyhV6xps",
        "https://media.licdn.com/dms/image/v2/D5610AQGS7fdY0qJE2w/image-pad_1200_1200/B4DaFqojHAIwAU-/0/1792790377118?e=1793556000&v=beta&t=Yr4CgUoKbiF-gwyC_4iN4R4pjJGBScmzZxUqxSbxSXc"
      ],
      "videoSources": [],
      "thumbnailSources": [],
      "preRollVideoSources": []
    },
    {
      "id": "1593053133",
      "description": "Ein KI-Agent für Deine Organisation. Nicht als Demo, sondern selbst gebaut. \n\nIm November laden wir Nonprofits gemeinsam mit Microsoft zu unserem 𝗢𝗻𝗹𝗶𝗻𝗲 𝗔𝗜 𝗔𝗴𝗲𝗻𝘁 𝗶𝗻 𝗮 𝗗𝗮𝘆 𝗪𝗼𝗿𝗸𝘀𝗵𝗼𝗽 ein. \n\nDu arbeitest hands-on an einem konkreten Use Case und baust selbst einen KI-Agenten. Zur Auswahl stehen der Spenden amp; Supporter Care Agent, der Recruiting amp; Onboarding Agent und der Service amp; FAQ Agent. \n…",
      "headline": null,
      "poster": "Kai Gutzeit",
      "posterTitle": "AI Business Solutions for Service-Focused Organizations with the Microsoft AI Cloud Ecosystem | CEO & Founder @ INKUBIT",
      "promotedBy": "Promoted by INKUBIT - Microsoft AI & Business Applications Partner",
      "targeting": {
        "language": "Targeting includes English",
        "location": "Targeting includes Germany, Switzerland and 1 others Austria"
      },
      "image": "https://media.licdn.com/dms/image/v2/D4E22AQFsDzgdiPpmuw/feedshare-shrink_1280/B4EaFj4cj1JoAM-/0/1792677104162?e=2147483647&v=beta&t=chp9vSE2TRVbaFktfWllNQ4CoXmYmLwb4JD_nLi8yRI",
      "paidForBy": "Inkubit Business Solutions GmbH",
      "targetingTable": [
        {
          "parameter": "Audience",
          "targeted": false,
          "excluded": false
        },
        {
          "parameter": "Demographic",
          "targeted": false,
          "excluded": false
        }
      ],
      "video": null,
      "preRollVideo": null,
      "organicVideo": null,
      "preRollAdvertiser": null,
      "carouselImages": [],
      "url": "https://www.linkedin.com/ad-library/detail/1593053133",
      "adType": "Single Image Ad",
      "creativeType": "SPONSORED_STATUS_UPDATE",
      "advertiser": "INKUBIT - Microsoft AI & Business Applications Partner",
      "advertiserLinkedinPage": "https://www.linkedin.com/company/18224890",
      "advertiserLogo": "https://media.licdn.com/dms/image/v2/D4E03AQEvOxQ70zjK5g/profile-displayphoto-scale_100_100/B4EZwS87vLJUAc-/0/1769844494556?e=1794441600&v=beta&t=KmbBuIB-ncTh1AiasQHKMtpKHZbPaM2_3CRQPpZ0KT4",
      "cta": null,
      "sponsoredMessageSender": null,
      "sponsoredMessageSenderAvatar": null,
      "sponsoredMessageButtons": [],
      "destinationUrl": "https://lnkd.in/ej_faEwu?trk=ad_library_ad_preview_content_image",
      "landingPage": "https://lnkd.in/ej_faEwu?trk=ad_library_ad_preview_content_image",
      "adDuration": "Ran from Oct 23, 2026 to Oct 25, 2026",
      "startDate": "2026-10-23T00:00:00.000Z",
      "endDate": "2026-10-25T00:00:00.000Z",
      "totalImpressions": "1k-5k",
      "impressionsByCountry": [
        {
          "country": "Switzerland",
          "impressions": "62%"
        },
        {
          "country": "Austria",
          "impressions": "20%"
        }
      ],
      "imageSources": [
        "https://media.licdn.com/dms/image/v2/D4E22AQFsDzgdiPpmuw/feedshare-shrink_1280/B4EaFj4cj1JoAM-/0/1792677104162?e=2147483647&v=beta&t=chp9vSE2TRVbaFktfWllNQ4CoXmYmLwb4JD_nLi8yRI"
      ],
      "videoSources": [],
      "thumbnailSources": [],
      "preRollVideoSources": []
    }
  ],
  "paginationToken": "1656981586-1792738734570",
  "isLastPage": false,
  "totalAds": 26520
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

Up to 24 ads per page in `ads`, plus `paginationToken` and `isLastPage`; `totalAds` is on the first page only. Pass `paginationToken` back with the same search parameters for the next page until `isLastPage` is true. Most ads come with full details; when an ad's detail cannot be read, it comes as a shorter card. No matching ads returns `ads: []` for 0 credits. Invalid `companyId`, `countries`, dates or token are a free 400. LinkedIn's Ad Library blocks many network exits; when no exit gets through, the call is a free 503 (`upstream_error`): retry later.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.