APIs y fuentes de datos CNAE/IAE en España (2026): comparativa honesta

En España, las fuentes de datos CNAE/IAE disponibles a fecha de junio de 2026 son cinco: las descargas oficiales del INE con la clasificación CNAE 2025, las tarifas del IAE publicadas por la AEAT y el BOE, los datasets de datos.gob.es, el scraping de webs de terceros y las APIs especializadas como la del Conversor IAE-CNAE. Esta comparativa analiza cada opción con sus cuándo-sí y cuándo-no, sin adornos.

Las cinco fuentes, de un vistazo

• Descargas oficiales del INE: la fuente canónica para la tabla CNAE 2025 en bruto; gratis, oficial y estática.
• Tarifas del IAE en la AEAT y el BOE: la referencia normativa para el texto legal de cada epígrafe; pensada para lectura humana, no para máquinas.
• datos.gob.es: catálogo de datasets complementarios; no ofrece una correspondencia IAE-CNAE lista para usar.
• Scraping de webs de terceros: frágil, costoso de mantener y en zona legal gris; solo para prototipos desechables.
• API del Conversor IAE-CNAE: consulta bajo demanda, búsqueda en lenguaje natural y correspondencias resueltas; con plan gratuito y de pago.

Descargas oficiales del INE

El INE publica la clasificación CNAE 2025 completa en descargas gratuitas, en formatos de hoja de cálculo. Es la fuente oficial y la referencia última para cualquier sistema que necesite la estructura de la clasificación estadística. A fecha de junio de 2026, estas descargas están disponibles en la web del INE y cubren todos los niveles de desagregación del CNAE 2025.

Cuándo sí elegir el INE

Elige las descargas del INE cuando tu necesidad es puntual y única: cargar la tabla CNAE 2025 en tu base de datos una vez y seguir con tu desarrollo. Es gratis, es oficial y no dependes de terceros. Si tu producto solo necesita mostrar la descripción de un código CNAE a partir de un desplegable que tú mismo poblaste, este es el camino más directo y no necesitas nada más.

Cuándo no

No elijas el INE si necesitas correspondencias IAE-CNAE. El IAE es una clasificación tributaria de la AEAT y el CNAE es una clasificación estadística del INE; son organismos distintos y no existe una tabla oficial que las cruce. Las descargas del INE tampoco ofrecen búsqueda por descripción en lenguaje natural: son ficheros estáticos cuyas actualizaciones debes vigilar y recargar a mano. El INE ofrece un codificador web interactivo (CODIA), pero no una API pública de consulta código a código.

Tarifas del IAE en la AEAT y el BOE

Las tarifas y la instrucción del Impuesto de Actividades Económicas se publican en el BOE, y la AEAT publica los criterios de aplicación en su sede electrónica. Son la fuente normativa de referencia para los 1.186 epígrafes IAE, a fecha de junio de 2026. Cualquier duda sobre el alcance de un epígrafe, sus notas o sus límites se resuelve aquí.

Cuándo sí

Elige esta fuente cuando necesitas el texto legal exacto de un epígrafe IAE: sus notas, las facultades que otorga, los límites o las exclusiones. Es imprescindible para resolver una duda normativa. Si tu producto debe mostrar el texto literal del BOE como fuente primaria, este es el origen que debes citar.

Cuándo no

No elijas esta fuente como base de datos estructurada. Los documentos son PDFs y páginas web pensadas para lectura humana. Extraer los 1.186 epígrafes IAE a una base de datos exige un trabajo manual considerable: parsear la estructura, normalizar los códigos, separar descripciones de notas y mantenerlo todo al día con cada modificación normativa. El coste de mantenimiento es alto y recurrente.

datos.gob.es

El catálogo estatal de datos abiertos, datos.gob.es, agrega datasets de múltiples administraciones. A fecha de junio de 2026, puedes encontrar datasets de demografía empresarial y censos de empresas por actividad. Es un recurso útil para enriquecer tu producto con datos complementarios.

Cuándo sí

Elige datos.gob.es cuando buscas datasets complementarios para cruzar con tu clasificación: demografía empresarial por CNAE, distribución geográfica de actividades o series temporales por sector. Estos datos, combinados con tu clasificación base, pueden dar valor añadido a tu producto.

Cuándo no

No elijas datos.gob.es como fuente principal de códigos IAE o CNAE. La cobertura es parcial y heterogénea: datasets de distintas administraciones, con formatos dispares y fechas de actualización inconsistentes. A fecha de junio de 2026, no existe en datos.gob.es un dataset único con la correspondencia IAE-CNAE lista para usar. Tendrías que ensamblar, normalizar y mantener varias fuentes por tu cuenta.

Scraping de webs de terceros

El scraping consiste en extraer datos de páginas web mediante parsers automatizados. Algunos desarrolladores lo consideran como atajo para obtener códigos IAE o CNAE desde sitios que los muestran públicamente. La realidad es menos amable.

Cuándo sí

Prácticamente nunca como solución permanente. El único escenario donde tiene sentido es un prototipo desechable de fin de semana, para validar una hipótesis antes de buscar una fuente fiable. Si lo usas, asume que lo tirarás después.

Cuándo no

No lo uses en producción. Cualquier cambio de maquetación en el sitio de origen rompe tu parser sin aviso. El coste de mantenimiento es recurrente e impredecible. Los datos pueden quedar desactualizados sin que lo detectes. Y existe una zona legal gris según los términos de uso del sitio scrapeado. El ahorro inicial se convierte en deuda técnica y riesgo.

API del Conversor IAE-CNAE

Nuestra API ofrece 2.875 códigos en total: 1.186 epígrafes IAE, 1.060 códigos CNAE 2025, 629 códigos CNAE 2009 y 1.010 correspondencias CNAE 2009 a CNAE 2025. Todo en JSON, con fuentes AEAT, INE y BOE, y actualización trimestral, a fecha de junio de 2026. Los endpoints incluyen detalle IAE/CNAE, búsqueda híbrida (léxica más semántica), correspondencias CNAE 2009 a 2025, obligaciones fiscales, módulos IRPF/IVA, calendario fiscal y consultas masivas de hasta 50 códigos. La documentación completa está en la documentación de la API.

La autenticación se realiza con la cabecera X-API-Key y una clave que empieza por cvr_. Hay cuatro planes: Desarrollador gratis (250 req/día, 10 req/min), Profesional 29 €/mes (2.000 req/día, 30 req/min), Empresa 79 €/mes (10.000 req/día, 100 req/min) y Enterprise a medida.

Cuándo sí

Elige nuestra API cuando necesitas consulta bajo demanda en tiempo real, búsqueda por descripción en lenguaje natural, la correspondencia IAE-CNAE resuelta sin ensamblarla a mano, o la migración de CNAE 2009 a CNAE 2025 automatizada. Es el caso típico de un producto en producción: un formulario de alta que autocompleta el epígrafe IAE a partir de la actividad descrita por el usuario, un CRM que enriquece fichas de cliente con obligaciones fiscales, o una plataforma que migra carteras enteras al nuevo CNAE 2025 mediante las 1.010 correspondencias.

Cuándo no

Si solo necesitas la tabla CNAE 2025 una vez, descárgala del INE. Es gratis, es oficial y es suficiente para ese caso. No necesitas nuestra API para eso. Tampoco la necesitas si tu caso exige el texto normativo literal del BOE como fuente primaria: nosotros elaboramos las correspondencias a partir de las fuentes oficiales, pero si tu producto debe mostrar el texto legal exacto, la fuente primaria es el BOE, no una API de terceros.

Cómo empezar en cinco minutos

Crea tu clave gratuita en la página de precios con el plan Desarrollador, sin tarjeta. Lanza tu primera llamada con este comando:

curl -H "X-API-Key: cvr_TU_CLAVE" https://www.conversoriaecnae.es/api/v1/iae/5013

La respuesta incluye el detalle completo del epígrafe IAE 501.3 en JSON. Para el resto de endpoints, revisa la documentación de la API.

Preguntas frecuentes

¿Existe una API oficial del INE o de la AEAT para consultar CNAE o IAE?

A fecha de junio de 2026, el INE ofrece descargas de la clasificación CNAE 2025 y la AEAT publica las tarifas del IAE como documentos normativos. Ninguna de las dos ofrece una API pública de consulta código a código con correspondencias IAE-CNAE.

¿La correspondencia IAE-CNAE es oficial?

El IAE es una clasificación tributaria de la AEAT y el CNAE es una clasificación estadística del INE. Son clasificaciones distintas y no existe una tabla única oficial que las cruce. Las correspondencias publicadas, incluidas las nuestras, son elaboraciones técnicas construidas a partir de las fuentes oficiales (AEAT, INE, BOE).

¿Qué cambia con el CNAE 2025?

La clasificación CNAE 2009 queda sustituida por la CNAE 2025. El plazo para comunicar el nuevo código termina el 30 de junio de 2026. Existen 1.010 correspondencias CNAE 2009 a CNAE 2025 para migrar carteras, disponibles en nuestra API.

¿Puedo usar el plan gratuito en producción?

Sí, dentro de sus límites de 250 solicitudes al día y 10 solicitudes por minuto. Para volúmenes mayores están los planes Profesional (29 €/mes) y Empresa (79 €/mes).