LinkedIn Ads API | PandorLabs

GET/v1/linkedin/ads/search

Search ads

1 request

Searches LinkedIn ads using a company name, a companyId, or a keyword, optionally filtered by country and date. A custom date range needs both startDate and endDate, and LinkedIn only allows dates from one year ago up to yesterday. Each ad has id, headline, description, adType, advertiser, targeting, totalImpressions, impressionsByCountry, and image or video URLs; date and impression fields are null when LinkedIn does not publish them. Paginate with paginationToken.

Query parameters

`company` string	Company name to search for, such as 'Microsoft'.
`keyword` string	Keyword to search for.
`companyId` string	LinkedIn company ID to search for.
`countries` string	Countries as a comma-separated list, such as US,CA,MX.
`startDate` string	Range start as YYYY-MM-DD; requires endDate and may not be more than one year back.
`endDate` string	Range end as YYYY-MM-DD; requires startDate and must be before today.
`paginationToken` string	Token from the previous response, used to load the next page.

curl "https://api.pandorlabs.com/v1/linkedin/ads/search" \  -H "Authorization: Bearer $PANDORLABS_KEY"

Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "ads": [
    {
      "id": "823975056",
      "description": "The countdown has begun – grab your discounted tickets now for #FabConEurope in Vienna!\nJoin us for an unforgettable experience filled with deep learning, expert insights, and top-tier networking opportunities.\n\nRegister today and be part o…",
      "headline": null,
      "poster": "Microsoft",
      "posterTitle": "Promoted",
      "promotedBy": null,
      "targeting": {
        "language": "Targeting includes English",
        "location": "Targeting includes Netherlands",
        "company": "Exclusion targeting applied"
      },
      "image": "https://media.licdn.com/dms/image/v2/D5610AQH8f223ANJdoQ/image-shrink_1280/B56ZiDa0MFHkAQ-/0/1754551502346?e=2147483647&v=beta&t=ZuZ0zUs1KInS8ysVO7FxzmlzxHP9B_JX2b6kdMU8GT4",
      "video": null,
      "carouselImages": [],
      "adType": "Single Image Ad",
      "advertiser": "Microsoft",
      "advertiserLinkedinPage": "https://www.linkedin.com/company/1035",
      "cta": null,
      "destinationUrl": "http://msft.it/6043sMFt3?trk=ad_library_ad_preview_headline_content",
      "adDuration": "Ran from Aug 10, 2025 to Aug 10, 2025",
      "startDate": "2025-08-10T05:00:00.000Z",
      "endDate": "2025-08-10T05:00:00.000Z",
      "totalImpressions": "< 1k",
      "impressionsByCountry": []
    }
  ],
  "paginationToken": "756412693-1754569518292",
  "isLastPage": false,
  "totalAds": 8699
}

GET/v1/linkedin/ad

Ad details

1 request

Returns one LinkedIn ad by URL: id, headline, description, adType, advertiser, and targeting covering language, location, and audience criteria, along with startDate, endDate, adDuration, totalImpressions, and impressionsByCountry. If the public ad page leaves out dates or impressions, those fields are null.

Query parameters

url

stringrequired

Link to the ad.

curl "https://api.pandorlabs.com/v1/linkedin/ad?url=https%3A%2F%2Fwww.linkedin.com%2Fad-library%2Fdetail%2F666281156" \  -H "Authorization: Bearer $PANDORLABS_KEY"

Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "id": "664291126",
  "description": "Learn to start building an AI strategy that helps your small business automate routine tasks and keep teams focused on high-value activities.",
  "headline": "Read “The Guide to AI for Small Businesses”",
  "poster": "Salesforce",
  "posterTitle": "Promoted",
  "promotedBy": null,
  "targeting": {
    "language": "Targeting includes English",
    "location": "Targeting includes Portugal",
    "audience": "Inclusion and exclusion targeting applied"
  },
  "image": "https://media.licdn.com/dms/image/v2/D5610AQHEjQAydHWLaw/image-shrink_1280/image-shrink_1280/0/1736950502005/Ai-guide-for-smbs?e=2147483647&v=beta&t=dC-iPz1fr8piN6YutdDgKIOmRPJvFaj4Hr0g_raHZ70",
  "adType": "Single Image Ad",
  "advertiser": "Salesforce",
  "advertiserLinkedinPage": "https://www.linkedin.com/company/3185",
  "cta": null,
  "destinationUrl": "https://www.salesforce.com/eu/form/small-business/ai-guide-for-smbs/?d=701ed00000CX0GfAAL&nc=701ed000007UYTMAA4&utm_source=linkedin&utm_medium=paid_social&utm_campaign=emea_pt_einsteinai_allindustries&utm_content=enterprisesmallbusiness_pp-…",
  "adDuration": "Ran from Apr 1, 2025 to Apr 3, 2025",
  "startDate": "2025-04-01T00:00:00.000Z",
  "endDate": "2025-04-03T00:00:00.000Z",
  "totalImpressions": "5k-10k",
  "impressionsByCountry": [
    {
      "country": "Portugal",
      "impressions": "100%"
    }
  ]
}

Search ads	`/v1/linkedin/ads/search`	1 request
Ad details	`/v1/linkedin/ad`	1 request