LinkedIn Company Posts
I post aziendali di LinkedIn sono aggiornamenti pubblici proposti attorno alle pagine delle organizzazioni, con testo, identità di chi pubblica, contenuti multimediali, orario di pubblicazione, argomenti ed engagement visibile. Questi record supportano il monitoraggio della comunicazione, la revisione dei contenuti, l’analisi dei contenuti multimediali e il confronto tra organizzazioni e finestre temporali selezionate.
Funzionalità della LinkedIn Company Posts API
- Scoperta ancorata alla pagina aziendaleUsa uno o più URL LinkedIn pubblici /company/ per scoprire i post associati alla pagina di ogni organizzazione selezionata.
- Contesto di chi pubblicaRestituisce un oggetto autore normalizzato, così l’associazione con l’azienda resta distinta dalla persona o da chi pubblica indicato su un singolo post.
- Segnali di contenuto e contenuti multimedialiCombina in ogni record testo del post, contenuti multimediali allegati, hashtag, menzioni, orario di pubblicazione e URL originale del post.
- Istantanea dell’engagement visibileEspone Mi piace, commenti, condivisioni e visualizzazioni disponibili come contatori al momento della raccolta, non come copertura dedotta o risultati di business.
- Valori di data facoltativi del providerInoltra le stringhe start_date e end_date non vuote con ogni URL di input, senza imporre un’interpretazione locale di formato, ordine, estremi inclusi o fuso orario.
Parametri della LinkedIn Company Posts API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Elenco obbligatorio di URL pubblici http o https di pagine aziendali LinkedIn. Ogni host deve essere linkedin.com o un sottodominio di LinkedIn e il suo percorso deve iniziare con /company/. |
start_date | Facoltativo | Valore di data del provider facoltativo e non vuoto, inoltrato per ogni URL. YYYY-MM-DD è l’esempio documentato, ma il servizio non analizza il formato, gli estremi inclusi né il fuso orario. |
end_date | Facoltativo | Valore di data del provider facoltativo e non vuoto, inoltrato per ogni URL. Il servizio non ne controlla il formato e non richiede che segua start_date. |
results_limit | Facoltativo | Tetto intero facoltativo, applicato separatamente a ogni URL di input. Il valore predefinito è 100, il minimo è 1 e il massimo è 2.000. |
Come usare la LinkedIn Company Posts API
Invia gli URL delle pagine aziendali con eventuali valori di data facoltativi, poi interroga l’attività asincrona e leggi ogni pagina del cursore.
- Prepara URL LinkedIn pubblici il cui percorso inizia con /company/.
- Invia con POST urls, le stringhe facoltative start_date ed end_date e results_limit a /v1/linkedin/company-posts; salva task_id.
- Interroga /v1/tasks/{task_id} finché l’attività raggiunge succeeded o failed.
- Leggi data.results.items e prosegui con next_cursor ogni volta che has_more è true.
curl -X POST "https://api.socq.ai/v1/linkedin/company-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/company/microsoft/"],"start_date":"2026-01-01","end_date":"2026-06-30","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 Company Posts API
- Cronologie della comunicazione pubblica: Organizza testo dei post, orari di pubblicazione, URL di origine e identità di chi pubblica in cronologie consultabili per le pagine aziendali selezionate.
- Revisione di argomenti e contenuti multimediali: Usa hashtag, menzioni, testo e riferimenti ai contenuti multimediali per esaminare gli argomenti pubblici ricorrenti e i formati di contenuto nel campione restituito.
- Istantanee di engagement confrontabili: Confronta Mi piace, commenti, condivisioni e visualizzazioni visibili sui post restituiti, quando date, limiti e orari di raccolta restano coerenti.
- Selezione dei contenuti per approfondimenti: Usa ID dei post, URL, autori, testo e contatori per selezionare record specifici da analizzare in seguito per commenti o creatività.
Consigli degli esperti per la LinkedIn Company Posts API
- Verifica che ogni input sia un URL LinkedIn /company/ completo prima di inviare un’attività con più pagine.
- Considera start_date ed end_date come stringhe definite dal provider; usa YYYY-MM-DD in modo coerente, ma non presumere una validazione locale, estremi inclusi o un ordine.
- Mantieni coerenti date, results_limit e tempi di raccolta quando confronti più pagine aziendali.
- Controlla autore e URL del post in ogni record, perché l’associazione con una pagina aziendale non garantisce che il post sia stato scritto dalla pagina aziendale.
- Deduplica per id stabile del post o per URL quando pagine sovrapposte o esecuzioni ripetute propongono lo stesso post.
- Salva i link ai contenuti multimediali in modo difensivo, perché gli asset pubblici possono reindirizzare, scadere o diventare non disponibili dopo la raccolta.
API correlate
Oltre alla LinkedIn Company 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 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 Profile Posts API — Individua i post pubblici associati agli URL dei profili LinkedIn, con contesto dell’autore, media, hashtag, date ed engagement visibile.
- LinkedIn Video Transcript API — Trasforma in testo semplice i sottotitoli dei video di LinkedIn a partire dagli URL dei post che li contengono.