Search companies by name
search_companiesFind companies by name in the official registers of France and Spain, 10 per page. Use it when you know a name but no ID, then call lookup_company or verify_company with an ID from the results. Don't use it when you already have an official ID. Inputs: country FR or ES; query, 2 to 200 characters ('telefonica'). Optional: postal_code, locality, status, jurisdiction (regional registers), page, format; limit (up to 100 rows) with a file format. Returns: best match first, each with match.score (0-1) and reasons, name, status, address, IDs, provenance; meta.next_page. Limits: 2 units a page; files 2 per started 25 rows. Read-only. France: insolvency from BODACC since 2008. Spain: BORME acts since 2 January 2009. No person's name in any answer. Search words: SIREN, RCS, Annuaire des Entreprises, société; BORME, Registro Mercantil, empresa, sociedad, KYB, supplier check.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Results page, 10 per page. | |
| limit | No | Rows in one file, up to 100, with a non-json format only. 2 units per started 25 rows (100 rows = 8 units). | |
| query | Yes | Company name, 2 to 200 characters. | |
| format | No | Answer format: json (default); csv, tsv, markdown, html (table), xml or ndjson come back inline, one row per company with source and fetched_at; xlsx or parquet as a download link valid 24 hours. Same units; search takes limit (up to 100 rows) with a non-json format. | json |
| status | No | Only companies with this status. | |
| country | Yes | ISO country code: FR or ES. | |
| locality | No | Registered-office town filter (Spain). | |
| postal_code | No | Registered-office postal code filter. | |
| jurisdiction | No | Optional ISO 3166-2 region to search in, for countries with regional registers (list_coverage lists them). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | ||
| meta | Yes |