Documentation API

Passez une entrée brute (nom + adresse) comme sur la page web. L'API parse automatiquement, interroge le registre national, scrape la fiche Google Business et recherche les emails — tout en un seul appel.

Paramètres

Exemples

# Nom + adresse complète
curl -H "X-API-Key: cw_votre_cle" \
  "http://localhost:8000/api/search?q=FEVRE-VIELLARD+PAYSAGE+-+50+Route+De+Dijon+21470+Brazey-En-Plaine"

# Nom + code postal
curl -H "X-API-Key: cw_votre_cle" \
  "http://localhost:8000/api/search?q=ESE+France+SAS+71530+Crissey"

# Juste le nom
curl -H "X-API-Key: cw_votre_cle" \
  "http://localhost:8000/api/search?q=ESE+France"

Réponse

{
  "query": "FEVRE-VIELLARD PAYSAGE - 50 Route De Dijon 21470 Brazey-En-Plaine",
  "parsed": {
    "nom": "FEVRE-VIELLARD PAYSAGE",
    "nom_clean": null,
    "code_postal": "21470",
    "commune": "Brazey-En-Plaine"
  },
  "total": 1,
  "from_cache": false,
  "results": [
    {
      "nom": "FEVRE-VIELLARD PAYSAGE",
      "siren": "123456789",
      "siret_siege": "12345678900012",
      "forme_juridique": "5710",
      "libelle_forme_juridique": "SAS",
      "date_creation": "2010-01-15",
      "activite_principale": "81.30Z",
      "libelle_activite": "Services d'aménagement paysager",
      "tranche_effectif": "11",
      "libelle_tranche_effectif": "10 à 19 salariés",
      "adresse_ligne1": "50 Route De Dijon",
      "adresse_ligne2": "21470 Brazey-En-Plaine",
      "commune": "Brazey-En-Plaine",
      "code_postal": "21470",
      "departement": "21",
      "region": "Bourgogne-Franche-Comté",
      "dirigeants": [
        { "nom": "Jean Dupont", "qualite": "Président" }
      ],
      "nombre_etablissements": 1,
      "nombre_etablissements_ouverts": 1,
      "etat_administratif": "A",
      "categorie_entreprise": "PME"
    }
  ],
  "google": {
    "found": true,
    "name": "Fevre-Viellard Paysage",
    "address": "50 Rte de Dijon, 21470 Brazey-en-Plaine",
    "phone": "03 80 XX XX XX",
    "website": "https://www.example.com",
    "rating": 4.5,
    "reviews_count": 12,
    "category": "Paysagiste",
    "hours": { "lundi": "8:00-17:00", "mardi": "8:00-17:00" }
  },
  "emails": {
    "found": true,
    "emails": ["contact@example.com", "info@example.com"],
    "source": "https://www.example.com/contact"
  }
}