Our prices
Price list for single API calls
- Search Company (id only) € 0,00 + vat
- Search Start Company - FR € 0,05 + vat
- Advanced Company Search - France € 0,10 + vat
Company Search - France
- Home
- Business Information
- Company Search - France
Evasione :
Immediate
-
starting from € 0,00 + vat
Get real-time listings of French companies with enriched data by selecting from over 15 parameters.
Company Search France allows you to create a list of companies within a geographical area, city, department or region and select parameters such as turnover, NAF Activity Code, number of employees
Search Company FR is an effective search tool that allows, starting from over 20 parameters, obtaining a list of all French companies matching 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 (officeType): registered or branch (if not specified, all types)
- Last Update Date
These parameters can be freely combined to obtain a more relevant list of business contacts.
Additionally, by using Search, it is possible to identify companies where an individual or legal entity is a shareholder, simply using their tax code as a reference.
An interesting feature is the "dataEnrichment" parameter, which allows specifying the type of dataset desired in the response:
- No parameter: If no parameter is specified, a list of company IDs will be returned, which can be used to request information through other Company endpoints.
- Start: For each company matching the parameters, this option will return all the information from the "start" endpoint: company name, alias name, Siret and Siren codes, VAT ID, registration date, and the registered office address with geocoordinates.
- Advanced: Provides the same data as "start," enriched with additional information such as other operating unit addresses, 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.
EXAMPLE REQUEST GET /FR-search
Here is an example of a call using the following parameters:
- Data Enrichment 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
- Company Status: Active
- Limit: 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
EXAMPLE RESPONSE 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 (place name, street, address, municipality, hamlet, province, ZIP code)
- Registered Office Geographic Coordinates (longitude and latitude)
- Registered Office Cadastre Code
- Sdi Code and update
- Activity Status
- Timestamp creation (company creation date in database)
- Timestamp last update (last company update date)
- Registration date at the Chamber of Commerce
- Internal Company Identifier (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 shown in the response example is for demonstration purposes only.
The cost is charged based on the number of companies included in the response. Before making the request, it is possible to get a count of the available results using the parameter “dry_run”.
The search without parameters or with the dry_run parameter has a daily free request limit of 100. Beyond this limit, the cost will be 0.01€ per request.
To prevent potential errors, the service also imposes a default maximum result limit of 1000 results. The number of results can be further reduced using the parameter “limit”, where the desired number of results can be specified.
If the response includes more than 1000 companies, it is possible to obtain all results with multiple requests by using the “skip” parameter, which specifies the number of results to be “skipped.”
For example, if a request yields 1500 companies, the first call will return the first 1000. The second call, specifying the skip parameter with a value of 1000 (skipping the first 1000 already retrieved), will return the remaining 500.
Search is commonly used for sector-specific market investigations or marketing activities.