API Dénichr

L'API Dénichr permet à nos partenaires d'interroger deux fonctionnalités : la recherche de fiches entreprises (scraping Google Maps) et l'enrichissement légal via la base SIRENE (INSEE).

Accès sur demande. Il n'y a pas d'inscription en libre-service : contactez contact@denichr.frpour obtenir une clé d'API.

Authentification

Chaque requête doit inclure votre clé dans l'en-tête Authorization, au format Bearer token :

Authorization: Bearer dnk_live_xxxxxxxxxxxxxxxxxxxxxxxx

Une requête sans clé valide reçoit une réponse 401.

Limite de requêtes

Chaque clé dispose d'une limite de requêtes par minute (définie à la création de la clé, 60/min par défaut). Au-delà, l'API répond 429 avec un message précisant la limite configurée.

POST /api/v1/scraping

Lance une recherche de fiches entreprises (Google Maps) et attend la fin du traitement avant de répondre (comptez ~15-25 secondes pour 10 fiches). La requête reste ouverte le temps du traitement, aucun appel supplémentaire n'est nécessaire.

Corps de la requête

{
  "metier": "plombier",
  "ville": "Lyon",
  "maxResults": 10
}

Champ	Type	Description
`metier`	string	Métier ou secteur recherché. Obligatoire.
`ville`	string	Ville ou code postal. Obligatoire.
`maxResults`	integer	Nombre de fiches souhaité (1 à 100).

Réponse (200)

{
  "results": [
    {
      "placeId": "ChIJ...",
      "name": "Plomberie Dupont",
      "category": "Plombier",
      "address": "1 rue de la Paix, 69000 Lyon",
      "city": "Lyon",
      "postalCode": "69000",
      "phone": "0612345678",
      "email": null,
      "website": "https://plomberie-dupont.fr",
      "rating": 4.5,
      "reviewsCount": 12,
      "googleMapsUrl": "https://maps.google.com/?cid=...",
      "socials": null
    }
  ],
  "count": 1
}

GET /api/v1/sirene

Recherche les informations légales (SIRENE/INSEE) d'une entreprise à partir de son nom et de sa localisation.

Paramètres de requête

Paramètre	Description
`nom`	Nom de l'entreprise. Obligatoire.
`ville`	Ville de l'établissement. Optionnel, améliore la précision.
`codePostal`	Code postal. Optionnel, améliore la précision.

GET /api/v1/sirene?nom=Plomberie+Dupont&ville=Lyon&codePostal=69000

Réponse (200)

{
  "sirene": {
    "siren": "123456789",
    "siret": "12345678900012",
    "nomLegal": "PLOMBERIE DUPONT",
    "enseigne": "Plomberie Dupont",
    "dateCreation": "2015-03-01",
    "statut": "Actif",
    "formeJuridique": "SASU",
    "codeNaf": "43.22A",
    "adresse": "1 RUE DE LA PAIX 69000 LYON",
    "nombreEtablissements": 1,
    "effectifs": "1 ou 2 salariés"
  }
}

Si aucune correspondance n'est trouvée, l'API répond 404.

Codes d'erreur

Code	Signification
400	Paramètres manquants ou invalides.
401	Clé API manquante, invalide ou révoquée.
404	Aucun résultat trouvé (endpoint Sirene).
429	Limite de requêtes par minute dépassée.
502 / 504	Erreur ou délai dépassé côté service de recherche — réessayez.