Skip to main content
GET
/
v1
/
scrape
/
linkedin-ad-library
/
ad-details
Ad Details
curl --request GET \
  --url https://api.sociavault.com/v1/scrape/linkedin-ad-library/ad-details \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "data": {
    "success": true,
    "id": "1174793313",
    "description": "Scraping at scale requires trust. IPRoyal proxies are built for reliable performance.",
    "headline": "IPRoyal - Reliable Proxies for Success",
    "poster": "IPRoyal",
    "posterTitle": "Promoted",
    "promotedBy": null,
    "targeting": {
      "language": "Targeting includes English",
      "location": "Targeting includes United States, Australia and\n      \n        2 others\n      \n      New Zealand, Europe\n  \n    Targeting excludes India, Egypt"
    },
    "image": "https://media.licdn.com/dms/image/v2/D4D10AQHMqLVjbh0VwQ/image-shrink_1280/B4DZqmsGvMKIAM-/0/1763733173685/01_DataScrapingBusinessIntelligence_1200x1200jpg?e=2147483647&v=beta&t=L2YlJTBCcA2HFvnTrMb13rhrwypTRiW848Xu4FzwOSk",
    "video": null,
    "carouselImages": {},
    "url": "https://www.linkedin.com/ad-library/detail/1174793313",
    "adType": "Single Image Ad",
    "advertiser": "IPRoyal",
    "advertiserLinkedinPage": "https://www.linkedin.com/company/71890168",
    "cta": "Request Demo",
    "destinationUrl": "https://iproyal.com/?utm_source=linkedin&utm_medium=cpc&utm_campaign=enterprise&utm_content=data_scraping_2&trk=ad_library_ad_preview_headline_content",
    "adDuration": "Ran from Feb 6, 2026 to Feb 8, 2026",
    "startDate": "2026-02-06T00:00:00.000Z",
    "endDate": "2026-02-08T00:00:00.000Z",
    "totalImpressions": "5k-10k",
    "impressionsByCountry": {}
  },
  "creditsUsed": 1
}
💳 1 credit per request

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx

Get your API key from the Dashboard.

Query Parameters

​
url
string
required

The url of the ad

Example:

"https://www.linkedin.com/ad-library/detail/666281156"

Response

Successful response

Key Response Fields:

  • id: Unique ad identifier
  • description: Full ad body text/copy
  • headline: Ad headline (may be null)
  • poster: Name of the company running the ad
  • adType: Ad format (e.g. Single Image Ad, Video Ad, Carousel Ad)
  • advertiser: Advertiser display name
  • advertiserLinkedinPage: URL to the advertiser's LinkedIn company page
  • image: URL of the ad's image asset (may be null)
  • video: Video asset details (may be null)
  • carouselImages: Object containing carousel image assets
  • cta: Call-to-action button text (e.g. Request Demo)
  • destinationUrl: Full landing page URL including UTM parameters
  • targeting.language: Audience language targeting description
  • targeting.location: Audience location targeting description
  • adDuration: Human-readable run period (e.g. Ran from Feb 6, 2026 to Feb 8, 2026)
  • startDate / endDate: ISO 8601 timestamps for ad run period
  • totalImpressions: Impression range string (e.g. 5k-10k) or null
  • impressionsByCountry: Per-country impression breakdown