Built-in tool

Get LinkedIn Ad Library Ad Details

Retrieves detailed information about a specific LinkedIn ad by URL. Returns id, description, headline, adType, advertiser, and targeting with language, location, and audience criteria. Also includes totalImpressions, impressionsByCountry, adDuration, startDate, and endDate. Date and impression fields are nullable when LinkedIn does not expose them on the public ad page. The existing image, video, organicVideo, preRollVideo, and carouselImages fields keep their previous values. paidForBy is the public paying entity when LinkedIn shows one, without the 'Paid for by' prefix. targetingTable lists the public targeting-category flags that LinkedIn shows; it does not expand a collapsed location summary into individual locations. imageSources and thumbnailSources list the creative-image and video-poster URLs LinkedIn supplies. videoSources lists native video renditions as { src, type, bitrate }; preRollVideoSources uses the same structure but contains only pre-roll ad video. type and bitrate are null when absent; bitrate is in bits per second. Choose the lowest positive bitrate for a smaller video download, rather than assuming source order ranks quality. All four source fields are arrays and are empty when unavailable. Document-cover previews are included in imageSources where available, including search fallback results. LinkedIn may expose only one image or thumbnail resolution; URLs are signed and should not be rewritten to guess smaller sizes. Search detail hydration is best-effort, so blocked or timed-out detail fetches can leave videoSources empty even for a video ad. adDuration is the ad availability date-range text, not video playback duration; it is an empty string with null startDate/endDate when LinkedIn does not publish the availability block.

1 creditNo API key needed

Endpoint

Parameters

NameTypeRequiredNote
urlstring · requiredstringrequired

The url of the ad

Response schema

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "id": {
      "type": "string"
    },
    "cta": {
      "type": "string"
    },
    "url": {
      "type": "string"
    },
    "image": {},
    "video": {
      "type": "string"
    },
    "adType": {
      "type": "string"
    },
    "poster": {
      "type": "string"
    },
    "endDate": {},
    "headline": {
      "type": "string"
    },
    "startDate": {},
    "targeting": {
      "type": "object",
      "additionalProperties": {}
    },
    "adDuration": {
      "type": "string"
    },
    "advertiser": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "landingPage": {},
    "creativeType": {
      "type": "string"
    },
    "imageSources": {
      "type": "array"
    },
    "organicVideo": {
      "type": "string"
    },
    "preRollVideo": {},
    "videoSources": {
      "type": "array"
    },
    "advertiserLogo": {
      "type": "string"
    },
    "carouselImages": {
      "type": "array"
    },
    "destinationUrl": {},
    "thumbnailSources": {
      "type": "array"
    },
    "totalImpressions": {},
    "preRollAdvertiser": {},
    "preRollVideoSources": {
      "type": "array"
    },
    "impressionsByCountry": {
      "type": "array"
    },
    "advertiserLinkedinPage": {
      "type": "string"
    },
    "sponsoredMessageSender": {},
    "sponsoredMessageButtons": {
      "type": "array"
    },
    "sponsoredMessageSenderAvatar": {}
  },
  "additionalProperties": true
}

Get started

How to use this tool

  1. Connect your AI

    Add Connie to ChatGPT, Claude or Slack once, and this tool comes with it. There’s no API key or account to set up.

  2. Ask for the outcome

    Describe what you need in plain words. Your AI runs this tool when the job calls for it, along with any others it needs.

  3. Make it a workflow

    Add it as a step in a workflow that runs the same way every time, on a schedule or when something happens.

  4. Stay in control

    Choose whether it runs on its own or asks first. When it asks, you see an Allow or Deny card before any credits are spent.