Aller au contenu
La vraie plus-value

Fetchr en API : la chasse à grande échelle

La recherche d'emails société en JSON — asynchrone : tu lances, tu récupères. À brancher dans ton CRM, tes scripts ou tes workflows n8n/Make.

Authorization: Bearer fk_…
  • POST/api/lookups
  • GET/api/lookups/:id
  • GET/api/shots/:id.webp
  • POST/api/keys
Crée ta clé API Voir la doc complète

Clés incluses dans tous les plans — chaque recherche consomme ton quota mensuel.

Deux appels, et c'est tout

L'API est volontairement simple : un POST pour lancer la chasse, un GET pour récupérer les résultats. Exemples en cURL, JavaScript et Python.

Requête
# 1. Lance la recherche (202 = accepté, asynchrone)
curl -X POST "https://api.fetchr.email/api/lookups" \
  -H "Authorization: Bearer fk_TA_CLE" \
  -H "Content-Type: application/json" \
  -d '{"query": "Sodebo"}'
# → { "lookupId": "27e3ec58-…", "status": "queued" }

# 2. Récupère le résultat (poll jusqu'à "done")
curl "https://api.fetchr.email/api/lookups/27e3ec58-…" \
  -H "Authorization: Bearer fk_TA_CLE"
Réponse — 200 OK
{
  "status": "done",
  "primaryEmail": "serviceconsommateurs@sodebo.fr",
  "emails": [{
    "address": "serviceconsommateurs@sodebo.fr",
    "confidence": 93,
    "purpose": "relation_client",
    "prospectable": true,
    "sources": [{
      "url": "https://www.sodebo.com/mentions-legales",
      "screenshot": "/api/shots/7d3e521f-….webp"
    }]
  }]
}

Pensée pour la prod

Asynchrone natif

202 + job ID en réponse immédiate — poll quand tu veux, jamais de timeout de 40 s à gérer.

Bulk 50 domaines

Un seul POST lance jusqu'à 50 chasses dédupliquées — parfait pour enrichir un export CRM entier.

Preuves incluses

Chaque email arrive avec ses sources publiques et un screenshot authentifié — unique sur le marché.

Cache gratuit 30 j

Re-chasser un domaine récent est instantané et ne consomme aucun crédit.

120 req/min

Rate limit généreux par clé, réponse 429 propre au-delà — de quoi alimenter tes pipelines sans friction.

Hébergé en UE

Données traitées et stockées en Europe, DPA disponible — pensé RGPD dès le départ.

Ta première clé en 3 étapes

  1. 1

    Crée ta clé

    Dans l'app, onglet API : une clé fk_… nommée, révocable à tout moment.

  2. 2

    Lance une chasse

    POST /api/lookups avec un domaine ou un nom de société — réponse immédiate avec le job.

  3. 3

    Récupère les résultats

    GET sur le job jusqu'à « done » : emails, confiance, sources et screenshots.

Questions fréquentes

Prêt à lâcher la meute ?

Crée ta clé API