Skip to main content
GET
/
v1
/
scrape
/
linkedin-ad-library
/
search
Search Ads
curl --request GET \
  --url https://api.sociavault.com/v1/scrape/linkedin-ad-library/search \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "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 of the future of innovation: http://msft.it/6043sMFt3 \n\n#MicrosoftFabric",
      "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": [
        "<any>"
      ],
      "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": [
        "<any>"
      ]
    }
  ],
  "paginationToken": "756412693-1754569518292",
  "isLastPage": false
}
💳 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

company
string

The company name to search for. 'Microsoft' for example

Example:

"microsoft"

keyword
string

The keyword to search for

Example:

"scraping"

countries
string

Comma separated list of countries. Example: US,CA,MX

Example:

"US,CA,MX"

startDate
string

Start date to search for. Format: YYYY-MM-DD

Example:

"2024-01-01"

endDate
string

End date to search for. Format: YYYY-MM-DD

Example:

"2024-01-10"

paginationToken
string

Pagination token to paginate through results

Example:

"640547184-1743616612000"

Response

Successful response

success
boolean
required
Example:

true

ads
object[]
required
paginationToken
string
required
Example:

"756412693-1754569518292"

isLastPage
boolean
required
Example:

false