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.
| Funktion | SocQ | LinkedIn Campaign Manager |
|---|---|---|
| Hauptzweck | Öffentliche Anzeigendatensätze finden und normalisieren | Autorisierte Kampagnen erstellen und verwalten |
| Eingaben | Suche nach Unternehmen oder Stichwort oder eine genaue Detail-URL | Kennungen autorisierter Konten und Kampagnen |
| Authentifizierung | SocQ-API-Schlüssel | LinkedIn-Konto und Werbeberechtigungen |
| Ausgabe | Öffentliche Offenlegungsfelder | Private 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. 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. 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. 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.
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.
Daten verschiedener Plattformen kombinieren und umfassendere Geschäftseinblicke gewinnen
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.
Reddit API
Rufen Sie öffentliche Reddit-Beiträge und -Kommentare aus bekannten URLs ab, durchsuchen Sie neue, beliebte oder aktuell angesagte Subreddit-Beiträge oder suchen Sie Diskussionen per Stichwort und Veröffentlichungszeitraum.
Pinterest API
Rufen Sie öffentliche Pinterest-Profildaten ab, lösen Sie bekannte Pins auf, erfassen Sie Pins ausgewählter Profile oder suchen Sie per Stichwort – für die Creator-Recherche sowie die Recherche zu Inhalten und visuellen Trends.
Threads API
Rufen Sie öffentliche Threads-Profile ab, lösen Sie bekannte Beiträge auf oder erfassen Sie Beiträge ausgewählter Profile – mit normalisierten Feldern zu Identität, Inhalt, Medien, Engagement und Zeitstempeln.
Bluesky API
Rufen Sie öffentliche Bluesky-Profile ab, lösen Sie URLs bekannter Beiträge auf oder erfassen Sie eine Seite mit Kontobeiträgen – mit normalisierter Identität, Inhalt, Medien, Zeitstempeln und sichtbaren Interaktionsfeldern.
Snapchat API
Ein bekanntes öffentliches Snapchat-Spotlight als normalisierten Datensatz abrufen – mit verfügbaren Feldern zu Creator, Bildunterschrift, Medien, Audio, Zeitstempel, Dauer und Engagement.
Twitch API
Wandeln Sie einen bekannten öffentlichen Twitch-Benutzernamen in ein normalisiertes Profil um, erfassen Sie dessen öffentlichen Videobestand oder laden Sie einen einzelnen Clip samt herunterladbarem Video für Creator-Recherche, Kataloganreicherung, Vergleiche und die Beobachtung per Momentaufnahme.

