/v1/linkedin/ad
Ad Details
Get ad details and native media variants where available. LinkedIn may expose only one image or thumbnail size.
| Credit cost | Default: 1 credit How charges are determinedCost is decided per call, not per endpoint: the same operation can cost different amounts depending on what it returns. A call that fails costs 0 credits. A result served from cache costs 0 credits. `default` is the cost when no rule matches. Rules are evaluated in order and the first whose conditions all hold wins. A `when` condition is one of: `param` (the request parameter is true), `outcome` (the classifier's outcome), `empty` / `nonEmpty` (a response field is empty and absent, or a non-empty array or string), `flag` (a response field is exactly true). A cost of `{ perStartedMinute: n, of: [fields] }` is n x max(1, ceil(seconds / 60)), so even a short result bills at least one minute. |
|---|---|
| Cache support | Not specified in the published contract. |
| Pagination | No explicit pagination metadata in the published contract. Consult the parameters and response fields below. |
Parameters
| Name | Location / required | Schema |
|---|---|---|
urlThe url of the ad | query / required |
|
Request examples
Replace placeholder values and supply your own API key. For operations with a request body, populate the body using the schema above.
cURL
curl --request GET 'https://api.fetchproof.com/v1/linkedin/ad?url=YOUR_URL' \
--header 'x-api-key: YOUR_API_KEY'JavaScript
const response = await fetch("https://api.fetchproof.com/v1/linkedin/ad?url=YOUR_URL", {
method: 'GET',
headers: { 'x-api-key': process.env.FETCHPROOF_API_KEY }
});
console.log(await response.text());Python
import os
import requests
response = requests.get("https://api.fetchproof.com/v1/linkedin/ad?url=YOUR_URL",
headers={"x-api-key": os.environ["FETCHPROOF_API_KEY"]})
print(response.text)Responses
200Success. Envelope: success / credits_remaining / credits_charged.
application/json
object
successrequired
boolean
credits_remainingrequired
integer
credits_chargedrequired
integer
idrequired
string
descriptionrequired
string
headlinerequired
string
posterrequired
string
targetingrequired
object
imagerequired
null
videorequired
string
preRollVideorequired
null
organicVideorequired
string
preRollAdvertiserrequired
null
carouselImagesrequired
array
urlrequired
string
adTyperequired
string
creativeTyperequired
string
advertiserrequired
string
advertiserLinkedinPagerequired
string
advertiserLogorequired
string
ctarequired
string
sponsoredMessageSenderrequired
null
sponsoredMessageSenderAvatarrequired
null
sponsoredMessageButtonsrequired
array
destinationUrlrequired
null
landingPagerequired
null
adDurationrequired
string
startDaterequired
null
endDaterequired
null
totalImpressionsrequired
null
impressionsByCountryrequired
array
imageSourcesrequired
array
videoSourcesrequired
array
Array items
object
srcrequired
string
typerequired
string
bitraterequired
integer
thumbnailSourcesrequired
array
Array items
string
preRollVideoSourcesrequired
array