Ad Details

GET/v1/linkedin/ad1 credit

Returns one ad from LinkedIn's Ad Library: headline, text, creative (image, video or carousel), advertiser, call to action, destination, targeting, run dates and impressions by country.

01Query parameters

Name	Type	Description
urlrequired	string	The ad's Ad Library URL, e.g. `https://www.linkedin.com/ad-library/detail/1578061203`.

02Request

curl "https://api.scrapesocial.ai/v1/linkedin/ad?url=https%3A%2F%2Fwww.linkedin.com%2Fad-library%2Fdetail%2F1578061203" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/linkedin/ad?url=https%3A%2F%2Fwww.linkedin.com%2Fad-library%2Fdetail%2F1578061203

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "id": "1578061203",
  "description": "It runs. Nobody can fully explain, own or audit it. Answer 5 quick questions to see if your PowerShell automation has become a FrankenScript.",
  "headline": "Is your stack a FrankenScript? 🎃 Take the 5-question check",
  "poster": "ScriptRunner - The #1 Microsoft Automation Platform",
  "posterTitle": "Promoted",
  "promotedBy": null,
  "paidForBy": "ScriptRunner Software GmbH",
  "targeting": {
    "language": "Targeting includes English",
    "location": "Targeting includes Germany, Switzerland and 8 others Netherlands, Benelux, DACH, United States, Canada, Austria, Belgium, United Kingdom"
  },
  "targetingTable": [
    {
      "parameter": "Audience",
      "targeted": true,
      "excluded": false
    },
    {
      "parameter": "Demographic",
      "targeted": false,
      "excluded": false
    }
  ],
  "image": "https://media.licdn.com/dms/image/v2/D4D10AQERZVMkR8rdxQ/image-shrink_1280/B4DaE12LyTLAAc-/0/1791904759163/1png?e=2147483647&v=beta&t=4vMzsaH0aPPTVqQufFqdmzhzOlmGlWb6qjOrmLxLBvI",
  "video": null,
  "preRollVideo": null,
  "organicVideo": null,
  "preRollAdvertiser": null,
  "carouselImages": [],
  "url": "https://www.linkedin.com/ad-library/detail/1578061203",
  "adType": "Single Image Ad",
  "creativeType": "SPONSORED_STATUS_UPDATE",
  "advertiser": "ScriptRunner - The #1 Microsoft Automation Platform",
  "advertiserLinkedinPage": "https://www.linkedin.com/company/16217038",
  "advertiserLogo": "https://media.licdn.com/dms/image/v2/C4D0BAQFYeG3JIAlUQg/company-logo_100_100/company-logo_100_100/0/1630544718632/scriptrunner_logo?e=1794441600&v=beta&t=W7gdGk7TJrzVOYwzPZ60sl9RoT3moAHy_vJ57Al7RUg",
  "cta": "Learn more",
  "sponsoredMessageSender": null,
  "sponsoredMessageSenderAvatar": null,
  "sponsoredMessageButtons": [],
  "destinationUrl": "https://www.scriptrunner.com/resources/frankenscript?utm_campaign=FrankenScript&utm_source=linkedin&utm_medium=paidsocial&utm_term=landing%20page&utm_content=frankenscript&utm_id=1116803843&hsa_acc=503112669&hsa_cam=1116803843&hsa_grp=896177783&hsa_ad=1578061203&hsa_net=linkedin&hsa_ver=3&trk=ad_library_ad_preview_headline_content",
  "landingPage": "https://www.scriptrunner.com/resources/frankenscript?utm_campaign=FrankenScript&utm_source=linkedin&utm_medium=paidsocial&utm_term=landing%20page&utm_content=frankenscript&utm_id=1116803843&hsa_acc=503112669&hsa_cam=1116803843&hsa_grp=896177783&hsa_ad=1578061203&hsa_net=linkedin&hsa_ver=3&trk=ad_library_ad_preview_headline_content",
  "adDuration": "Ran from Oct 13, 2026 to Oct 20, 2026",
  "startDate": "2026-10-13T00:00:00.000Z",
  "endDate": "2026-10-20T00:00:00.000Z",
  "totalImpressions": "< 1k",
  "impressionsByCountry": [
    {
      "country": "United Kingdom",
      "impressions": "38%"
    },
    {
      "country": "Netherlands",
      "impressions": "18%"
    }
  ],
  "imageSources": [
    "https://media.licdn.com/dms/image/v2/D4D10AQERZVMkR8rdxQ/image-shrink_1280/B4DaE12LyTLAAc-/0/1791904759163/1png?e=2147483647&v=beta&t=4vMzsaH0aPPTVqQufFqdmzhzOlmGlWb6qjOrmLxLBvI"
  ],
  "videoSources": [],
  "thumbnailSources": [],
  "preRollVideoSources": []
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

`totalImpressions` is a range text such as `< 1k`, and `impressionsByCountry` lists each country's share. An unknown ad is a free 404 (`Ad not found`); a URL that is not an Ad Library detail URL is a free 400. LinkedIn's Ad Library blocks many network exits; when no exit gets through, the call is a free 503 (`upstream_error`): retry later.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.