Logo SearchApi

LinkedIn Ad Library Ad Details API

GET   /api/v1/search?engine=linkedin_ad_library_ad_details
OpenAPI Initiative Download OpenAPI Spec

Retrieves a single ad's detail page from LinkedIn's Ad Library. On top of the creative and advertiser returned by the LinkedIn Ad Library API, this engine returns the transparency data LinkedIn publishes only on the ad detail page: run dates, estimated impressions, impressions by country, and ad targeting.

LinkedIn publishes that transparency block for ads delivered in the EU only. For any other ad the response contains the creative and the "About the ad" fields, and first_shown_date, last_shown_date, total_impressions, impressions_by_country, targeting, and targeting_parameters are omitted. LinkedIn also states that impressions by country may take up to 48 hours to appear, so a recently launched ad can return total_impressions without a country breakdown.

API Parameters

Search Params

  • Name
    ad_id
    Required
    Required
    Description

    Specifies the ad's unique ID, for example 870198506. Obtain it from the id field on each ad returned by the LinkedIn Ad Library API whose link points at an /ad-library/detail/ page. Employer-brand ads link to a different page this engine cannot fetch.

Engine

  • Name
    engine
    Required
    Required
    Description

    Specifies the search engine. Must be set to linkedin_ad_library_ad_details.

API Key

  • Name
    api_key
    Required
    Required
    Description

    Your API key for authentication. Include it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Full response

Full response
GET
https://www.searchapi.io/api/v1/search?ad_id=870198506&engine=linkedin_ad_library_ad_details
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "linkedin_ad_library_ad_details",
  "ad_id": "870198506"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_ElUv756YZA7YqvnLAf3a8e3I",
    "status": "Success",
    "created_at": "2026-08-31T09:14:22Z",
    "request_time_taken": 1.84,
    "parsing_time_taken": 0.01,
    "total_time_taken": 1.85,
    "request_url": "https://www.linkedin.com/ad-library/detail/870198506",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_ElUv756YZA7YqvnLAf3a8e3I.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_ElUv756YZA7YqvnLAf3a8e3I"
  },
  "search_parameters": {
    "engine": "linkedin_ad_library_ad_details",
    "ad_id": "870198506"
  },
  "ad": {
    "id": "870198506",
    "link": "https://www.linkedin.com/ad-library/detail/870198506",
    "external_link": "https://adoptimizer.io/?trk=ad_library_ad_preview_content_image",
    "ad_type": "image",
    "ad_format": "Single Image Ad",
    "advertiser": {
      "name": "Google Ads Dream Machine",
      "thumbnail": "https://media.licdn.com/dms/image/v2/D560BAQGcJnXHWct8EA/company-logo_100_100/B56Zk8DYiEG4AQ-/0/1757649144750?e=1789603200&v=beta&t=1QpMWOL3DGNaBU_kKE-4baelQ51CsezMDzprf36wkTk",
      "link": "https://www.linkedin.com/company/108724112?trk=ad_library_about_ad_advertiser"
    },
    "content": {
      "headline": "Tired of guessing in Google Ads?\nAdOptimizer gives you:\n✅ Live ROI dashboard\n✅ Competitor keyword spy\n✅ AI ad copy & automation\n\n👉 Try it FREE for 7 days (no credit card).",
      "image": "https://media.licdn.com/dms/image/v2/D5610AQGVdoRnH34R9w/image-shrink_1280/B56Zk.XMdBG0AQ-/0/1757687893089/11111jpg?e=2147483647&v=beta&t=_qdbAy4o2hh09na-AlHig3lc9YtIOYUT3ZeWJ2RLZYs",
      "cta": "🚀 Run Google Ads Like a Pro – Free 7-Day Trial",
      "call_to_action": "Download"
    },
    "paid_for_by": "Brock K. Davis",
    "first_shown_date": "2025-09-12",
    "last_shown_date": "2025-09-13",
    "total_impressions": "20k-30k",
    "total_impressions_min": 20000,
    "total_impressions_max": 30000,
    "impressions_by_country": [
      {
        "country": "India",
        "percentage": 87,
        "percentage_display": "87%"
      },
      {
        "country": "United States",
        "percentage": 6,
        "percentage_display": "6%"
      },
      {
        "country": "Brazil",
        "percentage": 5,
        "percentage_display": "5%"
      },
      {
        "country": "Canada",
        "percentage_display": "< 1%"
      },
      {
        "country": "United Arab Emirates",
        "percentage_display": "< 1%"
      },
      ...
    ],
    "targeting": [
      {
        "name": "Language",
        "included": [
          "English"
        ]
      },
      {
        "name": "Location",
        "included": [
          "United States",
          "India",
          "Europe",
          "Brazil"
        ]
      }
    ],
    "targeting_parameters": [
      {
        "name": "Audience",
        "is_targeted": false,
        "is_excluded": false
      },
      {
        "name": "Demographic",
        "is_targeted": false,
        "is_excluded": false
      },
      {
        "name": "Company",
        "is_targeted": true,
        "is_excluded": true
      },
      {
        "name": "Education",
        "is_targeted": false,
        "is_excluded": false
      },
      {
        "name": "Job",
        "is_targeted": true,
        "is_excluded": false
      },
      {
        "name": "Member Interests and Traits",
        "is_targeted": true,
        "is_excluded": false
      }
    ]
  }
}

Response with targeting exclusions

Response with targeting exclusions
GET
https://www.searchapi.io/api/v1/search?ad_id=1515249973&engine=linkedin_ad_library_ad_details
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "linkedin_ad_library_ad_details",
  "ad_id": "1515249973"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_bppxMWjXx6lvMjPZklvsiO8C",
    "status": "Success",
    "created_at": "2026-08-31T09:14:22Z",
    "request_time_taken": 1.61,
    "parsing_time_taken": 0.01,
    "total_time_taken": 1.62,
    "request_url": "https://www.linkedin.com/ad-library/detail/1515249973",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_bppxMWjXx6lvMjPZklvsiO8C.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_bppxMWjXx6lvMjPZklvsiO8C"
  },
  "search_parameters": {
    "engine": "linkedin_ad_library_ad_details",
    "ad_id": "1515249973"
  },
  "ad": {
    "id": "1515249973",
    "link": "https://www.linkedin.com/ad-library/detail/1515249973",
    "external_link": "https://zenabm.com/mcp?utm_campaign=COLD+Text+%2526+Doc+ads+-+Sep+2026&utm_source=linkedin&utm_medium=paid&utm_id=1218423173&hsa_acc=515209751&hsa_cam=1218423173&hsa_grp=885554853&hsa_ad=1515249973&hsa_net=linkedin&hsa_ver=3",
    "ad_type": "text",
    "ad_format": "Spotlight Ad",
    "advertiser": {
      "name": "ZenABM",
      "thumbnail": "https://static.licdn.com/aero-v1/sc/h/9c8pery4andzj6ohjkjp54ma2",
      "link": "https://www.linkedin.com/company/105374409?trk=ad_library_about_ad_advertiser"
    },
    "content": {
      "headline": "🟢 H8 Manual Linkedyn ad reporting? 🤖",
      "call_to_action": "🔥 Try MCP FREE"
    },
    "paid_for_by": "Wisemont Language Services LIMITED",
    "first_shown_date": "2026-08-29",
    "last_shown_date": "2026-09-01",
    "total_impressions": "5k-10k",
    "total_impressions_min": 5000,
    "total_impressions_max": 10000,
    "targeting": [
      {
        "name": "Language",
        "included": [
          "English"
        ]
      },
      {
        "name": "Location",
        "included": [
          "APAC",
          "Australia and New Zealand",
          "North America",
          "EMEA",
          "Europe",
          "European Union"
        ],
        "excluded": [
          "Indonesia",
          "Malaysia",
          "Philippines",
          "Sri Lanka",
          "Pakistan",
          "Thailand",
          "Bangladesh",
          "India",
          "Africa",
          "Vietnam"
        ]
      }
    ],
    "targeting_parameters": [
      {
        "name": "Audience",
        "is_targeted": true,
        "is_excluded": true
      },
      {
        "name": "Demographic",
        "is_targeted": false,
        "is_excluded": false
      },
      {
        "name": "Company",
        "is_targeted": true,
        "is_excluded": true
      },
      {
        "name": "Education",
        "is_targeted": false,
        "is_excluded": false
      },
      {
        "name": "Job",
        "is_targeted": true,
        "is_excluded": true
      },
      {
        "name": "Member Interests and Traits",
        "is_targeted": false,
        "is_excluded": false
      }
    ]
  }
}

Response with carousel ad_type

Response with <code>carousel</code> ad_type
GET
https://www.searchapi.io/api/v1/search?ad_id=1534869944&engine=linkedin_ad_library_ad_details
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "linkedin_ad_library_ad_details",
  "ad_id": "1534869944"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_DzvbgrGzGIQIuTTwiU6lj3aZ",
    "status": "Success",
    "created_at": "2026-08-31T09:14:22Z",
    "request_time_taken": 1.73,
    "parsing_time_taken": 0.01,
    "total_time_taken": 1.74,
    "request_url": "https://www.linkedin.com/ad-library/detail/1534869944",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_DzvbgrGzGIQIuTTwiU6lj3aZ.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_DzvbgrGzGIQIuTTwiU6lj3aZ"
  },
  "search_parameters": {
    "engine": "linkedin_ad_library_ad_details",
    "ad_id": "1534869944"
  },
  "ad": {
    "id": "1534869944",
    "link": "https://www.linkedin.com/ad-library/detail/1534869944",
    "external_link": "https://stahltag.com/?trk=ad_library_ad_preview_carousel_item_image",
    "ad_type": "carousel",
    "ad_format": "Carousel Ad",
    "advertiser": {
      "name": "Matflixx die Rohstoffplattform",
      "thumbnail": "https://media.licdn.com/dms/image/v2/D4E0BAQG1XOotAuv0Iw/company-logo_100_100/company-logo_100_100/0/1665225049307/matflixx_logo?e=1789603200&v=beta&t=OAGAgDvvQOsmhstWVEFhRNkl5dPToqmI8a3ux9VxlnI",
      "link": "https://www.linkedin.com/company/88959794?trk=ad_library_about_ad_advertiser"
    },
    "content": {
      "headline": "Der Stahltag 2026 ist die Nr. 1 Konferenz für Ihren Stahleinkauf.\n\nWeil Sie im Einkauf, Handel oder in der Beschaffung Verantwortung tragen, liefern wir Ihnen das entscheidende Update für 2026. Denn wer die Marktlage kennt, trifft die besseren Entscheidungen.\n\nNutzen Sie vor Ort die Vorträge und die Talkrunde zu Melt and Pour, Stahlzölle, CBAM Marktlage und Energiekosten – kompakt und praxisnah von 15 Top-Referent:innen aus Industrie, Handel und Beratung.\n\nIm offenen Austausch profitieren Sie vom Netzwerk von über 600 Alumni.\nAm Abend erwartet Sie ein Get-Together, das seit 21 Jahren verbindet.\n\n📅 22.-23.09.2026 | 📍 Frankfurt am Main\n\n🎟️ Jetzt anmelden: www.stahltag.com",
      "headline_links": [
        "http://www.stahltag.com"
      ],
      "items": [
        {
          "image": "https://media.licdn.com/dms/image/v2/D4E10AQGFWNqDn4iu3Q/image-shrink_1080_1080/B4EaBPHthoIoAk-/0/1788033817019?e=1788836400&v=beta&t=0-UO93s_vJQldZH6f2Ye9JhGd0NI2vAny95nbLvQ7no",
          "cta": "Ticket sichern.",
          "link": "https://stahltag.com/?trk=ad_library_ad_preview_carousel_item_image"
        },
        {
          "image": "https://media.licdn.com/dms/image/v2/D4E10AQEcTsfMA5ablg/image-shrink_1080_1080/B4EaBPHvk3HYAo-/0/1788033825486?e=1788836400&v=beta&t=WiYBhIy0jCekVhWK-4hr4XHxapGE6PIbv0ks34Xrh5w",
          "cta": "Ticket sichern.",
          "link": "https://stahltag.com/?trk=ad_library_ad_preview_carousel_item_image"
        },
        {
          "image": "https://media.licdn.com/dms/image/v2/D4E10AQG8V3a98vI_MA/image-shrink_1080_1080/B4EaBPIAReHwAk-/0/1788033893887?e=1788836400&v=beta&t=LAAoqbp78TZ8Wvv9xfQs35luOaXdPRtVd9H_tsBq91U",
          "cta": "Ticket sichern.",
          "link": "https://stahltag.com/?trk=ad_library_ad_preview_carousel_item_image"
        },
        ...
      ]
    },
    "paid_for_by": "MBI Martin Brückner Infosource GmbH & Co. KG",
    "first_shown_date": "2026-08-29",
    "last_shown_date": "2026-09-01",
    "total_impressions": "1k-5k",
    "total_impressions_min": 1000,
    "total_impressions_max": 5000,
    "targeting": [
      {
        "name": "Language",
        "included": [
          "Deutsch"
        ]
      },
      {
        "name": "Location",
        "included": [
          "Deutschland"
        ]
      }
    ],
    "targeting_parameters": [
      {
        "name": "Audience",
        "is_targeted": false,
        "is_excluded": false
      },
      {
        "name": "Demographic",
        "is_targeted": false,
        "is_excluded": false
      },
      {
        "name": "Company",
        "is_targeted": false,
        "is_excluded": false
      },
      {
        "name": "Education",
        "is_targeted": false,
        "is_excluded": false
      },
      {
        "name": "Job",
        "is_targeted": true,
        "is_excluded": true
      },
      {
        "name": "Member Interests and Traits",
        "is_targeted": false,
        "is_excluded": false
      }
    ]
  }
}

Response for an ad served without the transparency block

Response for an ad served without the transparency block
GET
https://www.searchapi.io/api/v1/search?ad_id=1496580993&engine=linkedin_ad_library_ad_details
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "linkedin_ad_library_ad_details",
  "ad_id": "1496580993"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_rjs8DwcTU2c2kWJ6uJZ8w0cy",
    "status": "Success",
    "created_at": "2026-08-31T09:14:22Z",
    "request_time_taken": 1.42,
    "parsing_time_taken": 0.01,
    "total_time_taken": 1.43,
    "request_url": "https://www.linkedin.com/ad-library/detail/1496580993",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_rjs8DwcTU2c2kWJ6uJZ8w0cy.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_rjs8DwcTU2c2kWJ6uJZ8w0cy"
  },
  "search_parameters": {
    "engine": "linkedin_ad_library_ad_details",
    "ad_id": "1496580993"
  },
  "ad": {
    "id": "1496580993",
    "link": "https://www.linkedin.com/ad-library/detail/1496580993",
    "ad_type": "image",
    "ad_format": "Single Image Ad",
    "advertiser": {
      "name": "Pharma Clinical S.A.G (2003) Ltd.",
      "thumbnail": "https://media.licdn.com/dms/image/v2/C560BAQGHEouEBtDf6A/company-logo_100_100/company-logo_100_100/0/1630588003785/pharma_clinical_sag_2003_ltd_logo?e=1789603200&v=beta&t=sIPGVItF5YbvSEMsYtcr68KC0Oi4JDHnLa0SvYUE6DQ",
      "link": "https://www.linkedin.com/company/1777316?trk=ad_library_about_ad_advertiser"
    },
    "content": {
      "headline": "A question from a site takes three days and two inboxes to reach you. A contract amendment waits for sign-off from people who have never met the investigator. Feasibility answers arrive already filtered through someone who reports to someone else.\n\nThat is what a European study usually looks like when a global CRO subcontracts a local one: two project management teams on the same study, and an extra layer between you and the people doing the work.\n\nThere is a leaner way to run European sites.\n\nPharma Clinical works with an established network of independent, senior clinical trial specialists across Europe - regulatory, start-up, feasibility and monitoring, handled by people who already know the sites and the investigators.\n\nYou keep one point of contact in Israel. The same team that has run 300+ studies over 35 years.\n\nPlanning a multi-country study? Let's map it together.",
      "cta": "Planning a multi-country study? Let's map it together.",
      "image": "https://media.licdn.com/dms/image/v2/D4D10AQH6nqyCQWsNIw/image-shrink_1280/B4DaAu6RBcHcAc-/0/1787493421389/A3-now-1080x1080png?e=2147483647&v=beta&t=scuuNTw8UzCLKBy6y8eoYvP7CTjo4F5PKMmmQQ1oyWU",
      "call_to_action": "Learn more"
    },
    "paid_for_by": "Pharma Clinical"
  }
}