Démarrage rapide
Enrichissez votre premier contact avec l'API Dropcontact en deux étapes. Envoyez le contact, puis récupérez le résultat.
Enrichissez votre premier contact avec l'API Dropcontact en deux étapes : envoyez le contact, puis récupérez le résultat.
Ce guide enrichit un contact : Denis Cohen, de l'entreprise Dropcontact.
Avant de commencer
Vous avez besoin d'un compte Dropcontact et d'une clé API.
- Créez et copiez votre clé API dans l'app.
- Renseignez-la une fois en début de script, elle sera réutilisée dans toutes les requêtes :
import requests
apiKey = "VOTRE_CLE_API"Dans les exemples Shell, remplacez VOTRE_CLE_API par votre clé API.
Étape 1 : envoyer le contact
r = requests.post(
"https://api.dropcontact.com/v1/enrich/all",
json={
"data": [
{
"first_name": "Denis",
"last_name": "Cohen",
"website": "dropcontact.com",
"email": "dc@dropcontact.io",
}
],
"siren": True,
},
headers={
"Content-Type": "application/json",
"X-Access-Token": apiKey,
},
)
print(r.json())Retrouvez tous les champs et options que vous pouvez envoyer dans Contact envoyé.
L'API répond :
{
"credits_left": 15279,
"request_id": "qzmxkpvlrtdnhwa",
"error": false,
"success": true
}Conservez le request_id : il vous servira à l'étape 2.
Étape 2 : récupérer le résultat
L'enrichissement prend quelques secondes. Remplacez REQUEST_ID par le request_id obtenu à l'étape 1, puis lancez la requête.
r = requests.get(
"https://api.dropcontact.com/v1/enrich/all/REQUEST_ID",
headers={"X-Access-Token": apiKey},
)
print(r.json())Si le résultat n'est pas encore prêt, l'API renvoie "success": false. Relancez la même requête 30 secondes plus tard.
{
"error": false,
"reason": "Request not ready yet, try again in 30 seconds",
"success": false
}Une fois le résultat prêt, l'API renvoie un objet par contact, dans l'ordre d'envoi :
{
"data": [
{
"first_name": "Denis",
"last_name": "Cohen",
"full_name": "Denis Cohen",
"civility": "Monsieur",
"linkedin": "www.linkedin.com/in/cohendenis",
"location": "Paris, Île-de-France, France",
"email": [
{
"email": "dc@dropcontact.io",
"qualification": "nominatif@pro"
}
],
"company": "Dropcontact",
"website": "www.dropcontact.com",
"siret_address": "7 Place de l'Hôtel de Ville",
"siret_zip": "93600",
"siret_city": "Aulnay-sous-Bois",
"country": "France",
"company_linkedin": "www.linkedin.com/company/dropcontact-email-finder",
"phone": "+33 1 23 45 67 89",
"company_turnover": "",
"company_results": "",
"nb_employees": "10-19",
"siren": "823752647",
"siret": "82375264700029",
"naf5_code": "62.01Z",
"naf5_des": "Programmation informatique",
"vat": "FR11823752647",
"industry": "Technology, Information and Internet",
"employee_count": "15"
}
],
"credits_left": 15279,
"error": false,
"success": true
}Le champ qualification indique le niveau de fiabilité de chaque email. Retrouvez tous les champs du résultat dans Contact enrichi.
Étapes suivantes
- Webhooks : recevez le résultat directement sur votre serveur, sans relancer la requête.
- Erreurs : que faire quand une requête échoue.
- Crédits : à quel moment un crédit est utilisé.
- Référence de l'API : tous les endpoints et tous les champs.