Aller au contenu
FantomHunt
Se connecterCommencer gratuitement
Se connecter
Commencer gratuitement

L’API de prospection LinkedIn, documentée en français.

L’API de FantomHunt relie votre prospection LinkedIn, WhatsApp et email à vos outils. Une clé créée dans Paramètres lit vos prospects, vos campagnes et vos statistiques ; selon les droits cochés, elle lit aussi vos conversations, envoie des messages ou utilise l’IA sous plafond. 29 événements signés et un serveur MCP complètent l’accès, dès Essentiel.

29 événements signés Lecture seule par défaut 120 requêtes par minute
Commencer gratuitement

Compte gratuit (sans CB) · API, webhooks et MCP dès Essentiel, 29 € par mois · Voir le premier appel

Mis à jour le · API v1

Référence API

Votre clé, vérifiée en un appel.

Créez une clé dans Paramètres, onglet API, puis appelez /v1/moi : la réponse dit votre offre, les droits de la clé et vos crédits.

  • Une clé par outil, nommée et révocable à tout moment
  • Lecture seule par défaut : écrire, envoyer et dépenser se cochent un à un
  • 120 requêtes par minute et par clé, erreurs au format { error, message }
Clés APIParamètres › API
HubSpot par Zapierfh_live_a1b2••••Lectureutilisée il y a moins d’une heureRévoquer
Requête
curl https://api.fantomhunt.com/v1/moi \
  -H "Authorization: Bearer fh_live_a1b2…"
200 · réponse en JSON
{  "compte": { "plan": "essentiel", … },votre offre  "cle": { "droits": ["lecture"], … },droits de la clé  "credits": { "ia": { "restants": 362, … } },crédits restants  "invitations_linkedin": { "envoyees": 312, … }invitations du mois}
Exemple fictif. L’offre est revérifiée à chaque appel : un compte repassé en Découverte perd l’accès, même avec une clé active.
Webhooks

Vos outils et FantomHunt, dans les deux sens.

FantomHunt prévient votre outil à chaque événement ; votre outil met FantomHunt à jour par l’API.

  • 29 événements en six familles, signés HMAC-SHA256 et filtrables
  • Notes, tâches et affaires modifiables par l’API, avec le droit « Modifier le CRM »
  • Sans code : Zapier, Make ou n8n reçoivent les événements à une simple adresse
FantomHuntVotre outil
FantomHuntvotre outilUn webhook partPOST https://votre-outil.fr/webhooks/fantomhuntX-Fantomhunt-Signature: t=1790759638,v1=5f2c…
{
  "evenement": "reponse.recue",
  "cree_le": "2026-09-30T09:13:58.000Z",
  "donnees": {
    "canal": "linkedin",
    "prospect": { "nom": "Camille Roussel", "entreprise": "Skova", … }
  }
}
200reçu par votre outil
FantomHuntvotre outilVotre outil répond par l’APIPATCH https://api.fantomhunt.com/v1/affaires/5d1e…Authorization: Bearer fh_live_a1b2…
{ "statut": "gagnee" }
200{ "nom": "Skova, 12 licences", "statut": "gagnee", … }
Exemple fictif. Modifier une affaire demande une clé avec le droit « Modifier le CRM » ; la lecture est toujours incluse.
Serveur MCP

Votre assistant IA, branché en une commande.

Le serveur MCP de FantomHunt donne à ChatGPT, Claude, Claude Code ou Cursor les outils de votre prospection, avec les droits que vous cochez.

  • ChatGPT et Claude : une adresse à coller, sans clé
  • Les outils proposés suivent les droits de la clé
  • Le coût est annoncé avant toute action payante
Terminal · Claude Code
claude mcp add --transport http fantomhunt \
  https://api.fantomhunt.com/mcp \
  --header "Authorization: Bearer fh_live_VOTRE_CLE"
Votre assistant IAMCP · FantomHunt

Quels rendez-vous attendent leur compte rendu ?

mes_rdv{ "periode": "a_debriefer" }LectureCamille Roussel · Skovajeudi à 14 h · LinkedIn · sans compte rendu

Un rendez-vous attend son compte rendu : Camille Roussel, de Skova, jeudi à 14 h, pris sur LinkedIn.

Exemple fictif. L’assistant ne voit que les outils permis par les droits de la clé ; avec Cursor, la même adresse se pose dans mcp.json.

Avant de brancher, les réponses franches.

Une autre question ? Écrivez-nous à contact@fantomhunt.com.

L’API FantomHunt est-elle incluse dans l’offre gratuite ?

Non. L’API, les webhooks et le serveur MCP sont inclus dans les offres Essentiel, 29 € par mois sans engagement (19 € par mois en annuel, engagement de 12 mois), et Croissance, 69 € par mois (49 € en annuel). Un compte Découverte voit l’écran API verrouillé dans Paramètres : passer à une offre payante suffit pour créer une clé.

Faut-il savoir coder pour relier FantomHunt à vos outils ?

Non pour les recettes : Zapier, Make ou n8n reçoivent les événements FantomHunt par une simple adresse de réception. Avec Zapier, ce déclencheur demande une offre Zapier payante, selon son aide. L’appel direct à l’API, en une ligne de commande, sert à aller plus loin : lire des listes, envoyer, rédiger avec l’IA.

L’API fonctionne-t-elle navigateur fermé ?

En partie. Un message ou une invitation LinkedIn demandé par l’API entre dans la file de l’extension et part quand votre navigateur est ouvert, dans vos horaires et vos plafonds. WhatsApp passe aussi par l’extension. Les emails partent de nos serveurs, même navigateur fermé, et les lectures répondent à tout moment.

Puis-je ajouter des prospects par l’API ?

Pas directement pour l’instant : l’ajout d’une fiche par l’API répond 409 action_compte_requise et se fait dans l’application. Pour faire entrer de nouveaux profils LinkedIn par l’API, lancez plutôt une recherche avec le droit « Envoyer des messages et lancer des actions » : l’extension l’exécute, jusqu’à 500 profils par recherche, dans la limite de 1 000 par jour.

Une clé peut-elle envoyer des messages sans mon accord ?

Seulement si vous lui donnez le droit « Envoyer des messages et lancer des actions », décoché par défaut. L’envoi part alors sans relecture dans l’application (aussitôt pour un email ou un message WhatsApp, par la file de l’extension pour LinkedIn), avec les mêmes plafonds qu’à la main : au plus 100 invitations LinkedIn par jour, 300 par semaine et 800 par mois, 30 messages WhatsApp par jour. Une clé sans ce droit n’envoie jamais rien.

L’API et le MCP fonctionnent-ils avec ChatGPT ?

Oui, par le serveur MCP. ChatGPT en mode développeur (offres Plus, Pro, Business et Enterprise) et Claude s’y branchent par une connexion de compte : vous collez l’adresse du serveur, puis vous autorisez l’accès sur FantomHunt en cochant les droits de l’assistant, sans clé. L’API, elle, se pilote avec une clé.

FantomHunt est-il une API de données LinkedIn ?

Non. L’API FantomHunt pilote votre propre prospection : les recherches et les envois LinkedIn qu’elle lance passent par l’extension de votre navigateur, avec votre session, dans la limite de 1 000 profils trouvés par jour et 3 000 par semaine. Ce n’est ni une base de profils à interroger, ni l’API officielle de LinkedIn.

Comment éviter les doublons entre FantomHunt et votre outil ?

Gardez l’identifiant FantomHunt de chaque fiche : il figure dans chaque livraison de webhook qui concerne cette personne et ne change pas. Pour retrouver une personne, l’API cherche aussi par email, lien LinkedIn ou téléphone. Quand un outil rejoue une requête POST, l’en-tête Idempotency-Key, gardé 24 heures, empêche qu’elle soit traitée deux fois.

La référence de l’API · Les 29 événements · Brancher ChatGPT, Claude ou Cursor · Déjà client ? Ouvrir Paramètres › API

Votre première clé se crée dans Paramètres.

Commencer gratuitement
  • Compte gratuit (sans CB)
  • API, webhooks et MCP dès Essentiel, 29 € par mois
  • Lecture seule par défaut