API Entreprises

Cette API permet de rechercher des entreprises en France en utilisant l'API de recherche d'entreprises du gouvernement français.

🚀 Fonctionnalités

🔍 Recherche par localisation (code postal, département, commune)
🏢 Filtrage par activité (code NAF/APE ou libellé)
📊 Filtres avancés : statut, effectif, catégorie d'entreprise
📅 Filtrage par date de création
👤 Filtrage des auto-entrepreneurs

🔗 Endpoints

GET /api/entreprises/recherche

Recherche d'entreprises avec filtres avancés.

Paramètres de recherche :

Paramètre	Type	Description	Exemple
`codePostal`	string	Code postal	`75001`
`departement`	string	Code département (2 chiffres)	`75`
`codeNaf`	string	Code NAF/APE	`43.32A`
`activite`	string	Libellé d'activité	`serrurerie`
`actif`	boolean	Entreprises actives uniquement	`true`
`categorie`	string	Catégorie (PME, ETI, GE, TPE)	`PME`
`autoEntrepreneur`	boolean	Auto-entrepreneurs uniquement	`true`
`trancheEffectif`	string	Code tranche effectif (01-11)	`03`
`dateCreationMin`	date	Date création min (YYYY-MM-DD)	`2023-01-01`
`dateCreationMax`	date	Date création max (YYYY-MM-DD)	`2023-12-31`
`page`	number	Numéro page (défaut: 1)	`2`
`perPage`	number	Résultats par page (max 100, défaut: 20)	`50`

Codes de tranche d'effectif :

Code	Effectif
`01`	0 salarié
`02`	1 à 2 salariés
`03`	3 à 5 salariés
`04`	6 à 9 salariés
`05`	10 à 19 salariés
`06`	20 à 49 salariés
`07`	50 à 99 salariés
`08`	100 à 199 salariés
`09`	200 à 249 salariés
`10`	250 à 499 salariés
`11`	5000+ salariés

Catégories d'entreprises :

TPE : Très petite entreprise
PME : Petite et moyenne entreprise
ETI : Entreprise de taille intermédiaire
GE : Grande entreprise

Exemples :

bash

# Recherche de serruriers à Paris
curl "https://2mnservices.alwaysdata.net/api/entreprises/recherche?codePostal=75001&codeNaf=43.32A&actif=true"

# Recherche d'auto-entrepreneurs dans le 92
curl "https://2mnservices.alwaysdata.net/api/entreprises/recherche?departement=92&autoEntrepreneur=true"

# Recherche de PME créées en 2023
curl "https://2mnservices.alwaysdata.net/api/entreprises/recherche?categorie=PME&dateCreationMin=2023-01-01&dateCreationMax=2023-12-31"

# Pagination
curl "https://2mnservices.alwaysdata.net/api/entreprises/recherche?codePostal=75001&page=2&perPage=50"

Format de réponse :

json

{
  "total": 42,
  "page": 1,
  "perPage": 10,
  "resultats": [
    {
      "siret": "12345678900001",
      "siren": "123456789",
      "nom": "NOM ENTREPRISE",
      "activite": "43.32A",
      "libelleActivite": "SERRURERIE METALLERIE",
      "adresse": {
        "codePostal": "75001",
        "ville": "PARIS 01",
        "adresse": "12 RUE EXAMPLE"
      },
      "statut": "A",
      "dateCreation": "2010-01-01",
      "trancheEffectif": "01",
      "categorieEntreprise": "PME",
      "estEntrepreneurIndividuel": false
    }
  ]
}

GET /api/villes

Recherche de villes par code postal ou nom.

Paramètres :

Paramètre	Type	Description	Exemple
`codePostal`	string	Code postal	`75001`
`nom`	string	Nom de la ville	`Paris`
`departement`	string	Code département	`75`

Exemples :

bash

# Recherche par code postal
curl "https://2mnservices.alwaysdata.net/api/villes?codePostal=75001"

# Recherche par nom
curl "https://2mnservices.alwaysdata.net/api/villes?nom=Paris"

# Recherche par département
curl "https://2mnservices.alwaysdata.net/api/villes?departement=75"

Format de réponse :

json

{
  "nom": "Paris",
  "codeInsee": "75056",
  "codesPostaux": ["75001", "75002", "75003"],
  "population": 2133111,
  "geoloc": {
    "type": "Point",
    "coordinates": [2.3522, 48.8566]
  },
  "departement": {
    "code": "75",
    "nom": "Paris"
  },
  "region": {
    "code": "11",
    "nom": "Île-de-France"
  }
}

🔒 Authentification

Certaines routes peuvent nécessiter une authentification JWT :

bash

# Obtenir un token
POST /api/auth/login
Content-Type: application/json

{
  "email": "votre@email.com",
  "password": "votre_mot_de_passe"
}

Utilisation :

bash

curl -H "Authorization: Bearer <token>" \
  "https://2mnservices.alwaysdata.net/api/entreprises/recherche?codePostal=75001"

📝 Codes NAF courants

Code	Description
`43.32A`	Travaux de serrurerie, métallerie
`43.21A`	Travaux d'installation électrique
`43.22A`	Travaux de plomberie et installation thermique
`45.20B`	Entretien et réparation de véhicules automobiles
`56.30Z`	Débits de boissons
`56.21Z`	Services des traiteurs

Pour une liste complète : nomenclature NAF/APE

⚡ Limites de l'API

Rate limiting : 100 requêtes par 15 minutes
Pagination : Maximum 100 résultats par page
Timeout : 30 secondes par requête

🔗 Liens utiles

API Recherche d'Entreprises - Documentation officielle
API Entreprise - Autres APIs entreprises
NAF/APE - Nomenclature complète