LinkedIn Search Posts
LinkedIn Search Posts nutzt ein vorgelagertes, auf dem Google-Index beruhendes Verfahren, um öffentliche Seiten zu einer Keyword-Abfrage zu finden, und extrahiert daraus die verfügbaren Beitragsdatensätze. Das Ergebnis ist eine nach Ranking geordnete Stichprobe zum Zeitpunkt der Erfassung und weder die personalisierte native Suche von LinkedIn noch ein vollständiges Archiv; es sollte daher nicht als Gesamtvolumen der Gespräche, Reichweite, Stimmung oder Share of Voice gelesen werden.
Funktionen der LinkedIn Search Posts API
- Keyword-gesteuerte EntdeckungDurchsucht öffentlich indexierte LinkedIn-Seiten mit einer erforderlichen, nicht leeren Abfrage zu Thema, Organisation, Produkt, Person oder Wortgruppe.
- Optionales relatives DatumLeitet eine Zeichenfolge date_posted an den Anbieter weiter; dokumentierte Werte sind unter anderem last-hour, last-day, last-week, last-month und last-year.
- Auf Seiten abgestimmte LimitsLegen Sie results_limit von 10 bis 2.000 in Vielfachen von 10 fest; der Standardwert ist 10, und zulässige Werte garantieren keine Abdeckung durch den Anbieter.
- Kanonische BeitragsdatensätzeErhalten Sie stabile Felder zu Inhalt, Autor, Kennzahlen, Medien, Hashtags, Erwähnungen, Veröffentlichung und Erfassung.
- Cursor-gestützte ErfassungFolgt den Cursorn des Anbieters, bis die gewünschte Obergrenze, eine letzte oder leere Seite, ein fehlender oder ein wiederholter Cursor die Erfassung beendet.
Parameter der LinkedIn Search Posts API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
query | Erforderlich | Erforderliches, nicht leeres Keyword oder eine Wortgruppe für die Entdeckung öffentlich indexierter Beiträge. |
date_posted | Optional | Optionale, nicht leere Zeichenfolge für ein relatives Datum, die an den Anbieter weitergeleitet wird. SocQ erzwingt die dokumentierten Werte des Anbieters nicht eigenständig. |
results_limit | Optional | Optionale ganzzahlige Ergebnisobergrenze. Der Standardwert ist 10, zulässig sind 10 bis 2.000, und der Wert muss ein Vielfaches der Seitengröße des Anbieters von 10 Datensätzen sein. |
So verwenden Sie die LinkedIn Search Posts API
Senden Sie eine Keyword-Abfrage, fragen Sie die asynchrone Aufgabe ab und prüfen Sie die zurückgegebene Stichprobe.
- Wählen Sie eine nicht leere Abfrage und optional eine relative Datumszeichenfolge des Anbieters.
- Senden Sie query, date_posted und ein Limit in Schritten von 10 Datensätzen per POST an /v1/linkedin/search-posts und speichern Sie die task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe einen Endstatus erreicht.
- Verarbeiten Sie nach einem Erfolg data.results.items und folgen Sie next_cursor, sobald has_more true ist.
curl -X POST "https://api.socq.ai/v1/linkedin/search-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"AI agents","date_posted":"last-week","results_limit":10}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueAnwendungsfälle der LinkedIn Search Posts API
- Themenentdeckung: Finden Sie öffentlich indexierte Beiträge, die ein ausgewähltes Thema, Produkt, eine Organisation, Person oder Wortgruppe erwähnen.
- Prüfung von Botschaften und Formaten: Sichten Sie zurückgegebene Aussagen, Hashtags, Autoren, Links und Medienformate, ohne die Stichprobe als umfassend zu behandeln.
- Sichtung von Autoren und URLs: Identifizieren Sie öffentliche Autoren und Beitrags-URLs für die manuelle Weiterverfolgung oder eine autorenspezifische Erfassung.
- Übergabe an die Diskussion: Wählen Sie relevante Ergebnis-URLs aus und übergeben Sie sie an LinkedIn Post Comments, wenn öffentliche Diskussionsdatensätze benötigt werden.
Profi-Tipps zur LinkedIn Search Posts API
- Verwenden Sie dieselbe Abfrage, dieselbe Datumszeichenfolge, dasselbe Ergebnislimit und denselben Erfassungsrhythmus, wenn Sie Entdeckungsstichproben vergleichen.
- Betrachten Sie die Reihenfolge der Quelle als Suchranking und nicht als neutralen Wert für Beliebtheit, Aktualität oder Relevanz.
- Deuten Sie ein erfolgreiches leeres Ergebnis nicht als Beleg dafür, dass es keinen passenden LinkedIn-Beitrag gibt.
- Prüfen Sie wichtigen Text und wichtige Medien am Quellbeitrag, denn indexierte Seiten können veraltet, gekürzt, gelöscht oder eingeschränkt sein.
- Behandeln Sie fehlende Interaktionswerte als unbekannt statt als 0 und bewahren Sie collected_at mit jeder Momentaufnahme auf.
- Verwenden Sie company-posts oder profile-posts, wenn der Urheber der Beiträge bereits bekannt ist.
Verwandte APIs
Ergänzend zur LinkedIn Search Posts API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher LinkedIn-Daten benötigen.
- LinkedIn Profiles API — Öffentliche Profilidentität, Rollen, Ort, sichtbare Zahlen zur Zielgruppe, Berufserfahrung, Ausbildung und Skills aus Profil-URLs normalisieren.
- LinkedIn Companies API — Öffentliche Unternehmensbeschreibungen, Websites, Logos, sichtbare Follower- und Mitarbeiterzahlen, Branchen, Standorte und Spezialgebiete normalisieren.
- LinkedIn Posts API — Öffentliche Beitragstexte, Autoren, sichtbare Interaktionen, Medien, Veröffentlichungszeit, Typ und Hashtags aus unterstützten URLs erfassen.
- LinkedIn Jobs API — Öffentliche Jobtitel, Unternehmen, Beschreibungen, Orte, Qualifikationen, Beschäftigungsdetails, Bewerbungslinks und verfügbare Gehaltsfelder normalisieren.
- LinkedIn Post Comments API — Öffentliche Kommentare zu einem bekannten LinkedIn-Beitrag erfassen, einschließlich Text, Autorenkontext, Zeitstempeln, Beziehungs-IDs sowie sichtbarer Likes und Antwortzahlen.
- LinkedIn Search People API — Öffentliche Kandidatenprofile aus Personensuch-URLs von LinkedIn ermitteln und normalisierte Identität, Beschreibung, Bilder, Ort, Website, Kontosignale und verfügbare Kennzahlen zurückgeben.