linkedin/
search-posts

Trova i post LinkedIn pubblici indicizzati da Google per parola chiave e data relativa facoltativa, con contenuti, autori, media, tag, timestamp ed engagement visibile normalizzati.

LinkedIn Search Posts API

Ricerca per parola chiave
Data relativa
Post canonici
0,5 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

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

ParametriObbligatorioDescrizione
queryObbligatorioParola chiave o frase obbligatoria e non vuota, usata per la ricerca dei post pubblici indicizzati.
date_postedFacoltativoStringa facoltativa e non vuota con una data relativa, inoltrata al provider. SocQ non verifica in modo autonomo i valori documentati dal provider.
results_limitFacoltativoLimite 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.

  1. Scegli una query non vuota e, se vuoi, seleziona una stringa di data relativa del provider.
  2. Invia con POST query, date_posted e un incremento di 10 record a /v1/linkedin/search-posts, poi salva il task_id.
  3. Interroga /v1/tasks/{task_id} finché l’attività raggiunge uno stato finale.
  4. 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 true

Casi 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.

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.

Esplora altre piattaforme

Combina i dati di LinkedIn con i dati pubblici delle altre piattaforme social supportate.

LinkedIn Search Posts API — FAQ

LinkedIn Search Posts API è un’interfaccia programmatica per trovare i post LinkedIn pubblici indicizzati da Google a partire da una query per parola chiave e da una stringa di data relativa facoltativa. Restituisce contenuti, autori, media, tag, timestamp ed engagement visibile normalizzati.

Sì. query deve essere una stringa non vuota. L’endpoint non espone filtri nativi per autore, azienda, lingua, tipo di contenuto, engagement od ordinamento.

Il provider documenta last-hour, last-day, last-week, last-month e last-year. SocQ inoltra stringhe non vuote senza verificare in modo autonomo questo enum, quindi gli altri valori dipendono dal provider.

Deve essere un intero da 10 a 2000 e multiplo di 10. Il valore predefinito è 10.

No. L’indicizzazione di Google, la disponibilità pubblica, i limiti dei cursori del provider, le pagine vuote e i cursori ripetuti o mancanti possono interrompere la raccolta prima.

No. Questo endpoint produce record di post normalizzati. Usa LinkedIn Post Comments per la discussione pubblica sotto l’URL di un post selezionato.

Ogni post restituito costa 0,5 crediti SocQ, senza costo di base. La stima predefinita è di 10 risultati, i set di risultati vuoti non hanno costi per risultato e l’utilizzo effettivo può superare la stima, quando consentito.