---
title: "Search Companies"
method: GET
path: "/companies/search"
tags: ["companies"]
---

# Search Companies

`GET /companies/search`

## Request

- Base URL: `https://docs.nogogo.fr`
- URL: `https://docs.nogogo.fr/companies/search`
- Auth: API key in header `X-API-Key`

Recherche des entreprises françaises par nom, SIREN ou requête partielle.

Cet endpoint est utile lorsque l’utilisateur ne connaît pas encore le SIREN exact d’une entreprise.

Il peut être utilisé pour l’enrichissement CRM, les workflows d’onboarding, la recherche client/fournisseur, les automatisations no-code/low-code et les interfaces de recherche d’entreprise.

## Paramètres de requête

| Paramètre | Obligatoire | Description |
| --- | --- | --- |
| `q` | Oui | Requête de recherche. Peut contenir un nom d’entreprise, un SIREN ou un nom partiel. Minimum 3 caractères. |
| `limit` | Non | Nombre maximum de résultats à retourner. Exemple : `10` |

## Données retournées possibles

- `items`
    
- `count`
    
- `applied_limit`
    
- `siren`
    
- `display_name`
    
- `legal_name`
    
- `is_active`
    
- `score_global`
    
- `note`
    
- `badge_label`
    
- `siege_commune`
    

Certains champs peuvent être `null` selon la disponibilité des données publiques et l’offre API utilisée.

## Query parameters

- `q` string
- `limit` integer

## Response `200`

OK

- CompaniesSearchCompaniesResponse200
  - `items` CompaniesSearchGetResponsesContentApplicationJsonSchemaItemsItems[], required
    - `siren` string, required
    - `display_name` string, required
    - `legal_name` string, required
    - `sigle` string, required
    - `activite_principale_libelle` string, required
    - `siege_commune` string, required
    - `is_active` boolean, required
    - `score_global` integer, required
    - `note` string, required
    - `badge_label` unknown
  - `count` integer, required
  - `applied_limit` integer, required

---

[API](https://skmtc.dev/nogogo/apis/nogogo-fr-api.md) · [All operations](https://skmtc.dev/nogogo/apis/nogogo-fr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nogogo/apis/nogogo-fr-api/revisions/bc3b87e4a388?raw)