How to Access Spain's Official Company Registry Programmatically (Yes, It's Possible)

Spain has one of Europe's most important business registries. The Registro Mercantil tracks over 3 million companies, and until recently, getting programmatic access meant either paying enterprise subscription fees or spending your days clicking through government portals.

In 2024, the Colegio de Registradores launched OpenData Registradores -- an open data portal with free access to company profiles. It was great news. Except for one thing: there's no API.

This article walks through exactly what data is available, why there's no API, and how you can access it programmatically through Apify.

What's in Spain's Company Registry

The Registro Mercantil is Spain's equivalent of Companies House. Every Spanish company must register here. The data includes:

• NIF/CIF -- the Spanish tax identifier that every company must have
• Officers and directors -- administrators, legal representatives, with roles and appointment dates
• CNAE codes -- industry classification (Spain's version of SIC/NAICS)
• Legal form -- SL (limited), SA (public limited), and variants
• Registered address -- with province, municipality, and postal code
• Company status -- active, dissolved, in liquidation
• IRUS and EUID -- European cross-border identifiers

This is the authoritative source. Not a third-party aggregator, not scraped from web directories -- this comes straight from the official commercial register.

The Problem: No API. And a Web Application Firewall.

Spain's Colegio de Registradores built OpenData Registradores in 2024 as a public-facing web portal. It runs on Liferay, sits behind an F5/Volterra Web Application Firewall, and blocks all datacenter IP addresses.

This means:

• No REST API exists -- there is no endpoint to call
• Standard Apify datacenter proxies get blocked instantly
• You need residential proxies to get through (requires a paid Apify plan)
• The site uses anti-bot detection that catches headless browsers

Kyckr's 2026 guide on Spanish registry access puts it bluntly: the registry is "challenging to use" and sits "behind a paywall" for any kind of automated access. They're right -- if you try to DIY this, you'll spend weeks fighting the WAF.

What Do Companies Use Instead?

Most companies access Spanish registry data through one of three routes:

1. Enterprise subscriptions (expensive)

Axesor, Informa D&B Spain, and eInforma all provide Spanish company data. But they charge annual contracts -- typically thousands of euros -- and bundle their own proprietary scoring on top. If you just need the raw registry data for a few hundred lookups per month, you're overpaying dramatically.

2. Manual government portals (slow)

You can search the Registro Mercantil directly at sede.registradores.org. It works. But it's one company at a time, through a web form, and you get a PDF or HTML page back. Not exactly pipeline-friendly.

3. KYC/KYB verification services (narrow)

Companies like Verifik, Vove, and KYC Chain offer Spanish company verification as part of broader identity products. They work well for simple "is this company real?" checks. But they don't give you the full profile -- officers, CNAE codes, address details, EU cross-border identifiers. You get a verification result, not structured data.

The Fourth Option: Pay-Per-Result API Access

Our Spain Company Directory Scraper on Apify solves two problems at once:

1. It handles the WAF -- residential proxy configuration, stealth browser fingerprinting, anti-bot bypass. You don't need to think about it.
2. It returns structured JSON -- not HTML, not PDFs. Clean, parseable data ready to feed into your pipeline.

And it operates on pay-per-result pricing: $0.005 per company lookup on the free tier, $0.003 on paid Apify plans. No subscription, no minimum commitment.

How to Use It

You can search by company name and get back structured data:

import requests

API_URL = "https://api.apify.com/v2/acts/regdata~spain-company-directory-scraper/runs"
API_TOKEN = "your-apify-token"

response = requests.post(
    f"{API_URL}?token={API_TOKEN}",
    json={
        "searchQuery": "Telefonica",
        "maxResults": 5
    }
)

run_id = response.json()["data"]["id"]

Or via the Apify CLI:

apify call regdata/spain-company-directory-scraper \
  --input '{"searchQuery": "Telefonica", "maxResults": 5}'

The output gives you each company's full profile:

{
  "nif": "A82018474",
  "companyName": "TELEFONICA SA",
  "legalForm": "Sociedad Anonima",
  "status": "Active",
  "address": {
    "street": "Gran Via 28",
    "municipality": "Madrid",
    "province": "Madrid",
    "postalCode": "28013"
  },
  "officers": [
    {
      "name": "Jose Maria Alvarez-Pallete Lopez",
      "role": "Presidente / Consejero Delegado",
      "appointmentDate": "2016-04-08"
    }
  ],
  "cnaeCodes": [
    {
      "code": "6190",
      "description": "Otras actividades de telecomunicaciones"
    }
  ],
  "euid": "ESMA190049.8NFjxTeLZSbQ1sve9",
  "irus": "18000000001234"
}

Real Use Cases

KYC/KYB Compliance

Spanish regulation (Ley 10/2010 on money laundering prevention) requires verifying counterparty identity. You need NIF, legal form, officers, and status -- all of which OpenData Registradores provides. Doing 100 KYB checks manually through the government portal takes hours. Doing them through an API takes minutes.

B2B Sales Targeting Spain

Spain's CNAE classification system is granular -- over 500 industry codes. If you're selling to, say, logistics companies (CNAE 4941 -- "Transporte de mercancías por carretera"), you can batch-search known company names and enrich your CRM with verified NIF, address, and legal form data.

M&A Due Diligence

Before acquiring a Spanish company, you need to confirm its legal form, officer structure, and status directly from the official registry. Third-party aggregators can have stale data -- the Registro Mercantil is the source of truth. Our actor pulls from the official open data portal, not a cached database.

Cross-Border EU Compliance

The EUID (European Unique Identifier) and IRUS fields in the output are particularly useful for cross-border work. Under the EU Business Registers Interconnection System (BRIS), these identifiers link Spanish companies to their counterparts in other member states.

Important: You Need a Paid Apify Plan

This is not a free-tier actor. The F5/Volterra WAF on opendata.registradores.org blocks all datacenter proxies. You need:

• An Apify paid plan (Starter at $49/month or higher)
• Residential proxy enabled in actor settings

Once configured, it works reliably. But it's worth setting expectations up front: this is the cost of accessing a government portal that actively blocks automated access.

How It Compares

Solution	Pricing	API Access?	Data Source
Our Apify actor	$0.005/lookup	Yes (JSON)	Official Registro Mercantil
Axesor	€2,000+/year	Partial	Proprietary + registry
Informa D&B Spain	€3,000+/year	Yes	Proprietary + registry
Manual portal	Free	No	Official registry
Verifik/KYC Chain	Per-check	Yes (verification only)	Hybrid

For occasional or moderate-volume use -- anywhere from 10 to 1,000 lookups per month -- the pay-per-result model is dramatically cheaper than enterprise subscriptions. At 100 lookups per month, you're paying $0.50 with our actor vs. $167-250/month on enterprise plans.

Bottom Line

Spain's company registry data is publicly available but programmatically inaccessible. OpenData Registradores was a step forward in transparency, but the lack of an API and the aggressive WAF make automation genuinely difficult.

If you need Spanish company data in your pipeline -- whether for KYB compliance, sales enrichment, or due diligence -- the Spain Company Directory Scraper on Apify is the most cost-effective way to get it.

Try it on Apify Store

---

This article is part of our European Business Data Suite -- 14 actors covering company registries across Poland, Spain, Austria, and France. All pay-per-result, no subscriptions.