linkedin/
profile-posts

Scopri i post pubblici associati agli URL dei profili LinkedIn, con testo normalizzato, contesto dell’autore, contenuti multimediali, hashtag, timestamp ed engagement visibile.

LinkedIn Profile Posts API

Scoperta dagli URL dei profili
Filtro dei post originali
Limiti per profilo
1 credito 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 Profile Posts

Il feed associato a un profilo LinkedIn può contenere post originali, repost, articoli, immagini, video, documenti e altre attività pubbliche dalla pagina di un membro. I record restituiti offrono un campione al momento della raccolta per la ricerca sui contenuti, ma non rappresentano una cronologia completa delle attività, né analisi private, né una visibilità riservata ai collegamenti.

Funzionalità della LinkedIn Profile Posts API

  • Scoperta dagli URL dei profiliAccetta uno o più URL LinkedIn pubblici /in/ e scopre i post associati a ciascun profilo inviato.
  • Filtro facoltativo dei post originaliInoltra only_authored_posts per ridurre l’attività associata ai post che il provider identifica come scritti dal profilo di destinazione.
  • Finestre di date del providerInoltra le stringhe facoltative start_date e end_date per il filtraggio lato provider, senza imporre una regola locale di formato, ordine, estremi inclusi o fuso orario.
  • Contesto normalizzato del contenutoRestituisce, in uno schema stabile dei post, testo del post, campi dell’autore, orario di pubblicazione, contenuti multimediali, hashtag, menzioni e URL di origine, se disponibili.
  • Istantanee dell’engagement visibileMantiene i Mi piace, i commenti, le condivisioni e le visualizzazioni disponibili con collected_at, così le misurazioni restano legate al loro orario di osservazione.

Parametri della LinkedIn Profile Posts API

ParametriObbligatorioDescrizione
urlsObbligatorioElenco obbligatorio di URL di profili LinkedIn pubblici su host LinkedIn con percorsi che iniziano con /in/.
start_dateFacoltativoStringa facoltativa e non vuota del filtro per data del provider, inoltrata per ogni profilo di input; SocQ non ne analizza né ne convalida formato o estremi inclusi.
end_dateFacoltativoStringa facoltativa e non vuota del filtro per data del provider, inoltrata per ogni profilo di input; SocQ non ne controlla l’ordine rispetto a start_date.
only_authored_postsFacoltativoBooleano facoltativo inoltrato per ogni profilo; true richiede i post che il provider identifica come scritti dal profilo, ma non è una verifica dell’identità lato SocQ.
results_limitFacoltativoNumero intero facoltativo da 1 a 2.000, applicato separatamente a ogni URL di profilo, con valore predefinito 100 per profilo.

Come usare la LinkedIn Profile Posts API

Invia gli URL dei profili e i controlli di scoperta, segui l’attività asincrona e scorri i post normalizzati salvati.

  1. Prepara uno o più URL di profili LinkedIn pubblici i cui percorsi iniziano con /in/.
  2. Scegli only_authored_posts e un results_limit da 1 a 2.000 per ogni profilo; aggiungi le stringhe di data del provider solo se servono.
  3. Invia con POST la richiesta a /v1/linkedin/profile-posts e interroga /v1/tasks/{task_id} finché riesce o fallisce.
  4. Leggi data.results.items e prosegui con next_cursor finché has_more è true.
curl -X POST "https://api.socq.ai/v1/linkedin/profile-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.linkedin.com/in/satyanadella/"],"only_authored_posts":true,"results_limit":20}'

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

Casi d’uso della LinkedIn Profile Posts API

  • Revisione della comunicazione pubblica: Studia argomenti, affermazioni, link e linguaggio ricorrente nei post restituiti associati a profili professionali selezionati.
  • Campionamento dei contenuti originali: Usa only_authored_posts per richiedere un campione più ristretto, poi controlla i campi dell’autore restituiti ogni volta che la paternità è rilevante.
  • Ricerca su formati e contenuti multimediali: Confronta i modelli disponibili di immagini, video, documenti, articoli, hashtag e menzioni all’interno di un insieme definito di record restituiti.
  • Istantanee dell’engagement in un periodo definito: Applica le stringhe di data del provider e confronta l’engagement visibile solo all’interno del campione raccolto, conservando published_at e collected_at.

Consigli degli esperti per la LinkedIn Profile Posts API

  • Considera results_limit come un tetto per profilo: cinque URL con un limite di 20 possono salvare fino a 100 post.
  • Mantieni gli input di data come stringhe del provider e documenta la tua convenzione, perché SocQ non convalida formato, ordine, estremi o fuso orario.
  • Verifica l’autore restituito quando only_authored_posts è importante; il flag richiede un filtraggio del provider e non dimostra l’identità.
  • Conserva collected_at accanto alle metriche di engagement, perché i conteggi visibili possono cambiare da un’esecuzione all’altra.
  • Tieni distinto null da zero per timestamp e metriche e prevedi che contenuti multimediali, hashtag o menzioni possano essere vuoti.
  • Non dedurre competenze, stato occupazionale, sentiment, qualità del lead, influenza o efficacia dei contenuti dal solo campione normalizzato.

Oltre alla LinkedIn Profile 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 Company Posts API — Individua i post pubblici dagli URL delle pagine aziendali di LinkedIn con testo, contesto dell’autore, media, hashtag, date ed engagement visibile.
  • 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 Video Transcript API — Trasforma in testo semplice i sottotitoli dei video di LinkedIn a partire dagli URL dei post che li contengono.

Esplora altre piattaforme

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

LinkedIn Profile Posts API — FAQ

LinkedIn Profile Posts API è un’interfaccia programmatica per scoprire i post pubblici associati agli URL di profili LinkedIn inviati e restituire contenuto normalizzato, contesto dell’autore, contenuti multimediali, timestamp ed engagement visibile.

Invia uno o più URL http o https su linkedin.com o su un sottodominio di LinkedIn il cui percorso inizia con /in/. Pagine aziendali e URL di post non rientrano nella specifica di input di questo endpoint.

Quando è true, il valore viene inoltrato per richiedere i post che il provider identifica come scritti dal profilo di destinazione. Non è una verifica indipendente dell’identità lato SocQ, quindi controlla i campi dell’autore restituiti quando la paternità è rilevante.

No. SocQ inoltra le stringhe non vuote senza analizzarne il formato, confrontarne l’ordine o definire estremi inclusi e fusi orari; il filtraggio dipende dal comportamento del provider.

No. Il valore predefinito è 100 e accetta da 1 a 2.000 separatamente per ogni URL, quindi il totale dell’attività può essere il limite per profilo moltiplicato per il numero di profili.

No. Significa che durante quell’esecuzione non sono stati esposti record di post pubblici utilizzabili per il profilo e i filtri inviati; visibilità e condizioni del provider possono influire sulla copertura.

Ogni post salvato correttamente costa 1 credito SocQ, senza costo base. La stima usa il tetto di risultati per profilo, mentre la fatturazione finale segue i risultati effettivamente salvati; un risultato vuoto non ha alcun costo per i risultati.