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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
url | Erforderlich | Erforderliche ö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.
- Kopieren Sie eine http- oder https-URL der LinkedIn Ad Library, deren Pfad /ad-library/detail/ enthält.
- Senden Sie url per POST an /v1/linkedin-ad-library/ad und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen wird oder fehlschlägt.
- 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 itemAnwendungsfä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.
Verwandte APIs
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.