İçeriğe geç

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

AdTürAçıklama
companyisteğe bağlıstringReklamveren adı, örneğin `microsoft`. `company`, `keyword` veya `companyId` parametrelerinden en az biri zorunludur.
keywordisteğe bağlıstringReklamlarda aranacak metin. `company`, `keyword` veya `companyId` parametrelerinden en az biri zorunludur.
companyIdisteğe bağlıstringSayısal LinkedIn şirket id'si. `company`, `keyword` veya `companyId` parametrelerinden en az biri zorunludur.
countriesisteğe bağlıstringVirgülle ayrılmış iki harfli ülke kodları, örneğin `US,CA,MX`.
startDateisteğe bağlıstringTarih aralığının başlangıcı, `YYYY-MM-DD`. `endDate` ile birlikte verilmelidir.
endDateisteğe bağlıstringTarih aralığının sonu, `YYYY-MM-DD`. `startDate` ile birlikte verilmelidir.
paginationTokenisteğe bağlıstringSonraki 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.