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.
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:
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:
Search is identified by the endpoint: GET https://company.openapi.com/FR-search.
GET /FR-search
This is an example of a call using the following parameters:
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
GET /IT-search
The response returns a list of companies matching the specified parameters and the selected dataset (start):
{
"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.
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!