Reklam Kütüphanesi Arama
GET/v1/linkedin/ads/search1 kredi
LinkedIn'in herkese açık Reklam Kütüphanesinde reklamveren, anahtar kelime veya şirket id'sine göre arama yapar; reklamları görselleri, reklamvereni, hedeflemesi, yayın tarihleri ve gösterimleriyle döndürür.
01Sorgu parametreleri
| Ad | Tür | Açıklama |
|---|---|---|
| companyisteğe bağlı | string | Reklamveren adı, örneğin `microsoft`. `company`, `keyword` veya `companyId` parametrelerinden en az biri zorunludur. |
| keywordisteğe bağlı | string | Reklamlarda aranacak metin. `company`, `keyword` veya `companyId` parametrelerinden en az biri zorunludur. |
| companyIdisteğe bağlı | string | Sayısal LinkedIn şirket id'si. `company`, `keyword` veya `companyId` parametrelerinden en az biri zorunludur. |
| countriesisteğe bağlı | string | Virgülle ayrılmış iki harfli ülke kodları, örneğin `US,CA,MX`. |
| startDateisteğe bağlı | string | Tarih aralığının başlangıcı, `YYYY-MM-DD`. `endDate` ile birlikte verilmelidir. |
| endDateisteğe bağlı | string | Tarih aralığının sonu, `YYYY-MM-DD`. `startDate` ile birlikte verilmelidir. |
| paginationTokenisteğe bağlı | string | Sonraki sayfayı almak için önceki yanıtın `paginationToken` değeri. |
02İstek
curl "https://api.scrapesocial.ai/v1/linkedin/ads/search?company=microsoft" \ -H "x-api-key: $SCRAPESOCIAL_KEY"
03Yanıtlar
API'nin gerçek yanıtları. Listeler 2 öğeye kısaltılmıştır.
GET /v1/linkedin/ads/search?company=microsoft
{
"success": true,
"credits_remaining": 4980,
"credits_charged": 1,
"ads": [
{
"id": "1658527466",
"description": "Real demos. Real results. Real people. Real ROI. #MicrosoftFrontierTour is a one day, in-person experience for leaders like you. Request to attend.",
"headline": null,
"poster": "Microsoft in Business",
"posterTitle": "Promoted",
"promotedBy": null,
"targeting": {},
"image": "https://media.licdn.com/dms/image/v2/D5610AQHoFff0Kyfyhg/image-pad_1200_1200/B4DaFqojGmJcAQ-/0/1792790377167?e=1793556000&v=beta&t=hpPX8RXq4GdTKZYZMk6ImNX5MGQ8cquKe5USyhV6xps",
"paidForBy": "Starcom Mediavest Group, Inc",
"targetingTable": [],
"video": null,
"preRollVideo": null,
"organicVideo": null,
"preRollAdvertiser": null,
"carouselImages": [
"https://media.licdn.com/dms/image/v2/D560BAQGfxIUgUdeVww/company-logo_100_100/B56ZgZynj1HQAQ-/0/1752779356692?e=1794441600&v=beta&t=bBUsTdPotSMRELuKplZoxINU0E82LfVzbR-grzoT0fo",
"https://media.licdn.com/dms/image/v2/D5610AQHoFff0Kyfyhg/image-pad_1200_1200/B4DaFqojGmJcAQ-/0/1792790377167?e=1793556000&v=beta&t=hpPX8RXq4GdTKZYZMk6ImNX5MGQ8cquKe5USyhV6xps"
],
"url": "https://www.linkedin.com/ad-library/detail/1658527466",
"adType": "Carousel Ad",
"creativeType": "SPONSORED_UPDATE_CAROUSEL",
"advertiser": "Microsoft in Business",
"advertiserLinkedinPage": "https://www.linkedin.com/company/107855954",
"advertiserLogo": "https://media.licdn.com/dms/image/v2/D560BAQGfxIUgUdeVww/company-logo_100_100/B56ZgZynj1HQAQ-/0/1752779356692?e=1794441600&v=beta&t=bBUsTdPotSMRELuKplZoxINU0E82LfVzbR-grzoT0fo",
"cta": null,
"sponsoredMessageSender": null,
"sponsoredMessageSenderAvatar": null,
"sponsoredMessageButtons": [],
"destinationUrl": null,
"landingPage": null,
"adDuration": "",
"startDate": null,
"endDate": null,
"totalImpressions": null,
"impressionsByCountry": [],
"imageSources": [
"https://media.licdn.com/dms/image/v2/D5610AQHoFff0Kyfyhg/image-pad_1200_1200/B4DaFqojGmJcAQ-/0/1792790377167?e=1793556000&v=beta&t=hpPX8RXq4GdTKZYZMk6ImNX5MGQ8cquKe5USyhV6xps",
"https://media.licdn.com/dms/image/v2/D5610AQGS7fdY0qJE2w/image-pad_1200_1200/B4DaFqojHAIwAU-/0/1792790377118?e=1793556000&v=beta&t=Yr4CgUoKbiF-gwyC_4iN4R4pjJGBScmzZxUqxSbxSXc"
],
"videoSources": [],
"thumbnailSources": [],
"preRollVideoSources": []
},
{
"id": "1593053133",
"description": "Ein KI-Agent für Deine Organisation. Nicht als Demo, sondern selbst gebaut. \n\nIm November laden wir Nonprofits gemeinsam mit Microsoft zu unserem 𝗢𝗻𝗹𝗶𝗻𝗲 𝗔𝗜 𝗔𝗴𝗲𝗻𝘁 𝗶𝗻 𝗮 𝗗𝗮𝘆 𝗪𝗼𝗿𝗸𝘀𝗵𝗼𝗽 ein. \n\nDu arbeitest hands-on an einem konkreten Use Case und baust selbst einen KI-Agenten. Zur Auswahl stehen der Spenden amp; Supporter Care Agent, der Recruiting amp; Onboarding Agent und der Service amp; FAQ Agent. \n…",
"headline": null,
"poster": "Kai Gutzeit",
"posterTitle": "AI Business Solutions for Service-Focused Organizations with the Microsoft AI Cloud Ecosystem | CEO & Founder @ INKUBIT",
"promotedBy": "Promoted by INKUBIT - Microsoft AI & Business Applications Partner",
"targeting": {
"language": "Targeting includes English",
"location": "Targeting includes Germany, Switzerland and 1 others Austria"
},
"image": "https://media.licdn.com/dms/image/v2/D4E22AQFsDzgdiPpmuw/feedshare-shrink_1280/B4EaFj4cj1JoAM-/0/1792677104162?e=2147483647&v=beta&t=chp9vSE2TRVbaFktfWllNQ4CoXmYmLwb4JD_nLi8yRI",
"paidForBy": "Inkubit Business Solutions GmbH",
"targetingTable": [
{
"parameter": "Audience",
"targeted": false,
"excluded": false
},
{
"parameter": "Demographic",
"targeted": false,
"excluded": false
}
],
"video": null,
"preRollVideo": null,
"organicVideo": null,
"preRollAdvertiser": null,
"carouselImages": [],
"url": "https://www.linkedin.com/ad-library/detail/1593053133",
"adType": "Single Image Ad",
"creativeType": "SPONSORED_STATUS_UPDATE",
"advertiser": "INKUBIT - Microsoft AI & Business Applications Partner",
"advertiserLinkedinPage": "https://www.linkedin.com/company/18224890",
"advertiserLogo": "https://media.licdn.com/dms/image/v2/D4E03AQEvOxQ70zjK5g/profile-displayphoto-scale_100_100/B4EZwS87vLJUAc-/0/1769844494556?e=1794441600&v=beta&t=KmbBuIB-ncTh1AiasQHKMtpKHZbPaM2_3CRQPpZ0KT4",
"cta": null,
"sponsoredMessageSender": null,
"sponsoredMessageSenderAvatar": null,
"sponsoredMessageButtons": [],
"destinationUrl": "https://lnkd.in/ej_faEwu?trk=ad_library_ad_preview_content_image",
"landingPage": "https://lnkd.in/ej_faEwu?trk=ad_library_ad_preview_content_image",
"adDuration": "Ran from Oct 23, 2026 to Oct 25, 2026",
"startDate": "2026-10-23T00:00:00.000Z",
"endDate": "2026-10-25T00:00:00.000Z",
"totalImpressions": "1k-5k",
"impressionsByCountry": [
{
"country": "Switzerland",
"impressions": "62%"
},
{
"country": "Austria",
"impressions": "20%"
}
],
"imageSources": [
"https://media.licdn.com/dms/image/v2/D4E22AQFsDzgdiPpmuw/feedshare-shrink_1280/B4EaFj4cj1JoAM-/0/1792677104162?e=2147483647&v=beta&t=chp9vSE2TRVbaFktfWllNQ4CoXmYmLwb4JD_nLi8yRI"
],
"videoSources": [],
"thumbnailSources": [],
"preRollVideoSources": []
}
],
"paginationToken": "1656981586-1792738734570",
"isLastPage": false,
"totalAds": 26520
}Tüm uç noktalarda ortak
Her rota bunları döndürebilir: eksik ya da hatalı anahtar, biten kredi, yanıt vermeyen platform ya da bizim tarafımızdaki bir hata. Hiçbiri kredi harcamaz.
GET /v1/cosmos/profile?handle=design
{
"success": false,
"message": "Invalid API key"
}04Notlar
Sayfa başına `ads` içinde en fazla 24 reklam, ayrıca `paginationToken` ve `isLastPage` döner; `totalAds` yalnızca ilk sayfada bulunur. Sonraki sayfa için `paginationToken` değerini aynı arama parametreleriyle geri gönderin; `isLastPage` true olana kadar devam edin. Reklamların çoğu tüm ayrıntılarıyla gelir; ayrıntısı okunamayan bir reklam daha kısa bir kart olarak döner. Eşleşen reklam yoksa 0 kredi karşılığında `ads: []` döner. Geçersiz `companyId`, `countries`, tarih veya token ücretsiz bir 400 döndürür. LinkedIn Reklam Kütüphanesi birçok ağ çıkışını engeller; hiçbir çıkış geçemediğinde çağrı ücretsiz bir 503 (`upstream_error`) olur: daha sonra tekrar deneyin.
05Hatalar ve krediler
Her hatada success: false ve gerçek bir HTTP durum kodu döner; kredi düşmez.
400missing_parameter
Zorunlu bir parametre eksik veya geçersiz.
403private_account
Hesap gizli ya da yaş kısıtlamalı.
404not_found
Böyle bir hesap yok.
503upstream_error
Platform şu an cevap vermiyor; tekrar deneyin.