einforma.com APIeinforma.com ↗
Search Spanish companies, autónomos, and executives on einforma.com. Get NIF, CNAE, province, sales data, and available report products via 4 endpoints.
curl -X GET 'https://api.parse.bot/scraper/0dbd141e-b0b3-421c-acf4-dd335ceecf5c/search_companies?rows=5&query=Telefonica&start=0' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for companies (empresas) by name, NIF/CIF, or DUNS number. Returns paginated results with facets for filtering by province, sector, legal form, and denomination type.
| Param | Type | Description |
|---|---|---|
| rows | integer | Number of results per page. |
| queryrequired | string | Search term (company name, NIF, or DUNS number). |
| start | integer | Starting offset for pagination. |
| filters | string | JSON object string containing filters. Keys include codProvinci (province code, e.g. '{"codProvinci": "(28)"}' for Madrid). |
{
"type": "object",
"fields": {
"total": "integer total number of matching companies",
"facets": "object containing filtering facets (codSector, formaJuridica, codTipoDeno, codProvinci)",
"results": "array of company objects with fields: denominacion, nif, provincia, cnae, codCnae, id, ventas, codProvincia, tipoDenominacion"
},
"sample": {
"data": {
"total": 2155,
"facets": {
"codSector": {
"data": [
{
"cod": "08",
"name": "Telecomunicaciones",
"count": "1.152"
}
],
"title": "Actividad"
}
},
"results": [
{
"id": "kLfOC5ZktKdR5Ub9ALlHug",
"cnae": "Actividades de las sociedades holding",
"ventas": "GRAN",
"codCnae": "6420",
"provincia": "Madrid",
"codVidaDeno": "00",
"codProvincia": "28",
"denominacion": "TELEFONICA, SA",
"tipoDenominacion": "Denominación principal",
"denominacionBusqueda": "TELEFONICA, SA"
}
]
},
"status": "success"
}
}About the einforma.com API
The Einforma API provides 4 endpoints to query Spain's business directory, covering companies, self-employed individuals (autónomos), and executives. The search_companies endpoint returns structured fields including NIF/CIF, CNAE sector code, province, and annual sales figures, with facet-based filtering by province, legal form, and sector. Company IDs from search results feed directly into get_company_detail to retrieve available report products.
Company and Autónomo Search
The search_companies endpoint accepts a query string (company name, NIF/CIF, or DUNS number) and returns a paginated list of matching Spanish companies. Each result includes denominacion, nif, provincia, codCnae (sector code), ventas (sales), and a unique id. Pagination is controlled via rows and start. Results can be narrowed using the filters parameter — a JSON string accepting keys like codProvinci to restrict results to a specific Spanish province. The response also includes a facets object with breakdowns by sector (codSector), legal form (formaJuridica), denomination type (codTipoDeno), and province (codProvinci), which are useful for building dynamic filter UIs.
The search_autonomos endpoint follows the same pagination pattern but targets self-employed individuals rather than registered companies. Results include denominacion, cnae, codCnae, provincia, and codProvincia. Unlike search_companies, it does not support facet filtering or the filters parameter.
Executive Search and Company Detail
The search_executives endpoint searches for named directors and administrators across the Spanish business registry. Results return nombreAdm (executive name), denominacion (associated company name), and countAdm (the number of companies that individual administers) — useful for mapping executive relationships across multiple entities.
Once a company id is obtained from search_companies, get_company_detail retrieves the catalog of purchasable reports available on einforma.com for that entity, returned as a listaProductos array with pricing and availability metadata. Full financial records, director lists, and filing history are not returned directly — they are gated behind report purchases on the platform. The outResponse object in the response carries result codes (result.rdo, result.codRdo) indicating the API call status.
- Build a prospecting tool that filters Spanish companies by province (
codProvinci) and CNAE sector code to identify industry-specific leads - Verify a Spanish company's NIF/CIF by querying
search_companiesand matching the returnedniffield against a known identifier - Map an executive's corporate footprint by searching
search_executivesfor a name and inspectingcountAdmacross returned results - Enrich a CRM with
ventas(annual sales) andprovinciadata pulled fromsearch_companiesresults - Check which einforma.com reports are available for a specific company using
get_company_detailbefore initiating a purchase workflow - Cross-reference autónomo registrations with company records by running parallel queries across
search_autonomosandsearch_companiesusing the same NIF - Aggregate sector-level statistics from the
facets.codSectorobject returned bysearch_companiesfor market sizing research
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does einforma.com have an official developer API?+
What does `get_company_detail` actually return — can I get financials or director lists directly?+
listaProductos array, which lists available report products (with pricing and availability) for that company on the einforma.com platform. Full financial statements, director lists, and filing history are gated behind those purchasable reports and are not returned as structured fields. The outResponse object includes status codes (result.rdo, result.codRdo) confirming the API call result.Can I filter `search_autonomos` results by province or sector the way I can with `search_companies`?+
search_autonomos endpoint supports only query, rows, and start — there is no filters parameter and no facets object in the response. search_companies is the endpoint that supports province and sector filtering via the filters JSON string and returns facet breakdowns. You can fork this API on Parse and revise it to add province filtering to the autónomos endpoint.Does the executive search return contact details like email or phone for directors?+
search_executives endpoint returns nombreAdm (name), denominacion (associated company), and countAdm (number of companies administered). No contact information is exposed. You can fork this API on Parse and revise it to add a dedicated executive detail endpoint if deeper director data becomes available.How does pagination work across the search endpoints?+
search_companies, search_autonomos, search_executives) use rows (results per page) and start (zero-based offset) for pagination. The total field in the response indicates the full result count, so you can calculate the number of pages needed. There is no cursor-based pagination — offset-based navigation is the only supported method.