Récupérer des leads depuis ReactIn via l'API

✅ Ce dont vous aurez besoin avant de commencer

Avant d'utiliser cette API, assurez-vous d'avoir :

1. Une SmartList API ReactIn

2. Votre Organization ID, votre List ID et votre API Key

📘 👉 Vous ne savez pas comment les obtenir ? Suivez ce guide

---

🔗 Endpoint de l'API

Envoyez une requête GET à cet endpoint pour récupérer un lead :

GET https://app.reactin.io/api/[organizationId]/lists/[listId]/leads

Cela retournera une liste paginée de leads enrichis présents dans votre SmartList.

---

🔐 Authentification et en-têtes

Vous devez envoyer votre API key dans les en-têtes à l'aide d'un token Bearer.

🔐 Votre API key est visible lorsque vous créez une SmartList API ReactIn ou dans les paramètres. Ne l'exposez jamais dans du code public.

---

📄 Paramètres de requête

Chaque page contient jusqu'à 50 leads.

---

🧪 Exemple (JavaScript)

const fetchLeads = async (organizationId, listId, page = 1, pageSize = 10) => {
  try {
    const response = await fetch(
      `https://app.reactin.io/api/${organizationId}/lists/${listId}/leads?page=${page}&pageSize=${pageSize}`,
      {
        method: 'GET',
        headers: {
          'Authorization': 'YOUR_API_KEY',
          'Content-Type': 'application/json'
        }
      }
    );

    if (!response.ok) {
      throw new Error(`HTTP Error: ${response.status}`);
    }

    const data = await response.json();

    console.log('Leads:', data.data);
    console.log('Page:', data.page);
    console.log('Next Page:', data.nextPage);

    return data;
  } catch (error) {
    console.error('Error fetching leads:', error);
  }
};

---

🧾 Format de réponse

{
  "data": [
    {
      "id": "lead_a1b2c3",
      "createdAt": "2026-05-19T10:48:00.000Z",
      "First Name": "John",
      "Last Name": "Doe",
      "Email": "john.doe@example.com",
      "Profile": "https://www.linkedin.com/in/johndoe/",
      "My AI Column": "Generated insight"
    }
  ],
  "page": 1,
  "nextPage": 2
}

• data : la liste des leads. Chaque lead inclut toujours son id et son createdAt, ainsi qu'une clé par colonne de votre SmartList (les clés correspondent au nom de vos colonnes et varient donc d'une liste à l'autre).

• page : numéro de la page courante

• nextPage : le numéro de la page suivante (ou null si terminé)

💡 Conservez l'id du lead si vous comptez le mettre à jour plus tard — c'est le leadId utilisé par l'endpoint Mettre à jour des leads via API.

---

✅ Réponse de succès

• 200 OK – Leads récupérés avec succès

---

🚫 Erreurs courantes

---

💡 Bonnes pratiques

• ⚡ Utilisez la pagination pour éviter de surcharger votre application

• 📥 Mettez les résultats en cache lorsque c'est possible afin de réduire les appels à l'API

• 🔐 Gardez votre API key privée — utilisez un serveur backend ou un proxy

• 🔁 Ajoutez une logique de nouvelle tentative pour les erreurs occasionnelles de réseau ou de serveur

---

💡 Astuce de pro : Mettez en cache les réponses de l'API de votre côté afin d'optimiser les performances et de réduire les appels inutiles.

Prêt à passer à la suite ?
👉 Étape suivante : Connecter des outils externes pour pousser des leads dans ReactIn →