Parcourir une liste de prospects est un POST sur /linkedin/v2/{account_id}/linkedin/sales-navigator/lead-lists/{list_id}, dans la famille linkedin de la MakeHybrid API. Chaque requête porte votre propre clé dans un en-tête X-API-KEY ; la clé décide quelle organisation vous êtes, et donc quels comptes LinkedIn vous pouvez nommer.
Cette famille transmet la requête à la surface de LinkedIn elle-même : ce qui revient a la forme que LinkedIn lui donne, pas nous.
La requête
curl -X POST "https://makehybrid.com/linkedin/v2/$ACCOUNT_ID/linkedin/sales-navigator/lead-lists/$LIST_ID" \
-H "X-API-KEY: $MAKEHYBRID_KEY" \
-H "content-type: application/json" \
-d '{}'
Ce qui va dans le chemin
- account_id — le compte LinkedIn connecté au nom duquel agir. Ce doit être un compte que votre propre clé a connecté ; tout autre id répond 404.
- list_id — un id renvoyé par un appel précédent de cette famille.
Ce qui revient quand ça ne marche pas
- 401 — la clé est absente, fausse ou révoquée.
- 402 — l’offre n’est pas payée. La MakeHybrid API répond cela une fois l’essai terminé.
- 404 — soit la chose n’est pas là, soit l’id de compte n’est pas le vôtre. Les deux donnent exprès la même réponse, pour qu’on ne puisse pas sonder les ids.
- 429 — trop de requêtes, ou LinkedIn qui freine le compte. Attendre est le seul remède ; réessayer plus tôt allonge l’attente.
- 503 — LinkedIn, ou le saut devant lui, n’a pas répondu. Le corps porte le statut brut qu’il a vu.
Chaque erreur est du JSON de la même forme : {"type":"errors/<code>","status":<n>,"detail":"..."} — un seul gestionnaire les couvre toutes, et le detail est écrit pour être montré à une personne.
Le demander à un assistant
Cette opération est aussi un outil MCP. Collez https://makehybrid.com/linkedin/mcp/<votre clé d’API> dans Claude, ChatGPT ou n’importe quel assistant qui parle MCP, et demandez ce que vous voulez en français — l’assistant choisit l’appel, remplit les ids et vous lit la réponse. Il n’y a rien à installer.
Dans une salle de projet
Dans une salle de projet, cochez MakeHybrid sous Peut utiliser pour un agent IA à vous, et il appelle « Parcourir une liste de prospects » comme un outil chaque fois que la conversation en a besoin, sur les comptes LinkedIn que votre organisation a connectés. Tout le monde dans la salle voit ce qu’il a demandé et ce qui est revenu. Demandez en langage courant ; ici, l’agent s’appelle @scout :
Questions fréquentes
Un agent IA peut-il appeler « Parcourir une liste de prospects » pour moi ?
Oui. Tout assistant qui parle MCP le peut, par l’adresse ci-dessus, et un agent IA à vous dans une salle de projet avec MakeHybrid coché aussi. Les agents intégrés d’une salle, non : ils conseillent, et ils n’ont pas votre clé LinkedIn.
Cela marche-t-il en dehors d’une salle, depuis mon propre code ?
Oui. La requête ci-dessus est la même opération que celle qu’appelle l’outil d’un agent IA, avec la même réponse et les mêmes erreurs. Votre clé décide quels comptes LinkedIn elle peut nommer, quelle que soit la façon dont vous entrez.
Cela marche-t-il dans une salle sous ma propre marque ?
Oui. Sur une adresse en marque blanche, l’outil est listé sous le nom de votre produit, et il atteint les mêmes comptes selon les mêmes règles.
Une personne peut-elle approuver avant qu’un agent IA fasse cela ?
Écrivez-le dans les instructions de l’agent IA : dire ce qu’il s’apprête à faire et attendre qu’une personne dans la salle dise « vas-y ». Une salle montre chaque réponse à tous ceux qui s’y trouvent, donc la demande est vue avant que quoi que ce soit change sur LinkedIn.
Dans quelle offre
La MakeHybrid API, sur /linkedin. 9 $ par compte LinkedIn connecté et par mois, 7 $ à partir de dix comptes et 5 $ à partir de mille, avec 30 jours d’essai pour un compte.