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,
  "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-dm-all-crx-multi-tal-linkedin-prospect-tals-esmb_701ed00000CX0GfAAL_english_ai-guide-for-smbs&trk=ad_library_ad_preview_headline_content",
  "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%"
    }
  ]
}
💳 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

success
boolean
required
Example:

true

id
string
required
Example:

"664291126"

description
string
required
Example:

"Learn to start building an AI strategy that helps your small business automate routine tasks and keep teams focused on high-value activities."

headline
string
required
Example:

"Read “The Guide to AI for Small Businesses”"

poster
string
required
Example:

"Salesforce"

posterTitle
string
required
Example:

"Promoted"

targeting
object
required
image
string
required
Example:

"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
string
required
Example:

"Single Image Ad"

advertiser
string
required
Example:

"Salesforce"

advertiserLinkedinPage
string
required
Example:

"https://www.linkedin.com/company/3185"

destinationUrl
string
required
Example:

"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-dm-all-crx-multi-tal-linkedin-prospect-tals-esmb_701ed00000CX0GfAAL_english_ai-guide-for-smbs&trk=ad_library_ad_preview_headline_content"

adDuration
string
required
Example:

"Ran from Apr 1, 2025 to Apr 3, 2025"

startDate
string
required
Example:

"2025-04-01T00:00:00.000Z"

endDate
string
required
Example:

"2025-04-03T00:00:00.000Z"

totalImpressions
string
required
Example:

"5k-10k"

impressionsByCountry
object[]
required
promotedBy
null
cta
null