Elencare i collegamenti di un utente è un GET su /linkedin/v2/{account_id}/users/{user_id}/relations, parte della famiglia users della MakeHybrid API. Ogni richiesta porta la tua chiave in un header X-API-KEY; la chiave decide quale organizzazione sei e quindi quali account LinkedIn puoi nominare.
Leggere profili è il modo più economico di consumare la buona volontà di un account. Distanziali, e preferisci una chiamata di arricchimento a un ciclo di ricerche singole.
La richiesta
curl -X GET "https://makehybrid.com/linkedin/v2/$ACCOUNT_ID/users/$USER_ID/relations" \ -H "X-API-KEY: $MAKEHYBRID_KEY"
Cosa va nel percorso
- account_id — l’account LinkedIn collegato con cui agire. Deve essere uno collegato dalla tua chiave; qualsiasi altro id risponde 404.
- user_id — un id restituito da una chiamata precedente di questa famiglia.
Cosa torna quando non funziona
- 401 — la chiave manca, è sbagliata o è stata revocata.
- 402 — il piano non è pagato. La MakeHybrid API risponde così quando la prova è finita.
- 404 — o la cosa non c’è, o l’id dell’account non è tuo. Le due risposte sono uguali di proposito, così gli id non si possono sondare.
- 429 — troppe richieste, o LinkedIn che frena l’account. Aspettare è l’unico rimedio; riprovare prima lo allunga.
- 503 — LinkedIn, o il salto davanti a lui, non ha risposto. Il corpo porta lo stato nudo che ha visto.
Ogni errore è JSON nella stessa forma: {"type":"errors/<code>","status":<n>,"detail":"..."} — così un solo gestore li copre tutti, e il detail è scritto per essere mostrato a una persona.
Chiederlo a un assistente
Questa operazione è anche uno strumento MCP. Incolla https://makehybrid.com/linkedin/mcp/<la tua chiave API> in Claude, ChatGPT o qualunque assistente che parli MCP e chiedi quello che vuoi in italiano — l’assistente sceglie la chiamata, riempie gli id e ti legge la risposta. Non c’è niente da installare.
In una stanza di progetto
In una stanza di progetto, spunta MakeHybrid sotto Può usare per un tuo agente IA, e questo chiama «Elencare i collegamenti di un utente» come strumento ogni volta che la conversazione ne ha bisogno, sugli account LinkedIn che la tua organizzazione ha collegato. Tutti nella stanza vedono cosa ha chiesto e cosa è tornato. Chiedi a parole tue; qui l’agente si chiama @scout:
- @scout cerca la persona dietro questo profilo e dimmi il suo ruolo e la sua azienda: <profile URL>
Domande frequenti
Un agente IA può chiamare «Elencare i collegamenti di un utente» per me?
Sì. Può farlo qualsiasi assistente che parli MCP, tramite l’indirizzo qui sopra, e così un tuo agente IA in una stanza di progetto con MakeHybrid spuntato. Gli agenti integrati di una stanza no: consigliano, e non hanno la tua chiave LinkedIn.
Funziona fuori da una stanza, dal mio codice?
Sì. La richiesta qui sopra è la stessa operazione che chiama lo strumento di un agente IA, con la stessa risposta e gli stessi errori. La tua chiave decide quali account LinkedIn può nominare, in qualunque modo tu entri.
Funziona in una stanza con il mio marchio?
Sì. Su un indirizzo a marchio bianco lo strumento è elencato con il nome del tuo prodotto, e raggiunge gli stessi account con le stesse regole.
In quale piano
La MakeHybrid API, su /linkedin. 9 $ per account LinkedIn collegato al mese, 7 $ da dieci account e 5 $ da mille, con 30 giorni di prova per un account.