HomeProductsCompany Search - France

Company Search - France

NEW

FREE 100 requests/day

€0.01 + VAT

FREE requests

Search Company France provides real-time access to lists of French companies with enriched data by selecting from more than 15 parameters such as city, department or region and selecting parameters such as turnover, NAF Activity Code, number of employees.

Delivery

In real time

available for
  • fr

Search Company FR is an effective search tool that allows, starting from more than 20 parameters, to obtain the list of all French companies corresponding to those criteria.

The available parameters for Search Company France requests are:

  • Company Name (or part of its terms),
  • Region
  • Department
  • City
  • City Code
  • Longitude, Latitude, and Radius
  • Activity Code (NAF Code)
  • Revenue (min. / max.)
  • Employees (min. / max.)
  • Legal Form Code
  • Creditworthy
  • Activity Status (Active, Closed)
  • Office Type: registered or branch (if not specified, all types)
  • Last Update Date

These parameters can be freely combined to get a more relevant list of business contacts.

Furthermore, using Search, it is possible to identify the companies where an individual or a legal entity is a partner, simply by using the tax code as a reference.

Another interesting aspect is the "dataEnrichment" parameter, which allows specifying the type of dataset desired in the response:

  • No parameter: if specified, it will return a list of company IDs that can be used to request information through other Company endpoints
  • Start: will return for each company matching the parameters all the information of the start endpoint: name, alias name, Siret and Siren codes, VAT ID, registration date, registered office address with geocoordinates
  • Advanced: will provide the same data as start enriched with information such as addresses of other operational units, creditworthiness, legal nature, French and European activity classification, revenue, profits, employees, and EBITDA

Search is identified by the endpoint: GET https://company.openapi.com/FR-search.

REQUEST EXAMPLE

GET /FR-search

This is an example of a call using the following parameters:

  • Data Enrichment of type: Advanced
  • NAF Code: 6201Z (Computer Programming)
  • City: Paris
  • Minimum Revenue: 100,000 and Maximum Revenue: 1,000,000
  • Minimum Employees: 5 and Maximum Employees: 100
  • Active Company Status
  • Limit to 2 results
https://company.openapi.com/FR-search?dryRun=0&dataEnrichment=advanced&town=Paris&nafCode=6201Z&minTurnover=100000&maxTurnover=1000000&minEmployees=5&maxEmployees=50&activityStatus=ACTIVE&limit=2

RESPONSE EXAMPLE

GET /IT-search

The response returns a list of companies matching the specified parameters and the selected dataset (start):

  • Tax Code
  • Company Name
  • VAT Number
  • Registered Office Address (toponym, street, address, city, hamlet, province, postal code)
  • Geographical Coordinates of Registered Office (longitude and latitude)
  • Cadastral Code of the office
  • Sdi Code and update
  • Activity Status
  • Timestamp creation (company creation date in database)
  • Timestamp last update (last modification date of the company)
  • Chamber of Commerce registration date
  • Internal company ID (ID)
{
    "data": {
        "siretCode": "7XXXXXXXXXXXX0",
        "companyName": "Nome Azienda",
        "tradingName": "null",
        "aliasName": "null",
        "sirenCode": "7XXXXXXXX",
        "coCode": "FR7XXXXXXXX",
        "activityStatus": "ACTIVE",
        "creditWorthy": 1,
        "registrationDate": "2013-07-01",
        "vatCode":  "FR7XXXXXXXXX",
        "address": {
          "registeredOffice": {
            "street": "RUE xxxxx",
            "streetNumber": "11",
            "streetName": "11 RUE xxxxx",
            "streetName2": null,
            "streetName3": null,
            "streetName4": "75002 PARIS",
            "town": "PARIS",
            "zipCode": "75002",
            "country": "FR",
            "gps": {
              "coordinates": [
              2.30815,
              48.870742
              ]
            },
            "townCode":"75102",
            "department": {
              "code": "75",
              "description": "Paris",
            },
            "region": {
              "description": "Île-de-France",
              "code": "11",
            },
            "internationalClassification": {
              "naf": {
                "code": "6201Z",
                "description": "Programmation informatique"
              },
              "nace": {
                "code": "6201",
                "description": "Computer programming activities"
              }
            },
            "detailedLegalForm": {
              "code": "SA et autes",
              "description": null
            },
            "balanceSheets": {
              "last": {
                "year": 2022,
                "balanceSheetDate": "2022-12-31",
                "turnover": 9900,
                "netWorth": -21164,
                "employees": 1
              },
              "all": [
                {
                  "year": 2022,
                  "balanceSheetDate": "2022-12-31",
                  "turnover": 9900,
                  "netWorth": -21164,
                  "employees": 1
                }
              ]
            },
      "creationTimestamp": 1724544000,
      "lastUpdateTimestamp": 1724544000,
      "id": "672a26f3cc42ced63a092dd5",
      "allOffices": []
      },
      {
      "siretCode": "8XXXXXXXXXXXX1",
      "companyName": "Nome Azienda",
      "tradingName": "null",
      "aliasName": "null",
      "sirenCode": "8XXXXXXXX",
      "coCode": "FR8XXXXXXX1",
      "activityStatus": "ACTIVE",
      "creditWorthy": "1",
      "registrationDate": "2019-10-01",
      "vatCode":  "FR038XXXXXX",
      "address": {
        "registeredOffice": {
          "street": "ROUTE DES xxxxx",
          "streetNumber": "70",
          "streetName": "70 ROUTE DES xxxxx",
          "streetName2": null,
          "streetName3": null,
          "streetName4": "75008 PARIS",
          "town": "PARIS",
          "zipCode": "75008",
          "country": "FR",
          "gps": {
            "coordinates": [
            2.30815,
            48.870742
            ]
          },
          "townCode":"75108",
          "department": {
            "code": "75",
            "description": "Paris",
          },
          "region": {
            "description": "Île-de-France",
            "code": "11",
          },
          "internationalClassification": {
            "naf": {
              "code": "6201Z",
              "description": "Programmation informatique"
            },
            "nace": {
              "code": "6201",
              "description": "Computer programming activities"
            }
          },
          "detailedLegalForm": {
            "code": "SA et autes",
            "description": null
          },
          "balanceSheets": {
            "last": {
              "year": 2023,
              "balanceSheetDate": "2023-12-31",
              "turnover": 273300,
              "netWorth": -184787,
              "employees": 50
            },
            "all": [
              {
                "year": 2017,
                "balanceSheetDate": "2017-12-31",
                "turnover": 273300,
                "netWorth": -184787,
                "employees": 50
              }
            ]
          },
    "creationTimestamp": 1724544000,
    "lastUpdateTimestamp": 1724544000,
    "id": "672a26f3cc42ced63a092dd5",
    "allOffices": [] 
    "success": true,
    "message": "",
    "error": null
    }

The data in the response example is for illustrative purposes only.

The cost is charged based on the number of companies present in the response. Before making the call, it is possible to get the count of available results using the parameter “dry_run”.

Searches without a parameter or with the dry run parameter have a daily limit of 100 free requests. Exceeding this limit will incur a cost of 0.01€ per request.

To prevent potential errors, the service also sets a default maximum limit of 1000 results. This limit can be further reduced using the parameter “limit”, which specifies the desired number of results.

If the response includes more than 1000 companies, it is possible to retrieve all results with multiple calls using the “skip” parameter, which indicates the number of results to “skip”.

For example, if a request is expected to return 1500 companies, the first call will retrieve the first 1000. The second call, specifying the skip parameter with the value 1000 (indicating that the first 1000 results from the initial call should be skipped), will return the remaining 500.

Search is used, for instance, for sectoral market research or marketing activities.

Sign Up

Do you need help?

Haven't found the answer you're looking for?

Fill in all the details, we will get back to you as soon as possible!