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) => {
  try {
    const response = await fetch(
      `https://app.reactin.io/api/v1/${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": [
    {
      "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

• page : numéro de la page courante

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

---

✅ 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 →