Ad search
Ads in LinkedIn's Ad Library, newest first, 24 a page: by advertiser (company or company_id) or by keyword, in the countries and dates given.
GET/v1/linkedin/ad-library/ads/search1 creditHeaders
Get your API keyx-api-key*stringrequiredheaderYour API key, made in the dashboard.
Parameters
7companystringoptionalqueryThe advertiser's name, as you'd type it.
max 100 chars · example: microsoft
keywordstringoptionalqueryWords in the ads.
max 100 chars
company_idstringoptionalqueryThe advertiser's company id.
countriesstringoptionalqueryOnly ads shown in these countries: two-letter codes, separated by commas (US,CA).
start_datestringoptionalqueryOnly ads shown from this day on (YYYY-MM-DD), within the last year. Give end_date with it.
end_datestringoptionalqueryOnly ads shown until this day (YYYY-MM-DD), yesterday at the latest. Give start_date with it.
cursorstringoptionalqueryFor the next page: page.next_cursor from the page before. Send the other parameters again with it.
max 1500 chars
Response fields
24dataarrayThe result: one object, or a list for the endpoints that return several.
data[].idstringnullableThe ad's id in LinkedIn's Ad Library: digits, written as text.
data[].urlstringnullableThe ad's page in the Ad Library.
data[].advertiserstringnullableThe advertiser's name.
data[].advertiser_urlstringnullableThe advertiser's LinkedIn page. Only the ad endpoint gives it.
data[].advertiser_logostringnullableThe advertiser's logo.
data[].formatstringnullableThe ad's format, as the Ad Library names it: Single Image Ad, Video Ad and so on.
data[].creative_typestringnullableLinkedIn's name for its kind: SPONSORED_STATUS_UPDATE, SPONSORED_VIDEO and so on.
data[].paid_bystringnullableWho paid for it, where the Ad Library shows it. Only the ad endpoint gives it.
data[].headlinestringnullableIts headline.
data[].textstringnullableIts text; in search results, its first lines.
data[].imagestringnullableIts image's link, or its video's thumbnail.
data[].video_urlstringnullableIts video's file (MP4). Only the ad endpoint gives it.
pageobjectnullablePaging, for the endpoints that page; null for the others.
page.next_cursorstringnullableSend it as the cursor parameter, with the same other parameters, for the next page. Null on the last page.
page.has_morebooleanoptionalWhether another page follows.
default: false
metaobjectAbout this call.
meta.platformstringThe platform: reddit, threads, tiktok or youtube.
meta.endpointstringThe endpoint's name, such as channel_videos.
meta.paramsobjectThe call's parameters, defaults included. Parameters without a value, and the cursor, are left out.
meta.request_idstringThis call's id. Quote it when you report a problem.
meta.api_versionstringThe API version that answered.
meta.fetched_atstringWhen the data was fetched from the platform (UTC).
format: date-time
meta.cachedbooleanoptionalWhether it came from our cache; fetched_at says how old it is.
default: false
Code example
curl -X GET 'https://api.socialparse.dev/v1/linkedin/ad-library/ads/search?company=microsoft' \ -H 'x-api-key: YOUR_API_KEY'Responses
Successful Response
{ "data": [ { "id": "string", "url": "string", "advertiser": "string", "advertiser_url": "string", "advertiser_logo": "string", "format": "string", "creative_type": "string", "paid_by": "string", "headline": "string", "text": "string", "image": "string", "video_url": "string" } ], "page": { "next_cursor": "string", "has_more": false }, "meta": { "platform": "string", "endpoint": "string", "params": { "property1": "string", "property2": "string" }, "request_id": "string", "api_version": "string", "fetched_at": "2019-08-24T14:15:22Z", "cached": false }}