Research competitor ads on LinkedIn with two REST calls. Search the LinkedIn Ad Library by company name, keyword or company ID, with optional country and date filters, then fetch the full details of one ad by URL. Each ad includes id, description, headline, adType, advertiser, targeting details, image or video URLs, totalImpressions and impressionsByCountry. Ad details add targeting by language, location and audience, plus adDuration, startDate and endDate.
| Endpoint | What it returns | Credits/call | USD/call (Freelance plan) |
|---|---|---|---|
/v1/linkedin/ad | Ad Details | 1 | $0.0017 |
/v1/linkedin/ads_search | Search Ads | 1 | $0.0017 |
/v1/linkedin/adAd Details 1,000 calls = 1,000 credits = $1.67 on the Freelance plan.
| Parameter | Type | Required | Description |
|---|---|---|---|
url | string | yes | The url of the ad |
Sample response (trimmed):
{
"id": "1629532086",
"description": "Offensive security for Insurance Brokers, TPAs, MGAs and Carriers.\n\nGet a full audit-grade NYDFS or SOC2 PDF report within 48 hours.",
"headline": "Meet us at Booth 3240",
"poster": "CodeAnt AI",
"targeting": {},
"image": null,
"video": "https://dms.licdn.com/playlist/vid/v2/D5610AQHhFKchr0EgUA/mp4-360p-30fp-crf28/B56aDdqz26GoCE-/0/1790425384702?e=2147483647&v=beta&t=JDvJ4pLmerMVdDjbUZskRZIeu...",
"pre_roll_video": null,
"organic_video": "https://dms.licdn.com/playlist/vid/v2/D5610AQHhFKchr0EgUA/mp4-360p-30fp-crf28/B56aDdqz26GoCE-/0/1790425384702?e=2147483647&v=beta&t=JDvJ4pLmerMVdDjbUZskRZIeu...",
"pre_roll_advertiser": null,
"carousel_images": [],
"url": "https://www.linkedin.com/ad-library/detail/1629532086",
"ad_type": "Video Ad",
"creative_type": "SPONSORED_VIDEO",
"advertiser": "CodeAnt AI",
"advertiser_linkedin_page": "https://www.linkedin.com/company/96582348",
"advertiser_logo": "https://media.licdn.com/dms/image/v2/D560BAQGncbvGj9h-YA/company-logo_100_100/company-logo_100_100/0/1700642866542/codeant_ai_logo?e=1793836800&v=beta&t=m3Yq...",
"cta": "Join",
"sponsored_message_sender": null,
"sponsored_message_sender_avatar": null,
"sponsored_message_buttons": [],
"destination_url": null,
"landing_page": null,
"ad_duration": "",
"start_date": null,
"...": "7 more fields"
}/v1/linkedin/ads_searchSearch Ads 1,000 calls = 1,000 credits = $1.67 on the Freelance plan.
| Parameter | Type | Required | Description |
|---|---|---|---|
company | string | no | The company name to search for. 'Microsoft' for example |
keyword | string | no | The keyword to search for |
company_id | string | no | The company id to search for |
countries | string | no | Comma separated list of countries. Example: US,CA,MX |
start_date | string | no | Start date in YYYY-MM-DD format. Must be used with endDate and cannot be earlier than the date one year ago. |
end_date | string | no | End date in YYYY-MM-DD format. Must be used with startDate and cannot be today or a future date. |
pagination_token | string | no | Pagination token to paginate through results |
curl -H "X-Scapi-Key: $SCAPI_KEY" "https://api.scrapall.bipsport.com/scapi/v1/linkedin/ad"import os, requests
r = requests.get("https://api.scrapall.bipsport.com/scapi/v1/linkedin/ad",
headers={"X-Scapi-Key": os.environ["SCAPI_KEY"]})
print(r.json())Call the ads search endpoint with company, keyword or company_id. Add countries to filter by country, and the optional date filters to limit results to a time range. Each ad in the results includes id, description, headline, adType, advertiser, targeting details, image or video URLs and totalImpressions.
Call the ad details endpoint with the url of the ad in the LinkedIn Ad Library. The response adds targeting by language, location and audience, plus adDuration, startDate and endDate, next to the ad text, advertiser and media URLs.
Yes, when LinkedIn shows it. Ads include totalImpressions and impressionsByCountry, so you can compare reach between ads of one advertiser or see in which countries a campaign was shown most.
Yes. Search results include targeting details, and the ad details endpoint breaks targeting down by language, location and audience as published in the LinkedIn Ad Library. This shows who a B2B advertiser wanted to reach.
Each ad includes its image or video URLs. Use them in your own workflow to save a swipe file of competitor creatives together with the headline, description and adType of each ad.
Open the Buy page, pick the Freelance plan and pay in USDT on TRC20 or ERC20. The key is shown once, right after the payment is confirmed on-chain.
The cost table on this page lists credits per call for each endpoint. The Freelance plan is $45 for 27,000 credits per 30 days.
Full reference: all linkedin endpoints.