> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# LinkedIn-Werbebibliothek API

> Analysieren Sie die Anzeigen Ihrer Wettbewerber aus der LinkedIn-Werbebibliothek als JSON: Suchen Sie die Anzeigen nach Stichwort, Werbetreibendem oder Zahler und öffnen Sie eine Anzeige, um zu sehen, wer bezahlt hat, wie viele Impressionen sie erzielte und welche Länder sie erreichte, soweit die Bibliothek diese Daten veröffentlicht.

Lesen Sie die LinkedIn-Werbebibliothek über die asynchrone Task-API als JSON, um zu sehen, wofür Ihre Wettbewerber bei Fachleuten werben. ADS ist eine eigene Engine: Senden Sie `taskType` `ADS` mit `platform` `linkedin_ad_library`, und `action` wählt, was gelesen wird. Zur Auswahl zwischen den Werbebibliotheken siehe [Werbebibliotheken im Vergleich](https://docs.querying.ai/de/engines/ad-libraries.md).

* `search` (Standard) listet Anzeigen nach einem Stichwort in `query`, nach dem Namen eines Werbetreibenden in `advertiserName`, nach dem Zahler in `payer` oder nach einer Kombination auf. Jede Anzeige enthält ihren Werbetreibenden, ihr Format, ihren Titel, ihren Text und ihre Medien, und die Antwort endet mit einer `summary` der gelieferten Anzeigen.
* `ad` öffnet eine Anzeige: den Werbetreibenden, den Zahler, die Zielseite und, soweit die Bibliothek sie veröffentlicht, die Laufzeitdaten, die Impressionen, die erreichten Länder und das Targeting.

Die Bibliothek bietet keine Suche nach Werbetreibenden, daher wird `action` `advertisers` mit `400 VALIDATION_ERROR` abgelehnt. Finden Sie einen Wettbewerber mit `advertiserName` in einer Suche.

Eine Suche kostet **0.5 Credits je 30 Anzeigen**, die sie liefert. `ad` kostet 0.5 Credits.

## Anfrage

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "ADS", "payload": { "platform": "linkedin_ad_library", "query": "webinar", "country": "ALL", "limit": 30 } }'
```

Senden Sie den Task ab und fragen Sie dann `GET /v1/async/task/{id}` ab oder empfangen Sie den Webhook. Siehe [Asynchrone Tasks](https://docs.querying.ai/de/concepts/async-tasks.md). Die Bibliothek begrenzt die Lesegeschwindigkeit, daher dauert eine Suche nach 120 Anzeigen etwa eine halbe Minute.

## Anzeigen eines Wettbewerbers analysieren

Drei Anfragen decken eine Wettbewerbsanalyse ab:

1. `search` mit dem Namen des Wettbewerbers in `advertiserName` listet seine Anzeigen auf. `advertiserName` passt auf einen Teil eines Namens, prüfen Sie daher `advertiserName` bei jeder Anzeige. Ergänzen Sie `query`, um die Anzeigen auf ein Thema einzugrenzen, und `sortBy` `oldest`, um bei den ältesten Anzeigen zu beginnen.
2. `ad` mit der `libraryId` einer Anzeige liefert, wer bezahlt hat, die Zielseite und, bei in der EU ausgespielten Anzeigen, die Laufzeitdaten, die Impressionen und das Targeting.
3. `search` mit `payer` listet die Anzeigen auf, die eine Agentur oder ein Unternehmen bezahlt hat, unabhängig davon, welche Seite sie schaltet.

## Parameter

* `action`: `search` (Standard) oder `ad`.
* `query`: Ein Stichwort im Text der Anzeige. `search` braucht `query`, `advertiserName` oder `payer`.
* `advertiserName`: Ein Name, der auf einen Teil des Namens des Werbetreibenden passt, etwa `samsung`.
* `payer`: Der Name dessen, der die Anzeige bezahlt hat, passend auf einen Teil des Namens, etwa `Starcom`.
* `libraryId`: Die numerische ID einer Anzeige, etwa `1638962914`. `ad` verlangt sie.
* `country`: Wo die Anzeigen ausgespielt wurden, als zweistelliger Ländercode, oder `ALL` für alle Länder (Standard).
* `startDate`, `endDate`: `YYYY-MM-DD`, gemeinsam zu senden, innerhalb des letzten Jahres. Behält die Anzeigen, die zwischen den beiden Tagen ausgespielt wurden.
* `sortBy`: `newest` (Standard) oder `oldest`.
* `limit`: 1 bis 120 Anzeigen. Standard 30.
* `cursor`: Der `nextCursor` einer früheren Antwort, um die darauffolgenden Anzeigen zu lesen.

`search` liest alle Felder oben außer `libraryId`, und `ad` liest nur `libraryId`. Ein Filter der Meta-Werbebibliothek (`pageId`, `pageIds`, `activeStatus`, `searchType`, `adType`, `mediaType`, `publisherPlatforms` oder `contentLanguages`), ein Wert, den die Bibliothek nicht durchsuchen kann, oder ein Feld, das die Aktion nicht liest, wird mit `400 VALIDATION_ERROR` abgelehnt, und `details` nennt das Feld.

## Weitere Anzeigen lesen

Eine Antwort mit weiteren zu lesenden Anzeigen enthält `nextCursor`. Senden Sie ihn mit derselben Suche als `cursor`, um die nächsten Anzeigen zu erhalten, wieder bis zu `limit`. `nextCursor` ist `null`, sobald die Bibliothek keine weiteren hat. Ein Cursor funktioniert nur mit der Suche, die ihn geliefert hat: Eine andere `query`, `advertiserName`, `payer`, `country`, ein anderer Datumsbereich oder `sortBy` wird mit `400 VALIDATION_ERROR` abgelehnt, während sich `limit` ändern darf.

## Such-Antwort

```json theme={"theme":"css-variables"}
{
  "platform": "linkedin_ad_library",
  "action": "search",
  "country": "ALL",
  "query": "webinar",
  "totalCount": null,
  "returnedCount": 30,
  "hasMore": true,
  "nextCursor": "eyJ2IjoxLCJoIjoielVmY24wUlRHU0hSWHYwYSIsImMiOiIxNjk4Mjc2MTc2LTE3OTUyMTAzMTIxMzkiLCJzIjo2LCJwIjozMH0",
  "libraryUrl": "https://www.linkedin.com/ad-library/search?keyword=webinar&countries=ALL",
  "ads": [
    {
      "position": 1,
      "libraryId": "1698500736",
      "libraryUrl": "https://www.linkedin.com/ad-library/detail/1698500736",
      "advertiserId": null,
      "advertiserName": "Rescale",
      "isActive": null,
      "startDate": null,
      "endDate": null,
      "activeDays": null,
      "platforms": ["LINKEDIN"],
      "format": "IMAGE",
      "title": "How engineering teams get AI agents past the pilot",
      "body": "Most engineering teams have tried AI agents. Far fewer have moved them past the pilot. Watch Kairos Power and Oak Ridge …",
      "ctaText": null,
      "ctaType": null,
      "linkUrl": null,
      "landingDomain": null,
      "utm": null,
      "payer": null,
      "impressions": null,
      "targeting": null,
      "reachedCountries": null,
      "images": [
        "https://media.licdn.com/dms/image/v2/D5610AQFdah1Z0xeBuQ/image-shrink_1280/B56aH7HH6kH4AY-/0/1795214311284/Fall2026-Showcase_LinkedIn_6A_Webinar-on-demand_1200x1200png"
      ],
      "videos": [],
      "advertiserLogoUrl": "https://media.licdn.com/dms/image/v2/D560BAQFsh4MOa0Ohiw/company-logo_100_100/B56Z4dQLnEIQAQ-/0/1778607242071/rescale_logo",
      "advertiserType": null,
      "advertiserUrl": null,
      "bodyTruncated": true,
      "creativeType": "SPONSORED_STATUS_UPDATE"
    }
  ],
  "summary": {
    "ads": 30,
    "activeAds": 0,
    "advertisers": [
      { "advertiserName": "Rescale", "ads": 5 }
    ],
    "formats": { "ARTICLE": 1, "CAROUSEL": 1, "IMAGE": 24, "SPOTLIGHT": 2, "VIDEO": 2 },
    "platforms": { "LINKEDIN": 30 },
    "ctaTypes": {},
    "landingDomains": [],
    "utmCampaigns": [],
    "launchesByWeek": [],
    "longestRunning": [],
    "oldestStartDate": null,
    "newestStartDate": null,
    "medianActiveDays": null
  }
}
```

* Die Antwort gibt `platform`, `action`, `country`, `query`, `advertiserName`, `payer`, `sortBy` und die erhaltenen Daten zurück. `returnedCount` zählt die Anzeigen in `ads`, `hasMore` ist `true`, wenn die Bibliothek mehr hat, die `nextCursor` liest, und `libraryUrl` öffnet dieselbe Suche in der Werbebibliothek. `totalCount` ist `null`, weil die Bibliothek keine Anzahl liefert.
* Jede Anzeige ist eine Karte: `position`, `libraryId`, `libraryUrl`, `advertiserName`, `advertiserLogoUrl`, `creativeType` (etwa `SPONSORED_STATUS_UPDATE` oder `SPONSORED_VIDEO`), `format`, `title`, `body`, `images` und `videos` (das Posterbild des Videos in `previewUrl`) sowie `platforms` (`LINKEDIN`). `format` ist `IMAGE`, `VIDEO`, `CAROUSEL`, `DOCUMENT`, `ARTICLE`, `MESSAGE`, `JOB`, `SPOTLIGHT` oder `FOLLOW_COMPANY`.
* Nachrichtenanzeigen und Thought-Leader-Anzeigen enthalten `member`, den Absender der Nachricht oder das Mitglied, dessen Beitrag die Anzeige bewirbt, mit `name` und `url`; `ad` liefert es in derselben Form. Bei anderen Anzeigen ist `member` `null`.
* Eine Karte enthält die ersten 120 Zeichen des Textes, und `bodyTruncated` ist `true`, wenn der Text länger ist. `ad` liefert den vollständigen Text.
* `advertiserId`, `payer`, `startDate`, `endDate`, `activeDays`, `linkUrl`, `landingDomain`, `impressions`, `targeting`, `ctaText` und `utm` sind auf einer Karte `null`. `ad` füllt sie, wo die Bibliothek sie hat. `isActive` ist `null`, weil die Bibliothek nicht angibt, ob eine Anzeige noch läuft.
* `summary` zählt die Anzeigen dieser Antwort: `ads`, `advertisers` (die 10 mit den meisten Anzeigen: `advertiserName`, `ads`), `formats` und `platforms`. Die Datumsfelder (`oldestStartDate`, `newestStartDate`, `medianActiveDays`, `launchesByWeek` und `longestRunning`) bleiben leer oder `null`, weil Karten keine Daten enthalten.
* Eine Suche ohne passende Anzeigen endet mit leerem `ads` und einer `summary` mit `0` Anzeigen.

## Was die Bibliothek aufbewahrt

* Creative, Werbetreibender und Zahler jeder Anzeige sind für jedes Land verfügbar.
* Die Laufzeitdaten, die Impressionen-Spanne, der Anteil der Impressionen nach Land und das Targeting sind nur für in der EU ausgespielte Anzeigen verfügbar.
* Die Bibliothek bewahrt Anzeigen etwa 12 Monate auf, und ihr Datumsfilter nimmt nur das letzte Jahr an.

## Eine Anzeige öffnen

`action` `ad` öffnet die Anzeige mit der `libraryId`, die Sie senden, aus einer Suche oder aus der Adresse der Werbebibliothek `/ad-library/detail/<libraryId>`.

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "ADS", "payload": { "platform": "linkedin_ad_library", "action": "ad", "libraryId": "1638962914" } }'
```

```json theme={"theme":"css-variables"}
{
  "platform": "linkedin_ad_library",
  "action": "ad",
  "libraryId": "1638962914",
  "ad": {
    "libraryId": "1638962914",
    "libraryUrl": "https://www.linkedin.com/ad-library/detail/1638962914",
    "advertiserId": "85881048",
    "advertiserName": "Samsung Germany",
    "isActive": null,
    "startDate": "2026-11-11",
    "endDate": "2026-11-22",
    "activeDays": 12,
    "platforms": ["LINKEDIN"],
    "format": "VIDEO",
    "title": "Smart arbeiten mit der Galaxy Z-Serie",
    "body": "Mails mobil checken, aber für die eigentliche Arbeit genervt an den Laptop wechseln? Das bremst den Workflow.\n\nSpar dir den Medienbruch mit der neuen Galaxy Z-Serie und nutze die maximale Flexibilität unserer faltbaren Smartphones:\n\n📱 Z Fold8 Ultra: 8-Zoll-…",
    "ctaText": "Learn more",
    "ctaType": null,
    "linkUrl": "https://www.samsung.com/de/smartphones/galaxy-z-fold8/",
    "landingDomain": "samsung.com",
    "utm": null,
    "payer": "Starcom Germany GmbH",
    "impressions": { "min": 50000, "max": 100000 },
    "targeting": {
      "language": { "exclude": null, "include": ["English"] },
      "location": { "exclude": null, "include": ["Germany"] },
      "parameters": [
        { "excluded": false, "parameter": "Audience", "targeted": false }
      ]
    },
    "reachedCountries": ["DE"],
    "images": [],
    "videos": [
      {
        "bitrate": 12005128,
        "files": [
          {
            "bitrate": 12005128,
            "type": "video/mp4",
            "url": "https://dms.licdn.com/playlist/vid/v2/D4E10AQHs0oH-zSWScA/progressive-servable-video/B4EaHKwT54IoAg-/0/1794403027272"
          }
        ],
        "previewUrl": "https://media.licdn.com/dms/image/v2/D4E10AQHs0oH-zSWScA/videocover-high/B4EaHKwT54IoBQ-/0/1794403028674",
        "url": "https://dms.licdn.com/playlist/vid/v2/D4E10AQHs0oH-zSWScA/progressive-servable-video/B4EaHKwT54IoAg-/0/1794403027272"
      }
    ],
    "advertiserLogoUrl": "https://media.licdn.com/dms/image/v2/D4E0BAQEL38Z5ttMZXw/company-logo_100_100/company-logo_100_100/0/1692353831724/samsung_germany_logo",
    "advertiserType": "company",
    "advertiserUrl": "https://www.linkedin.com/company/85881048",
    "bodyTruncated": false,
    "creativeType": "SPONSORED_VIDEO"
  },
  "advertiser": {
    "advertiserId": "85881048",
    "advertiserName": "Samsung Germany",
    "logoUrl": "https://media.licdn.com/dms/image/v2/D4E0BAQEL38Z5ttMZXw/company-logo_100_100/company-logo_100_100/0/1692353831724/samsung_germany_logo",
    "type": "company",
    "url": "https://www.linkedin.com/company/85881048"
  },
  "transparency": {
    "impressions": { "min": 50000, "max": 100000 },
    "impressionsText": "50k-100k",
    "reachByCountry": [
      { "country": "Germany", "countryCode": "DE", "share": 100, "shareText": "100%" }
    ]
  },
  "variants": null
}
```

* `ad` enthält die Felder einer Suchkarte mit dem vollständigen Text sowie `advertiserId`, `advertiserUrl`, `advertiserType` (`company` oder `person`), `payer` (wer die Anzeige bezahlt hat), `linkUrl`, `landingDomain`, `ctaText`, `startDate`, `endDate`, `activeDays`, `impressions`, `targeting` und `reachedCountries`.
* `impressions` ist die Spanne, die die Bibliothek veröffentlicht (`min`, `max`). `targeting` listet die Sprachen und Orte, die der Werbetreibende ein- oder ausgeschlossen hat (`language`, `location`), und die Targeting-Parameter (`parameters`: `parameter`, `targeted`, `excluded`). Die Daten, `impressions`, `targeting` und `reachedCountries` sind `null` bei einer Anzeige, die nicht in der EU ausgespielt wurde, wie der Adobe-Anzeige `1698237666`. Zahler und Werbetreibender sind bei jeder Anzeige vorhanden.
* `videos` listet jedes Video mit `url` (die Datei mit der höchsten Bitrate), `files` (jedes mp4: `url`, `type`, `bitrate`) und `previewUrl`. Eine Karussell-Anzeige ergänzt `cards` (`title`, `imageUrl`), und eine Dokument-Anzeige ergänzt `document` (ihren Titel, die Seitenzahl und die Seitencover).
* `advertiser` ist die Seite hinter der Anzeige: `advertiserId`, `advertiserName`, `url`, `type` und `logoUrl`.
* `transparency` ist `null` bei einer nicht in der EU ausgespielten Anzeige. Bei einer in der EU ausgespielten Anzeige enthält es `impressions`, `impressionsText` (den Text der Bibliothek, etwa `50k-100k`) und `reachByCountry`, den Anteil der Impressionen in jedem Land (`country`, `countryCode`, `share`, `shareText`), auch außerhalb der EU.
* `variants` listet die anderen Versionen der Anzeige, wo die Bibliothek mehr als eine zeigt, und ist sonst `null`.
* Medien-URLs der Creatives bleiben jahrelang offen. Die URLs der Karussell-Karten laufen nach etwa einer Woche ab, Logos von Werbetreibenden nach etwa zweieinhalb Wochen. Speichern Sie die Dateien, die Sie brauchen.
* Eine `libraryId`, zu der die Bibliothek keine Anzeige hat, schlägt mit `PAGE_UNAVAILABLE` fehl.

## Preis

Eine Suche reserviert 0.5 Credits je 30 Anzeigen, die ihr `limit` verlangt, und berechnet 0.5 Credits je 30 gelieferte Anzeigen, mindestens 0.5 Credits. Die Standardsuche mit 30 Anzeigen kostet 0.5 Credits, und eine Suche mit `limit` 120 reserviert 2 Credits. `ad` kostet 0.5 Credits. Nur abgeschlossene Anfragen werden berechnet.

## Siehe auch

* [Werbebibliotheken im Vergleich](https://docs.querying.ai/de/engines/ad-libraries.md)
* [Meta-Werbebibliothek](https://docs.querying.ai/de/engines/meta-ad-library.md)
* [Engine-Übersicht](https://docs.querying.ai/de/engines/overview.md)
* [Credits und Limits](https://docs.querying.ai/de/concepts/credits-and-limits.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.