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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Elenco obbligatorio di URL di profili LinkedIn pubblici su host LinkedIn con percorsi che iniziano con /in/. |
start_date | Facoltativo | Stringa 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_date | Facoltativo | Stringa 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_posts | Facoltativo | Booleano 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_limit | Facoltativo | Numero 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.
- Prepara uno o più URL di profili LinkedIn pubblici i cui percorsi iniziano con /in/.
- 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.
- Invia con POST la richiesta a /v1/linkedin/profile-posts e interroga /v1/tasks/{task_id} finché riesce o fallisce.
- 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 trueCasi 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.
API correlate
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.