linkedin-ad-library/
ad

Einen öffentlichen LinkedIn-Ad-Library-Eintrag über seine exakte Detail-URL abrufen – mit normalisierten Feldern zu Werbetreibendem, Creative, Auslieferung, Ziel, Impressionen und Medien, soweit offengelegt.

LinkedIn Ad Library Ad API

Exakte Detail-URL
Öffentliche Offenlegung von Anzeigen
Nullable Transparenzfelder
0,5 Credits pro Ergebnis
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

LinkedIn Ad Library Ad

Detailseiten der LinkedIn Ad Library sind zeitlich begrenzte öffentliche Offenlegungen zu Anzeigen, die auf LinkedIn geschaltet wurden, mit Kontext zu Creative, Werbetreibendem, Auslieferung, Ziel, Impressionen und Medien, soweit verfügbar. Ein erfasster Datensatz dokumentiert, was zu diesem Zeitpunkt sichtbar war, und kann teilweise oder nicht mehr verfügbar werden, wenn sich Aufbewahrung, Einschränkungen oder Quellbedingungen ändern.

Funktionen der LinkedIn Ad Library Ad API

  • Auflösung einer exakten Detail-URLLöst eine URL auf linkedin.com, deren Pfad /ad-library/detail/ enthält, in höchstens einen normalisierten öffentlichen Anzeigendatensatz auf.
  • Kontext zu Creative und WerbetreibendemBehält vorhandene Anzeigenidentität, Text, Verweis auf den Werbetreibenden, Format, Ziel und Medien in der stabilen Anzeigenstruktur von SocQ.
  • Öffentliche Offenlegung der AuslieferungLiefert vorhandene Angaben zu erstem und letztem Datum, Ländern, Platzierungen und einen sicher normalisierten skalaren Impressionswert, ohne ein privates Targeting zu rekonstruieren.
  • Sicherheit bei eingeschränkten EinträgenNicht verfügbare Werte zu Werbetreibendem, Text, Ziel, Impressionen oder Medien bleiben nullable, statt Informationen abzuleiten, die die Quelle zurückhält.

Parameter der LinkedIn Ad Library Ad API

ParameterErforderlichBeschreibung
urlErforderlichErforderliche öffentliche Detail-URL der LinkedIn Ad Library. Das Schema muss http oder https sein, der Host muss auf linkedin.com enden, und der Pfad muss /ad-library/detail/ enthalten.

So verwenden Sie die LinkedIn Ad Library Ad API

Senden Sie eine exakte öffentliche Detail-URL der LinkedIn Ad Library, verfolgen Sie die asynchrone Aufgabe und lesen Sie den normalisierten Datensatz, sofern verfügbar.

  1. Kopieren Sie eine http- oder https-URL der LinkedIn Ad Library, deren Pfad /ad-library/detail/ enthält.
  2. Senden Sie url per POST an /v1/linkedin-ad-library/ad und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen wird oder fehlschlägt.
  4. Lesen Sie data.results.items; die Detailoperation liefert höchstens einen Datensatz und weitet eine nicht verfügbare URL nicht zu einer Suche aus.
curl -X POST "https://api.socq.ai/v1/linkedin-ad-library/ad" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.linkedin.com/ad-library/detail/666281156"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items; this detail operation returns at most one item

Anwendungsfälle der LinkedIn Ad Library Ad API

  • Gefundene LinkedIn-Anzeige anreichern: Rufen Sie für eine bekannte öffentliche Detail-URL die verfügbaren Felder zu Creative, Werbetreibendem, Auslieferung, Ziel, Impressionen und Medien ab.
  • Momentaufnahme einer Offenlegung sichern: Speichern Sie den normalisierten Datensatz und den Wert collected_at, bevor sich ein zeitlich begrenzter oder eingeschränkter öffentlicher Eintrag ändert oder verschwindet.
  • Öffentliche Creative-Belege vergleichen: Prüfen Sie Botschaft, Format, Assets und offengelegten Auslieferungskontext ausgewählter Anzeigen, ohne den Datensatz als Daten zur Kampagnenleistung zu behandeln.

Profi-Tipps zur LinkedIn Ad Library Ad API

  • Senden Sie die vollständige Detail-URL und keine bloße Anzeigen-ID, Unternehmensseite, Such-URL oder Liste von URLs.
  • Unterscheiden Sie eine erfolgreiche Aufgabe ohne verwertbares Element von einem Fehler des Anbieters; keines von beiden beweist, dass die Anzeige nie existiert hat.
  • Behalten Sie nullable Felder bei, denn eingeschränkte oder abgelaufene Einträge können Angaben zu Werbetreibendem, Vorschau, Zahlendem, Text, Medien oder Auslieferung absichtlich auslassen.
  • Nutzen Sie LinkedIn Ad Library Search zum Entdecken von Anzeigen; diese Operation löst nur die exakt gesendete Detail-URL auf.

Ergänzend zur LinkedIn Ad Library Ad API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher LinkedIn Ad Library-Daten benötigen.

  • LinkedIn Ad Library Search API — Öffentliche LinkedIn-Anzeigen nach Unternehmen, Unternehmens-ID oder Keyword suchen – mit Optionen für Land, Datum und Ergebnislimit.

Weitere Plattformen entdecken

Kombinieren Sie LinkedIn Ad Library-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

LinkedIn Ad Library Ad API — FAQ

LinkedIn Ad Library Ad API ist eine Schnittstelle, die einen öffentlichen Eintrag der LinkedIn Ad Library über seine exakte Detail-URL abruft. Sie liefert normalisierte Felder zu Werbetreibendem, Creative, Auslieferung, Ziel, Impressionen und Medien, wenn der öffentliche Eintrag sie offenlegt.

Senden Sie eine http- oder https-URL auf linkedin.com, deren Pfad /ad-library/detail/ enthält. Bloße IDs, Unternehmensseiten, Such-URLs und URL-Listen werden nicht akzeptiert.

Die Quelle legt in manchen Regionen möglicherweise umfangreichere Angaben offen, doch der stabile Vertrag verspricht weder die Identität des Zahlenden noch Targeting-Regeln, Impressionen nach Ländern, Handlungsaufforderungen oder einen Status „eingeschränkt“.

Die Anzeige kann entfernt worden, nach dem öffentlichen Aufbewahrungszeitraum abgelaufen, eingeschränkt, an der Quelle fehlerhaft oder über den aktuellen Anbieter nicht verfügbar sein. Die Operation ersetzt sie nicht durch eine andere Anzeige.

Jeder zurückgegebene Datensatz kostet 0,5 SocQ-Credits. Ein erfolgreiches leeres Ergebnis verursacht nur die konfigurierte Grundgebühr von null Credits.