curl --request GET \
--url https://socialquery.dev/v1/linkedin/ad \
--header 'x-api-key: <api-key>'import requests
url = "https://socialquery.dev/v1/linkedin/ad"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://socialquery.dev/v1/linkedin/ad', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"data": {
"coverage_note": "<string>",
"post": {
"id": "<string>",
"url": "<string>",
"content": {
"text": "<string>",
"media_urls": [
"<string>"
],
"thumbnail_url": "<string>",
"duration_seconds": 1
},
"author": {
"username": "<string>",
"display_name": "<string>",
"avatar_url": "<string>",
"verified": true
},
"engagement": {
"views": 1,
"likes": 1,
"comments": 1,
"shares": 1,
"saves": 1
},
"flags": {
"nsfw": true,
"spoiler": true,
"pinned": true,
"deleted": true
},
"published_at": "<string>",
"ext": {
"id": "<string>",
"url": "<string>",
"description": "<string>",
"headline": "<string>",
"poster": "<string>",
"adType": "<string>",
"creativeType": "<string>",
"advertiser": "<string>",
"cta": "<string>",
"adDuration": "<string>",
"sponsoredMessageSender": "<string>",
"image": "<string>",
"video": "<string>",
"organicVideo": "<string>",
"preRollVideo": "<string>",
"advertiserLinkedinPage": "<string>",
"advertiserLogo": "<string>",
"destinationUrl": "<string>",
"landingPage": "<string>",
"sponsoredMessageSenderAvatar": "<string>",
"startDate": "<string>",
"endDate": "<string>",
"impressions_display": "<string>",
"totalImpressions": 1,
"carouselImages": [
"<string>"
],
"impressionsByCountry": [
{
"country": "<string>",
"impressions": "<string>"
}
]
}
},
"computed": {
"engagement_rate": null,
"language": null,
"content_category": null,
"estimated_reach": null
}
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}LinkedIn Ad
Public LinkedIn Ad Library detail. Campaign start date is exposed as published_at, not as a social-post publication timestamp. Impression ranges stay in post.ext.impressions_display; exact views remain null. Social reaction and comment counts are unavailable.
curl --request GET \
--url https://socialquery.dev/v1/linkedin/ad \
--header 'x-api-key: <api-key>'import requests
url = "https://socialquery.dev/v1/linkedin/ad"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://socialquery.dev/v1/linkedin/ad', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"data": {
"coverage_note": "<string>",
"post": {
"id": "<string>",
"url": "<string>",
"content": {
"text": "<string>",
"media_urls": [
"<string>"
],
"thumbnail_url": "<string>",
"duration_seconds": 1
},
"author": {
"username": "<string>",
"display_name": "<string>",
"avatar_url": "<string>",
"verified": true
},
"engagement": {
"views": 1,
"likes": 1,
"comments": 1,
"shares": 1,
"saves": 1
},
"flags": {
"nsfw": true,
"spoiler": true,
"pinned": true,
"deleted": true
},
"published_at": "<string>",
"ext": {
"id": "<string>",
"url": "<string>",
"description": "<string>",
"headline": "<string>",
"poster": "<string>",
"adType": "<string>",
"creativeType": "<string>",
"advertiser": "<string>",
"cta": "<string>",
"adDuration": "<string>",
"sponsoredMessageSender": "<string>",
"image": "<string>",
"video": "<string>",
"organicVideo": "<string>",
"preRollVideo": "<string>",
"advertiserLinkedinPage": "<string>",
"advertiserLogo": "<string>",
"destinationUrl": "<string>",
"landingPage": "<string>",
"sponsoredMessageSenderAvatar": "<string>",
"startDate": "<string>",
"endDate": "<string>",
"impressions_display": "<string>",
"totalImpressions": 1,
"carouselImages": [
"<string>"
],
"impressionsByCountry": [
{
"country": "<string>",
"impressions": "<string>"
}
]
}
},
"computed": {
"engagement_rate": null,
"language": null,
"content_category": null,
"estimated_reach": null
}
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}Authorizations
Headers
Optional nonnegative integer cap on the maximum request hold. A live request whose hold exceeds this cap returns 422 CREDIT_BUDGET_EXCEEDED before spending. Metered holds use the requested limit; cache hits and successful idempotent replays cost zero.
x >= 0Query Parameters
Response
Public LinkedIn Ad Library detail. Campaign start date is exposed as published_at, not as a social-post publication timestamp. Impression ranges stay in post.ext.impressions_display; exact views remain null. Social reaction and comment counts are unavailable.
x >= 0The selected operation determines the resource fields in this object. Source data can omit a metric or report it as null.
Show child attributes
Show child attributes