LinkedIn Search Posts
LinkedIn Search Posts usa un metodo di ricerca a monte basato sull’indicizzazione di Google per trovare le pagine pubbliche di una singola parola chiave, ed estrae poi i record dei post disponibili. Il risultato è un campione ordinato e rilevato al momento della raccolta, non la ricerca nativa personalizzata di LinkedIn né un archivio completo, quindi non va considerato come volume totale di conversazioni, copertura, sentiment o quota di voce.
Funzionalità della LinkedIn Search Posts API
- Ricerca guidata dalla parola chiaveCerca nelle pagine LinkedIn indicizzate pubblicamente con una query obbligatoria e non vuota su un argomento, un’organizzazione, un prodotto, una persona o una frase.
- Data relativa facoltativaInoltra al provider una stringa date_posted; i valori documentati includono last-hour, last-day, last-week, last-month e last-year.
- Limiti allineati alle pagineImposta results_limit da 10 a 2000 in multipli di 10; il valore predefinito è 10 e i valori accettati non garantiscono la copertura del provider.
- Record di post canoniciRicevi campi stabili per contenuto, autore, metriche, media, hashtag, menzioni, pubblicazione e raccolta.
- Raccolta basata sul cursoreSegue i cursori del provider finché il limite richiesto, una pagina finale o vuota, un cursore mancante o un cursore ripetuto non interrompe la raccolta.
Parametri della LinkedIn Search Posts API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
query | Obbligatorio | Parola chiave o frase obbligatoria e non vuota, usata per la ricerca dei post pubblici indicizzati. |
date_posted | Facoltativo | Stringa facoltativa e non vuota con una data relativa, inoltrata al provider. SocQ non verifica in modo autonomo i valori documentati dal provider. |
results_limit | Facoltativo | Limite intero facoltativo dei risultati. Il valore predefinito è 10, accetta da 10 a 2000 e deve essere un multiplo della dimensione di pagina del provider, pari a 10 record. |
Come usare la LinkedIn Search Posts API
Invia una sola query per parola chiave, interroga lo stato dell’attività asincrona ed esamina il campione di ricerca restituito.
- Scegli una query non vuota e, se vuoi, seleziona una stringa di data relativa del provider.
- Invia con POST query, date_posted e un incremento di 10 record a /v1/linkedin/search-posts, poi salva il task_id.
- Interroga /v1/tasks/{task_id} finché l’attività raggiunge uno stato finale.
- Dopo il successo elabora data.results.items e segui next_cursor ogni volta che has_more è true.
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 trueCasi d’uso della LinkedIn Search Posts API
- Ricerca di argomenti: Trova i post indicizzati pubblicamente che citano un argomento, un prodotto, un’organizzazione, una persona o una frase scelti.
- Analisi di messaggi e formati: Esamina affermazioni, hashtag, autori, link e formati dei media restituiti, senza considerare il campione esaustivo.
- Selezione di autori e URL: Individua autori pubblici e URL dei post per un approfondimento manuale o per una raccolta specifica per autore.
- Passaggio alle discussioni: Seleziona gli URL dei risultati rilevanti e passali a LinkedIn Post Comments quando servono i record della discussione pubblica.
Consigli degli esperti per la LinkedIn Search Posts API
- Usa la stessa query, la stessa stringa di data, lo stesso limite di risultati e la stessa pianificazione di raccolta quando confronti campioni di ricerca.
- Considera l’ordine a monte come una classifica di ricerca, non come un punteggio neutro di popolarità, recenza o pertinenza.
- Non interpretare un risultato vuoto riuscito come prova che non esista alcun post LinkedIn corrispondente.
- Verifica testi e media importanti sul post originale, perché le pagine indicizzate possono essere obsolete, troncate, eliminate o con accesso limitato.
- Considera i valori di engagement mancanti come sconosciuti e non come zero, e conserva collected_at con ogni istantanea.
- Usa company-posts o profile-posts quando l’autore della pubblicazione è già noto.
API correlate
Oltre alla LinkedIn Search Posts API, usa queste API quando ti serve un altro tipo di dati pubblici di LinkedIn.
- LinkedIn Profiles API — Normalizza identità del profilo pubblico, ruoli, località, conteggi visibili del pubblico, esperienze, formazione e competenze a partire dagli URL dei profili.
- LinkedIn Companies API — Normalizza descrizioni pubbliche delle aziende, siti web, logo, conteggi visibili di pubblico e dipendenti, settori, sedi e specializzazioni.
- LinkedIn Posts API — Raccoglie testo dei post pubblici, autori, engagement visibile, media, data di pubblicazione, tipo e hashtag dagli URL supportati.
- LinkedIn Jobs API — Normalizza titoli delle offerte pubbliche, aziende, descrizioni, sedi, qualifiche, dettagli del contratto, link per candidarsi e campi sulla retribuzione, se disponibili.
- LinkedIn Post Comments API — Raccoglie i commenti pubblici esposti con un post LinkedIn noto, inclusi testo, contesto dell’autore, date, ID delle relazioni e conteggi visibili di Mi piace e risposte.
- LinkedIn Search People API — Individua profili pubblici candidati dagli URL di ricerca persone di LinkedIn, restituendo identità, descrizione, immagini, località, sito web, segnali dell’account e metriche disponibili in forma normalizzata.