linkedin-ad-library/
search

Öffentliche LinkedIn-Anzeigen nach Unternehmen, Unternehmens-ID oder Keyword mit Länder- und Datumsfiltern suchen – mit normalisierten Feldern zu Werbetreibendem, Creative, Auslieferung, Ziel, Impressionen und Medien.

LinkedIn Ad Library Search API

Suche nach Unternehmen und Keyword
Paginierung mit 24 Datensätzen
Öffentlich offengelegte Anzeigen
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 Search

LinkedIn Ad Library Search findet aufbewahrte öffentliche Anzeigen-Offenlegungen zu einem Unternehmensnamen, einer exakten Unternehmens-ID, einem Keyword oder einer Kombination dieser Eingaben. Die zurückgegebenen Datensätze normalisieren die verfügbaren Angaben zu Identität des Werbetreibenden, Creative-Text, Quell-URL, Auslieferungszeitraum, Ländern, Impressionen, Format, Ziel und Medien, ohne fehlende Offenlegungsfelder als null zu behandeln.

Funktionen der LinkedIn Ad Library Search API

  • Drei Eingaben zur EntdeckungSuchen Sie mit einem Unternehmensnamen, einem Keyword, einer exakten LinkedIn-Unternehmens-ID oder mehreren dieser Felder in einer Anfrage; mindestens eines ist erforderlich.
  • Länder- und DatumsfilterGrenzen Sie den öffentlichen Index mit zweibuchstabigen Ländercodes und einem optionalen, beidseitig inklusiven Zeitraum der Laufzeit im Format YYYY-MM-DD ein.
  • Normalisierte öffentliche AnzeigendatensätzeLiefert stabile Anzeigenidentität, Verweis auf den Werbetreibenden, Creative-Text, Detail-URL, Daten, Märkte, Format, Ziel, Impressionen und Medien, soweit offengelegt.
  • Begrenzte Paginierung per TokenErfassen Sie 24 bis 1.992 Datensätze in Vielfachen von 24, während SocQ neuen Paginierungs-Tokens der Quelle folgt, bis das Limit oder die letzte verwertbare Seite erreicht ist.
  • Workflow von der Suche zum DetailÜbergeben Sie eine zurückgegebene /ad-library/detail/-URL an LinkedIn Ad Library Ad, wenn ein gefundener Datensatz die verfügbare Detailansicht braucht.

Parameter der LinkedIn Ad Library Search API

ParameterErforderlichBeschreibung
companyErforderlich (mindestens eines)Name des Unternehmens oder Werbetreibenden. Mindestens eines von company, keyword oder company_id ist erforderlich.
keywordErforderlich (mindestens eines)Text, der in der öffentlichen Anzeigensuche abgeglichen wird. Die Semantik des Abgleichs bestimmt die öffentliche Quelle.
company_idErforderlich (mindestens eines)Exakte LinkedIn-Unternehmens-ID, die als Sucheingabe dient.
countriesOptionalOptionale Liste zweibuchstabiger alphabetischer Ländercodes, vorzugsweise in Großbuchstaben, zum Beispiel US und CA.
start_dateOptionalOptionaler Beginn des öffentlichen Filters für das Laufdatum im Format YYYY-MM-DD.
end_dateOptionalOptionales Ende des öffentlichen Filters für das Laufdatum im Format YYYY-MM-DD; es darf nicht vor start_date liegen.
results_limitOptionalMaximal angeforderte Datensätze. Standardwert ist 24; akzeptiert werden Vielfache von 24 von 24 bis 1.992.

So verwenden Sie die LinkedIn Ad Library Search API

Wählen Sie mindestens ein Suchfeld, ergänzen Sie nur die Filter, die Ihre Stichprobe definieren, und lesen Sie die Seiten der abgeschlossenen asynchronen Aufgabe.

  1. Geben Sie company, keyword oder company_id an; kombinieren Sie sie nur, wenn die engere, von der Quelle definierte Übereinstimmung gewollt ist.
  2. Fügen Sie optional zweibuchstabige countries, einen gültigen Zeitraum und ein results_limit hinzu, das ein Vielfaches von 24 ist.
  3. Senden Sie die Anfrage per POST an /v1/linkedin-ad-library/search und speichern Sie die zurückgegebene task_id.
  4. Fragen Sie /v1/tasks/{task_id} ab, lesen Sie dann data.results.items und folgen Sie next_cursor, solange has_more den Wert true hat.
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}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Anwendungsfälle der LinkedIn Ad Library Search API

  • Anzeigen eines Werbetreibenden entdecken: Nutzen Sie einen Unternehmensnamen oder eine exakte Unternehmens-ID, um die zum Zeitpunkt der Erfassung sichtbaren öffentlichen Anzeigen eines Werbetreibenden zusammenzustellen.
  • Recherche zu Botschaften und Themen: Suchen Sie nach Keywords zu Produkten, Wettbewerbern oder Themen und vergleichen Sie den zurückgegebenen Creative-Text, die Formate, Medien und Ziele.
  • Vergleich von Märkten und Zeiträumen: Wiederholen Sie dieselbe Abfrage mit kontrollierten Länder- und Datumsfiltern, um öffentliche Offenlegungen über definierte Stichproben hinweg zu vergleichen.
  • Auswahl von Kandidaten für das Detail: Nutzen Sie zurückgegebene Anzeigen-IDs und Detail-URLs, um einzelne Datensätze für eine genauere Prüfung mit der separaten Detailoperation auszuwählen.

Profi-Tipps zur LinkedIn Ad Library Search API

  • Beginnen Sie mit einem Suchfeld und kombinieren Sie company, keyword und company_id erst, wenn eine engere, von der Quelle definierte Ergebnismenge nützlich ist.
  • Verwenden Sie Ländercodes in Großbuchstaben, damit gespeicherte Eingaben einheitlich bleiben, auch wenn der aktuelle Validator beide Schreibweisen akzeptiert.
  • Wählen Sie results_limit in Schritten von 24 Datensätzen und behandeln Sie es als Obergrenze der Erfassung, nicht als Zusage, dass jeder Platz einen Treffer hat.
  • Behalten Sie Abfrage, Filter und den Zeitpunkt collected_at, wenn Sie Durchläufe vergleichen, denn die öffentliche Verfügbarkeit und die aufbewahrten Datensätze ändern sich.
  • Behandeln Sie fehlende Werte zu Werbetreibendem, Daten, Land, Impressionen, Ziel, Format oder Medien als nicht verfügbare Offenlegungsdaten und nicht als null.

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

  • LinkedIn Ad Library Ad API — Einen bekannten öffentlichen Datensatz der LinkedIn Ad Library über die exakte Detail-URL abrufen – mit normalisierten Feldern zu Werbetreibendem, Creative, Auslieferung, Ziel, Impressionen und Medien.

Weitere Plattformen entdecken

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

LinkedIn Ad Library Search API — FAQ

LinkedIn Ad Library Search API ist eine Schnittstelle, die aufbewahrte öffentliche LinkedIn-Anzeigen zu einem Unternehmensnamen, einer exakten Unternehmens-ID, einem Keyword oder einer unterstützten Kombination findet. Sie liefert die verfügbaren Felder in der normalisierten Anzeigenstruktur von SocQ.

Geben Sie mindestens eines von company, keyword oder company_id an. Mehrere zusammen sind möglich, doch die öffentliche Suche der Quelle bestimmt, wie genau sie abgeglichen und geschnitten werden.

Der Endpunkt akzeptiert eine Liste zweibuchstabiger countries sowie optionale Werte für start_date und end_date. Eine öffentliche Sortieroption bietet er nicht.

Ein Datensatz kann Anzeigen- und Werbetreibendenidentität, öffentliche Detail-URL, Creative-Text, Start- und Enddatum, Länder, skalare Impressionen, Format, Platzierungen, Ziel, Medien und Erfassungszeit enthalten, soweit verfügbar.

Möglicherweise passt zum Zeitpunkt der Erfassung keine aufbewahrte öffentliche Anzeige zu den gesendeten Suchfeldern und Filtern. Ein leeres Ergebnis beweist nicht, dass der Werbetreibende nie Anzeigen geschaltet hat.

Die Quelle liefert bis zu 24 Anzeigen pro Seite. SocQ folgt jedem neuen Paginierungs-Token bis zu results_limit, zur letzten Seite, zu einer leeren Seite, einem fehlenden Token oder einem wiederholten Token.

Jede zurückgegebene normalisierte Anzeige kostet 0,5 SocQ-Credits. Eine erfolgreiche Aufgabe ohne zurückgegebene Datensätze verursacht keine Ergebnisgebühr.