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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
company | Erforderlich (mindestens eines) | Name des Unternehmens oder Werbetreibenden. Mindestens eines von company, keyword oder company_id ist erforderlich. |
keyword | Erforderlich (mindestens eines) | Text, der in der öffentlichen Anzeigensuche abgeglichen wird. Die Semantik des Abgleichs bestimmt die öffentliche Quelle. |
company_id | Erforderlich (mindestens eines) | Exakte LinkedIn-Unternehmens-ID, die als Sucheingabe dient. |
countries | Optional | Optionale Liste zweibuchstabiger alphabetischer Ländercodes, vorzugsweise in Großbuchstaben, zum Beispiel US und CA. |
start_date | Optional | Optionaler Beginn des öffentlichen Filters für das Laufdatum im Format YYYY-MM-DD. |
end_date | Optional | Optionales Ende des öffentlichen Filters für das Laufdatum im Format YYYY-MM-DD; es darf nicht vor start_date liegen. |
results_limit | Optional | Maximal 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.
- Geben Sie company, keyword oder company_id an; kombinieren Sie sie nur, wenn die engere, von der Quelle definierte Übereinstimmung gewollt ist.
- Fügen Sie optional zweibuchstabige countries, einen gültigen Zeitraum und ein results_limit hinzu, das ein Vielfaches von 24 ist.
- Senden Sie die Anfrage per POST an /v1/linkedin-ad-library/search und speichern Sie die zurückgegebene task_id.
- 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 trueAnwendungsfä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.
Verwandte APIs
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.