LinkedIn Companies
Una pagina aziendale pubblica di LinkedIn presenta descrizione, sito web, settore, dimensione, sede centrale, sedi, specializzazioni e conteggi visibili di follower e dipendenti di un’organizzazione. Questi attributi supportano l’arricchimento degli account, la segmentazione delle aziende, la mappatura dei mercati e il confronto nel tempo delle informazioni pubbliche sulle aziende.
Funzionalità della LinkedIn Companies API
- Input con pagina aziendale pubblicaElabora uno o più URL LinkedIn /company/{slug} senza mescolare profili personali, post o offerte di lavoro.
- Identità dell’azienda e presenza onlineRestituisce in un unico record normalizzato nome pubblico dell’azienda, descrizione, sito web, logo e URL della pagina LinkedIn.
- Attributi strutturati dell’aziendaEspone settore, dimensione dell’azienda, sede centrale, anno di fondazione, sedi e specializzazioni come campi pronti per il filtraggio e il confronto.
- Conteggi visibili di follower e dipendentiRestituisce i conteggi disponibili di follower e dipendenti come metriche separate, accanto agli attributi dell’azienda.
Parametri della LinkedIn Companies API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Elenco obbligatorio di URL di pagine aziendali pubbliche di LinkedIn. Ogni URL deve usare il percorso /company/{slug} su linkedin.com o su un sottodominio di LinkedIn. |
Come usare la LinkedIn Companies API
Invia le pagine aziendali che già conosci, attendi l’attività sul dataset e scorri i record firmografici risultanti.
- Prepara link pubblici di aziende che seguono lo schema /company/{slug}.
- Invia con POST l’elenco urls a /v1/linkedin/companies e conserva il relativo task_id.
- Segui l’attività su /v1/tasks/{task_id} finché l’elaborazione delle aziende termina o fallisce.
- Usa data.results.items e ricorri a next_cursor per recuperare eventuali pagine di risultati successive.
curl -X POST "https://api.socq.ai/v1/linkedin/companies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/company/microsoft/"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasi d’uso della LinkedIn Companies API
- Arricchimento di account e CRM: Aggiungi descrizioni, siti web, logo, settori, dimensioni e sede centrale ai record collegati a pagine aziendali note.
- Segmentazione delle aziende: Raggruppa le organizzazioni per settore, dimensione, sedi e specializzazioni per la ricerca o la pianificazione degli account.
- Mappatura di mercati e sedi: Usa la sede centrale e gli array delle sedi per confrontare dove operano le aziende selezionate.
- Monitoraggio delle aziende pubbliche: Confronta i record salvati delle aziende per individuare variazioni in descrizioni, sedi, specializzazioni o indicatori visibili di dimensione.
Consigli degli esperti per la LinkedIn Companies API
- Normalizza e deduplica lo slug dell’azienda prima dell’invio, così le forme alternative degli URL /company/ non creano record ripetuti.
- Conserva settori, sedi e specializzazioni come array, così gli attributi multivalore dell’azienda restano intatti.
- Conserva collected_at con ogni record salvato quando confronti nel tempo gli attributi dell’azienda o i conteggi visibili.
API correlate
Oltre alla LinkedIn Companies 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 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 Company Jobs API — Individua le offerte di lavoro pubbliche dagli URL /jobs/ di LinkedIn preparati, con campi normalizzati di ruolo, azienda, sede, contratto, esperienza, lavoro da remoto, retribuzione e tempistiche.
- 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.