Zurück zu den APIs
Unabhängige Daten zu öffentlicher Werbung

LinkedIn Ad Library API

Finden Sie öffentliche LinkedIn-Anzeigen mit strukturierten Sucheingaben und rufen Sie ausgewählte Offenlegungsdatensätze anschließend über die genaue Detail-URL ab – für Recherche, Prüfung und Archivierung.

Verfügbare LinkedIn-Ad-Library-APIs

Mit Ad Search finden Sie öffentliche Datensätze nach Unternehmen, Unternehmens-ID oder Stichwort, und mit Ad Details rufen Sie einen bekannten Datensatz über seine genaue öffentliche URL ab.

Welche LinkedIn-Ad-Library-Daten können Sie abrufen?

SocQ normalisiert öffentliche Offenlegungsfelder, ohne sie als private Kampagnenanalysen auszugeben; nicht verfügbare Quellwerte bleiben null oder leer.

Identität von Anzeige und Werbetreibendem

Ruft stabile Anzeigen-IDs, öffentliche Detail-URLs, Werbetreibenden-IDs, Namen, Unternehmens-URLs und Logos ab, sofern sie bereitgestellt werden.

Creative- und Zielkontext

Erfasst verfügbare Anzeigentexte, Formate, Bild- oder Videoelemente, Platzierungen und Ziele der Landingpages.

Öffentliche Angaben zur Auslieferung

Bewahrt die von der Quelle gelieferten Laufzeiten, Länder, Plattformen, Impressionen und Erfassungszeiten.

SocQ vs LinkedIn Campaign Manager

SocQ erfasst öffentliche Offenlegungen der Ad Library. Campaign Manager ist ein eigenständiges LinkedIn-Produkt für autorisierte Werbetreibende, die ihre eigenen Kampagnen verwalten.

FunktionSocQLinkedIn Campaign Manager
HauptzweckÖffentliche Anzeigendatensätze finden und normalisierenAutorisierte Kampagnen erstellen und verwalten
EingabenSuche nach Unternehmen oder Stichwort oder eine genaue Detail-URLKennungen autorisierter Konten und Kampagnen
AuthentifizierungSocQ-API-SchlüsselLinkedIn-Konto und Werbeberechtigungen
AusgabeÖffentliche OffenlegungsfelderPrivate Kampagnenkonfiguration und Reporting

So funktionieren die LinkedIn-Ad-Library-APIs

Beide Endpunkte nutzen den asynchronen SocQ-Ablauf aus Senden, Abfragen und Lesen; Search kann mehrere Seiten liefern, Ad Details höchstens einen Datensatz.

  1. 1. Endpunkt wählen

    Senden Sie ein Unternehmen, eine Unternehmens-ID oder ein Stichwort an Search oder eine genaue öffentliche Detail-URL der Ad Library an Ad Details.

  2. 2. Aufgabe senden und verfolgen

    Senden Sie die Anfrage per POST, speichern Sie task_id und fragen Sie /v1/tasks/{task_id} ab, bis die Verarbeitung abgeschlossen ist.

  3. 3. Normalisierte Datensätze lesen

    Verarbeiten Sie data.results.items und folgen Sie next_cursor, solange has_more den Wert true hat; eine Detailanfrage liefert kein oder ein Element.

Öffentliche LinkedIn-Anzeigen suchen

Authentifizieren Sie sich mit Ihrem SocQ-API-Schlüssel. Search liefert standardmäßig 24 Ergebnisse; Ad Details akzeptiert eine genaue Detail-URL und paginiert nicht.

curl -X POST "https://api.socq.ai/v1/linkedin-ad-library/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company":"Microsoft","countries":["US"],"results_limit":24}'

# Or retrieve one known record:
# POST /v1/linkedin-ad-library/ad
# {"url":"https://www.linkedin.com/ad-library/detail/666281156"}
# Poll GET /v1/tasks/{task_id}

Typische Anwendungsfälle der LinkedIn Ad Library API

Suche nach Anzeigen von Wettbewerbern

Finden Sie beobachtbare öffentliche Anzeigen ausgewählter Unternehmen und bewahren Sie ihren Offenlegungskontext für die Prüfung auf.

Prüfung von Creatives

Rufen Sie ausgewählte Datensätze ab und prüfen Sie verfügbare Texte, Medien, Formate, Ziele, Werbetreibende und Laufzeiten.

Datensätze zu öffentlicher Werbung

Speichern Sie normalisierte Felder zu Anzeigenidentität, Werbetreibendem, Creative, Auslieferung, Quelle und Erfassung für Analysen.

Grenzen und Richtlinie für öffentliche Daten

Die Ergebnisse spiegeln den öffentlichen Index und die Sichtbarkeit der Datensätze zum Zeitpunkt der Erfassung wider und sind keine privaten Daten aus dem Campaign Manager.

  • Search erfordert mindestens eines der Felder company, keyword oder company_id; kombinierte Felder folgen dem Abgleichverhalten der Quelle.
  • countries akzeptiert zweistellige Codes, Daten müssen einen gültigen Zeitraum bilden, und results_limit ist ein Vielfaches von 24 von 24 bis 1.992.
  • Eine abgeschlossene Suche kann keine Elemente oder wiederholte Quellzeilen enthalten; eine nicht verfügbare Detail-URL kann ebenfalls keinen Datensatz liefern.
  • Felder zu Werbetreibendem, Creative, Auslieferung, Impressionen, Ziel, Format und Medien können fehlen und dürfen nicht als null interpretiert werden.

Häufige Fragen zur LinkedIn Ad Library API

Was kann ich senden?

Search akzeptiert einen Unternehmensnamen, eine Unternehmens-ID, ein Stichwort oder eine unterstützte Kombination. Ad Details akzeptiert genau eine öffentliche Detail-URL der LinkedIn Ad Library.

Liefert diese API private Kampagnenanalysen?

Nein. Sie liefert verfügbare öffentliche Offenlegungen und stellt weder Ausgaben, Klicks, Conversions, Targeting-Regeln noch Kontodaten aus dem Campaign Manager bereit.

Wie viele Datensätze können die Endpunkte zurückgeben?

Search liefert standardmäßig 24 und akzeptiert Vielfache von 24 bis 1.992. Ad Details liefert keinen oder einen Datensatz.

Wie werden Ergebnisse abgerechnet?

Jeder zurückgegebene Anzeigendatensatz kostet 0,5 Credits. Für eine erfolgreiche Aufgabe ohne Datensätze fällt keine Ergebnisgebühr an.

Führen Sie öffentliche Profile, Inhalte und Interaktionsdaten verschiedener Plattformen in einem Workflow zusammen, um Marken, Creator und Themen zu verfolgen und plattformübergreifend effizienter zu überwachen und zu analysieren.