Suggestions d'Entreprises

L'API de Suggestions d'Entreprises vous permet de récupérer des correspondances potentielles d'entreprises basées sur une requête de recherche. Ceci est utile pour implémenter des fonctionnalités d'autocomplétion ou aider les utilisateurs à trouver des entreprises spécifiques dans la base de données.

GET/api/suggestions/entreprises/

Lister les suggestions d'entreprises

Ce point de terminaison permet de récupérer une liste de suggestions d'entreprises basée sur une requête de recherche.

Paramètres de Requête

Name: q
Type: string
Required: REQUIS
Description: La chaîne de requête de recherche. Peut être un nom d'entreprise, un SIREN ou un fragment de SIRET.

Name: longueur
Type: integer
Description: Limite le nombre de suggestions retournées. Défaut est 10, maximum est 100.

Name: cibles_entreprise
Type: string
Description: Liste de champs séparés par des virgules dans lesquels rechercher. Valeurs autorisées : nom_entreprise, denomination, nom_complet, representant, siren, siret. Défaut est denomination.

Requête


curl -G https://origami.holofin.ai/api/suggestions/entreprises/ \
  -d q="boulangerie" \
  -d longueur=5 \
  -d cibles_entreprise="denomination,siren"

Réponse

Retourne un objet JSON contenant une liste de suggestions d'entreprises sous la clé entreprises. Si aucune correspondance n'est trouvée, retourne un objet JSON vide {}.


{
  "entreprises": [
    {
      "mention": "<em>Boulangerie</em> du Coin",
      "siren": "123456789",
      "siren_formate": "123 456 789",
      "diffusable": true,
      "nom_entreprise": "BOULANGERIE DU COIN",
      "personne_morale": true,
      "type_personne": "morale",
      "denomination": "BOULANGERIE DU COIN",
      "nom": null,
      "prenom": null,
      "sexe": null,
      "entreprise_cessee": 0,
      "statut": "actif",
      "statut_rne": "inscrit",
      "statut_rcs": "inscrit",
      "statut_consolide": "actif",
      "categorie_juridique": "5710",
      "forme_juridique": "Société à responsabilité limitée (SARL)",
      "date_creation": "2010-05-15",
      "date_creation_formate": "15/05/2010",
      "code_naf": "1071C",
      "libelle_code_naf": "Boulangerie et boulangerie-pâtisserie",
      "domaine_activite": "Industries alimentaires",
      "siege": {
        "siret": "12345678900010",
        "siret_formate": "123 456 789 00010",
        "nic": "00010",
        "numero_voie": 10,
        "indice_repetition": null,
        "type_voie": "RUE",
        "libelle_voie": "DE LA PAIX",
        "complement_adresse": null,
        "adresse_ligne_1": "10 RUE DE LA PAIX",
        "adresse_ligne_2": null,
        "code_postal": "75002",
        "code_commune": "75102",
        "ville": "PARIS 2",
        "pays": "France",
        "code_pays": "FR"
      },
      "villes": ["PARIS 2", "LYON"],
      "date_cessation": null,
      "entreprise_employeuse": 1,
      "tranche_effectif": "03",
      "effectif": "3 à 5 salariés",
      "effectif_min": 3,
      "effectif_max": 5,
      "economie_sociale_et_solidaire": false,
      "annee_effectif": 2022,
      "association": null
    },
    {
      "mention": "La <em>Boulangerie</em> d'Antan",
      "siren": "987654321",
      "siren_formate": "987 654 321",
      // ... autres champs ...
    }
  ]
}