> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nogogo.fr/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nogogo.fr/_mcp/server.

# Search Companies

GET https://companies/search

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.

Reference: https://docs.nogogo.fr/nogogo-fr-api/companies/search-companies

## OpenAPI Specification

```yaml
openapi: 3.1.0
info:
  title: collection
  version: 1.0.0
paths:
  /companies/search:
    get:
      operationId: Search Companies
      summary: Search Companies
      description: >-
        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.
      tags:
        - subpackage_companies
      parameters:
        - name: q
          in: query
          required: false
          schema:
            type: string
        - name: limit
          in: query
          required: false
          schema:
            type: integer
        - name: X-API-Key
          in: header
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Companies_Search Companies_Response_200'
servers:
  - url: https:/
    description: https://{base_url}
components:
  schemas:
    CompaniesSearchGetResponsesContentApplicationJsonSchemaItemsItems:
      type: object
      properties:
        siren:
          type: string
        display_name:
          type: string
        legal_name:
          type: string
        sigle:
          type: string
        activite_principale_libelle:
          type: string
        siege_commune:
          type: string
        is_active:
          type: boolean
        score_global:
          type: integer
        note:
          type: string
        badge_label:
          description: Any type
      required:
        - siren
        - display_name
        - legal_name
        - sigle
        - activite_principale_libelle
        - siege_commune
        - is_active
        - score_global
        - note
      title: CompaniesSearchGetResponsesContentApplicationJsonSchemaItemsItems
    Companies_Search Companies_Response_200:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: >-
              #/components/schemas/CompaniesSearchGetResponsesContentApplicationJsonSchemaItemsItems
        count:
          type: integer
        applied_limit:
          type: integer
      required:
        - items
        - count
        - applied_limit
      title: Companies_Search Companies_Response_200
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

```

## Examples



**Response**

```json
{
  "items": [
    {
      "siren": "802046185",
      "display_name": "LVMH FASHION GROUP SUPPORT",
      "legal_name": "LVMH FASHION GROUP SUPPORT",
      "sigle": "None",
      "activite_principale_libelle": "Activités spécialisées de design",
      "siege_commune": "PARIS",
      "is_active": true,
      "score_global": 89,
      "note": "A"
    },
    {
      "siren": "775670417",
      "display_name": "LVMH MOET HENNESSY LOUIS VUITTON",
      "legal_name": "LVMH MOET HENNESSY LOUIS VUITTON",
      "sigle": "None",
      "activite_principale_libelle": "Activités des sièges sociaux",
      "siege_commune": "PARIS",
      "is_active": true,
      "score_global": 86,
      "note": "A"
    },
    {
      "siren": "501672794",
      "display_name": "LVMH HOTEL MANAGEMENT",
      "legal_name": "LVMH HOTEL MANAGEMENT",
      "sigle": "None",
      "activite_principale_libelle": "Fonds de placement et entités financières similaires",
      "siege_commune": "PARIS",
      "is_active": true,
      "score_global": 85,
      "note": "A"
    },
    {
      "siren": "351524921",
      "display_name": "LVMH MONTRES ET JOAILLERIE FRANCE (TAG HEUER-EBEL-ZENITH-....)",
      "legal_name": "LVMH MONTRES ET JOAILLERIE FRANCE",
      "sigle": "None",
      "activite_principale_libelle": "Commerce de gros d'articles d'horlogerie et de bijouterie",
      "siege_commune": "PARIS",
      "is_active": true,
      "score_global": 82,
      "note": "A"
    },
    {
      "siren": "502888589",
      "display_name": "LVMH METIERS D ART",
      "legal_name": "LVMH METIERS D ART",
      "sigle": "None",
      "activite_principale_libelle": "Activités des sièges sociaux",
      "siege_commune": "PARIS",
      "is_active": true,
      "score_global": 75,
      "note": "B"
    },
    {
      "siren": "922466644",
      "display_name": "LVMH FAMILY STORE",
      "legal_name": "LVMH FAMILY STORE",
      "sigle": "[ND]",
      "activite_principale_libelle": "Vente à distance sur catalogue spécialisé",
      "siege_commune": "PARIS",
      "is_active": true,
      "score_global": 72,
      "note": "B"
    },
    {
      "siren": "931594550",
      "display_name": "LVMH LUXURY VENTURES FUND I",
      "legal_name": "LVMH LUXURY VENTURES FUND I",
      "sigle": "None",
      "activite_principale_libelle": "Gestion de fonds",
      "siege_commune": "PARIS",
      "is_active": true,
      "score_global": 72,
      "note": "B"
    },
    {
      "siren": "979993870",
      "display_name": "LVMH GROUP TREASURY",
      "legal_name": "LVMH GROUP TREASURY",
      "sigle": "None",
      "activite_principale_libelle": "Conseil pour les affaires et autres conseils de gestion",
      "siege_commune": "PARIS",
      "is_active": true,
      "score_global": 71,
      "note": "B"
    },
    {
      "siren": "909816985",
      "display_name": "LVMH LUXURY VENTURES ADVISORS",
      "legal_name": "LVMH LUXURY VENTURES ADVISORS",
      "sigle": "None",
      "activite_principale_libelle": "Conseil pour les affaires et autres conseils de gestion",
      "siege_commune": "PARIS",
      "is_active": true,
      "score_global": 71,
      "note": "B"
    },
    {
      "siren": "814973392",
      "display_name": "LVMH INVESTISSEMENTS",
      "legal_name": "LVMH INVESTISSEMENTS",
      "sigle": "None",
      "activite_principale_libelle": "Activités des sociétés holding",
      "siege_commune": "PARIS",
      "is_active": true,
      "score_global": 68,
      "note": "B"
    }
  ],
  "count": 10,
  "applied_limit": 10
}
```

**SDK Code**

```python Companies_Search Companies_example
import requests

url = "https://https/companies/search"

querystring = {"limit":"10","q":"{{company_query}}"}

headers = {"X-API-Key": "<apiKey>"}

response = requests.get(url, headers=headers, params=querystring)

print(response.json())
```

```javascript Companies_Search Companies_example
const url = 'https://https/companies/search?limit=10&q=%7B%7Bcompany_query%7D%7D';
const options = {method: 'GET', headers: {'X-API-Key': '<apiKey>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Companies_Search Companies_example
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://https/companies/search?limit=10&q=%7B%7Bcompany_query%7D%7D"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<apiKey>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Companies_Search Companies_example
require 'uri'
require 'net/http'

url = URI("https://https/companies/search?limit=10&q=%7B%7Bcompany_query%7D%7D")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<apiKey>'

response = http.request(request)
puts response.read_body
```

```java Companies_Search Companies_example
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://https/companies/search?limit=10&q=%7B%7Bcompany_query%7D%7D")
  .header("X-API-Key", "<apiKey>")
  .asString();
```

```php Companies_Search Companies_example
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://https/companies/search?limit=10&q=%7B%7Bcompany_query%7D%7D', [
  'headers' => [
    'X-API-Key' => '<apiKey>',
  ],
]);

echo $response->getBody();
```

```csharp Companies_Search Companies_example
using RestSharp;

var client = new RestClient("https://https/companies/search?limit=10&q=%7B%7Bcompany_query%7D%7D");
var request = new RestRequest(Method.GET);
request.AddHeader("X-API-Key", "<apiKey>");
IRestResponse response = client.Execute(request);
```

```swift Companies_Search Companies_example
import Foundation

let headers = ["X-API-Key": "<apiKey>"]

let request = NSMutableURLRequest(url: NSURL(string: "https://https/companies/search?limit=10&q=%7B%7Bcompany_query%7D%7D")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```