API REST pública v1
Acceso programático a +35.000 empresas colombianas con datos oficiales de Supersociedades (SIIS) y Superfinanciera (SFC/XBRL). JSON estructurado, sin autenticación, CORS abierto.
Sin código: úsala con tu IA
No necesitas saber programar. Los modelos de lenguaje como ChatGPT, Claude o Gemini pueden consultar esta API directamente si les das la URL. Copia uno de estos prompts y pégalo en tu chat — la IA hará la petición y analizará los datos por ti.
Consulta esta URL de la API pública de Analítica Empresarial: https://www.analiticaempresarial.info/api/v1/empresa/890900943?include=profile,financials,indicators Con los datos JSON que retorna, dame: 1. Resumen del perfil de la empresa 2. Evolución de ingresos operacionales y ganancia neta en los últimos 3 años 3. Análisis de liquidez y rentabilidad 4. Principales fortalezas y riesgos financieros
Consulta esta URL: https://www.analiticaempresarial.info/api/v1/screener?seccion=C&sort=ingresos_operacionales&page_size=15 Crea una tabla comparativa con las 15 empresas más grandes del sector manufacturero en Colombia, incluyendo NIT, nombre, ingresos operacionales y ciudad. Ordénalas de mayor a menor ingreso.
Consulta https://www.analiticaempresarial.info/api/v1/search?q=ecopetrol y dime: 1. ¿En qué fuentes de datos (SIIS o SFC) aparece esta empresa? 2. ¿Cuál es su NIT? 3. Dame el link directo para ver su perfil financiero completo
Consulta esta URL de datos XBRL IFRS: https://www.analiticaempresarial.info/api/v1/sfc/8002161815?include=profile,filings,ratios Explícame: 1. ¿Qué entidad financiera es? 2. ¿Cuántos reportes XBRL tiene disponibles? 3. Resume los principales ratios financieros del último año disponible
Cómo funciona: Las IAs modernas (ChatGPT o1/o3, Claude 3.5+, Gemini 1.5+) pueden hacer peticiones HTTP directamente a URLs públicas. Al darle la URL de la API en tu prompt, el modelo consulta los datos en tiempo real y los procesa en el contexto de tu pregunta. No necesitas instalar nada ni saber código — solo copiar y pegar.
Overview
Convenciones generales de la API.
Rate Limits
Headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
Formato de respuesta exitosa
{
"data": { ... },
"meta": {
"version": "1.0",
"generated_at": "2025-01-15T12:00:00Z",
"source": "SIIS",
"url": "/api/v1/empresa/890900943"
}
}SIISEmpresa — Supersociedades
Datos de empresas reportadas a Supersociedades. Estados financieros NIIF Plenas o PYMES, 20 indicadores calculados y benchmark sectorial CIIU.
/api/v1/empresa/{nit}Bundle completo de una empresa SIISRetorna perfil, estados financieros e indicadores en una sola llamada. Usa ?include= para controlar qué secciones se incluyen.
| Parámetro | Dónde | Req. | Tipo | Descripción | Ejemplo |
|---|---|---|---|---|---|
| nit | path | ✓ | string | NIT de la empresa (6-15 dígitos) | 890900943 |
| include | query | — | string | Secciones separadas por coma. Default: profile,financials,indicators | profile,financials,indicators,benchmark |
| years | query | — | string | Años separados por coma. Si se omite, retorna todos | 2024,2023,2022 |
curl "https://www.analiticaempresarial.info/api/v1/empresa/890900943?include=profile,financials,indicators"Ver ejemplo de respuesta ↓
{
"data": {
"profile": {
"nit": "890900943",
"razon_social": "BANCOLOMBIA S.A.",
"ciiu_codigo": "6411",
"ciiu_descripcion": "Banca central",
"seccion": "K",
"ciudad": "MEDELLÍN",
"departamento": "ANTIOQUIA",
"marco_niif": "PLENAS"
},
"financials": {
"currency": "COP",
"unit": "units",
"estado_resultados": [
{
"anio": 2024,
"ingresos_operacionales": 18500000000000,
"ganancia_neta": 4200000000000
}
]
},
"indicators": {
"definitions": {
"razon_corriente": { "category": "liquidez", "unit": "ratio", "formula": "AC / PC" }
},
"by_year": [
{ "anio": 2024, "razon_corriente": 1.45, "roe": 0.18, "roa": 0.02 }
]
}
},
"meta": { "version": "1.0", "source": "SIIS", "generated_at": "2025-01-15T12:00:00Z" }
}/api/v1/empresa/{nit}/financialsEstados financieros NIIF (ER, ESF, EFE)Estado de Resultados, Estado de Situación Financiera y Flujo de Efectivo por año.
| Parámetro | Dónde | Req. | Tipo | Descripción | Ejemplo |
|---|---|---|---|---|---|
| nit | path | ✓ | string | NIT de la empresa | 890900943 |
| statement | query | — | enum | resultados | situacion_financiera | flujo_efectivo. Si se omite, retorna los tres | resultados |
| years | query | — | string | Años separados por coma | 2024,2023 |
curl "https://www.analiticaempresarial.info/api/v1/empresa/890900943/financials?statement=resultados&years=2024,2023"/api/v1/empresa/{nit}/indicators20 indicadores financieros calculados por añoLiquidez (5), eficiencia (6), endeudamiento (4), rentabilidad (5). Cada indicador incluye su fórmula y unidad en la clave definitions.
| Parámetro | Dónde | Req. | Tipo | Descripción | Ejemplo |
|---|---|---|---|---|---|
| nit | path | ✓ | string | NIT de la empresa | 890900943 |
| category | query | — | enum | liquidez | eficiencia | endeudamiento | rentabilidad | rentabilidad |
| years | query | — | string | Años separados por coma | 2024,2023,2022 |
curl "https://www.analiticaempresarial.info/api/v1/empresa/890900943/indicators?category=rentabilidad"/api/v1/empresa/{nit}/benchmarkBenchmark sectorial vs peers CIIUPercentiles P25/P50/P75 y promedios de empresas pares en los 3 niveles CIIU (clase, división, sección). Incluye ranking top-N con opción de elegir el nivel.
| Parámetro | Dónde | Req. | Tipo | Descripción | Ejemplo |
|---|---|---|---|---|---|
| nit | path | ✓ | string | NIT de la empresa | 890900943 |
| years | query | — | string | Años separados por coma | 2024,2023 |
| ranking_level | query | — | enum | clase | division | seccion. Default: clase | division |
| ranking_limit | query | — | integer | Tamaño del ranking (1-100). Default: 20 | 10 |
curl "https://www.analiticaempresarial.info/api/v1/empresa/890900943/benchmark?ranking_level=division&ranking_limit=10"SFCEntidad — Superfinanciera
Datos XBRL IFRS de entidades vigiladas: bancos, aseguradoras, fiduciarias, fondos de pensiones. Los estados están en formato estándar IFRS internacional.
/api/v1/sfc/{nit}Bundle XBRL IFRS de una entidad SFCRetorna perfil, filings disponibles, estados IFRS, ratios y notas narrativas. Nota: statements y notes son costosos — solicítalos explícitamente.
| Parámetro | Dónde | Req. | Tipo | Descripción | Ejemplo |
|---|---|---|---|---|---|
| nit | path | ✓ | string | NIT de la entidad SFC | 8002161815 |
| include | query | — | string | Secciones: profile, filings, statements, ratios, notes. Default: profile,filings,ratios | profile,filings,ratios |
| years | query | — | string | Años separados por coma | 2024,2023 |
| statements | query | — | string | Cuando include=statements: financial_position, profit_loss, cash_flows, equity | financial_position,profit_loss |
# Perfil + filings + ratios (recomendado para inicio)
curl "https://www.analiticaempresarial.info/api/v1/sfc/8002161815?include=profile,filings,ratios"
# Estados IFRS completos (más costoso)
curl "https://www.analiticaempresarial.info/api/v1/sfc/8002161815?include=profile,statements&statements=financial_position,profit_loss"Ver ejemplo de respuesta ↓
{
"data": {
"profile": {
"entity_id": "8002161815",
"name": "BANCO DAVIVIENDA S.A.",
"taxonomy_ref": "BANKING",
"filings_count": 24,
"first_year": 2019,
"last_year": 2024
},
"filings": [
{ "year": 2024, "period": "Q4", "filing_date": "2025-03-15" }
],
"ratios": {
"2024": {
"capital_adequacy": 0.152,
"npl_ratio": 0.038,
"roe": 0.142
}
}
},
"meta": { "version": "1.0", "source": "SFC", "generated_at": "2025-01-15T12:00:00Z" }
}Catálogos
Endpoints para descubrir y filtrar empresas de ambas fuentes.
/api/v1/screenerListado paginado y filtrable de empresas SIISFiltra por sector CIIU, geografía, marco NIIF, estado societario. Ordena por ingresos, activos o ganancia. Paginación con hasta 200 resultados por página.
| Parámetro | Dónde | Req. | Tipo | Descripción | Ejemplo |
|---|---|---|---|---|---|
| seccion | query | — | string | CIIU sección (1 letra A-U) | F |
| division | query | — | string | CIIU división (2 dígitos) | 42 |
| clase | query | — | string | CIIU clase (4 dígitos) | 4290 |
| departamento | query | — | string | Nombre del departamento | ANTIOQUIA |
| ciudad | query | — | string | Nombre de la ciudad | MEDELLÍN |
| marco_niif | query | — | enum | PLENAS | PYMES | PLENAS |
| q | query | — | string | Búsqueda libre por nombre o NIT | Ecopetrol |
| sort | query | — | enum | ingresos_operacionales (default) | total_activos | ganancia_neta | razon_social | total_activos |
| order | query | — | enum | desc (default) | asc | desc |
| page | query | — | integer | Página (1-indexed). Default: 1 | 1 |
| page_size | query | — | integer | Resultados por página (máx 200). Default: 50 | 20 |
# Top 10 empresas del sector construcción por ingresos
curl "https://www.analiticaempresarial.info/api/v1/screener?seccion=F&sort=ingresos_operacionales&page_size=10"
# Empresas NIIF Plenas en Bogotá, sector K (financiero)
curl "https://www.analiticaempresarial.info/api/v1/screener?seccion=K&ciudad=BOGOTÁ%20D.C.&marco_niif=PLENAS"
# Búsqueda por nombre con paginación
curl "https://www.analiticaempresarial.info/api/v1/screener?q=cemento&page=1&page_size=20"Ver ejemplo de respuesta ↓
{
"data": {
"empresas": [
{
"nit": "860002534",
"razon_social": "CONCONCRETO S.A.",
"ciiu_codigo": "4111",
"seccion": "F",
"ciudad": "MEDELLÍN",
"ingresos_operacionales": 2800000000000,
"total_activos": 4200000000000,
"anio": 2024
}
],
"pagination": {
"page": 1, "page_size": 10, "total": 4832,
"total_pages": 484, "has_next": true, "has_prev": false
},
"anio": 2024
},
"meta": { "version": "1.0", "source": "SIIS" }
}/api/v1/searchBúsqueda unificada SIIS + SFCBusca por nombre o NIT en ambos datasets simultáneamente. Útil para saber si una empresa tiene datos en SIIS, SFC o ambas.
| Parámetro | Dónde | Req. | Tipo | Descripción | Ejemplo |
|---|---|---|---|---|---|
| q | query | ✓ | string | Término de búsqueda (mínimo 2 caracteres) | avianca |
| limit | query | — | integer | Máximo resultados (1-50). Default: 10 | 10 |
| source | query | — | enum | Filtra por dataset: siis | sfc | siis |
# Buscar en ambas fuentes
curl "https://www.analiticaempresarial.info/api/v1/search?q=ecopetrol"
# Solo buscar en SIIS (Supersociedades)
curl "https://www.analiticaempresarial.info/api/v1/search?q=nutresa&source=siis&limit=5"
# Buscar por NIT exacto
curl "https://www.analiticaempresarial.info/api/v1/search?q=222918138"Ver ejemplo de respuesta ↓
{
"data": {
"results": [
{
"nit": "222918138",
"razon_social": "ECOPETROL S.A.",
"source": "SUPERSOC",
"href": "/empresa/222918138"
},
{
"nit": "222918138",
"razon_social": "ECOPETROL S.A.",
"source": "SFC",
"href": "/superfinanciera/222918138"
}
],
"count": 2
},
"meta": { "version": "1.0" }
}Convenciones
Errores — RFC 7807 Problem Details
Todos los errores retornan Content-Type: application/problem+json con esta estructura:
{
"type": "https://www.analiticaempresarial.info/errors/not-found",
"title": "Recurso no encontrado",
"status": 404,
"detail": "No se encontró empresa con NIT 999999999 en SIIS",
"instance": "/api/v1/empresa/999999999"
}Bad Request
Parámetros inválidos o faltantes
Not Found
NIT no existe en el dataset
Too Many Requests
Rate limit excedido. Ver header Retry-After
Internal Error
Error inesperado del servidor
Paginación
Los endpoints de listado (/screener) retornan un objeto pagination en data:
{
"pagination": {
"page": 1,
"page_size": 50,
"total": 35812,
"total_pages": 717,
"has_next": true,
"has_prev": false
}
}Para iterar todas las páginas: mientras has_next == true, incrementa page. Máximo page_size=200.
Moneda y unidades
Todos los valores monetarios están en COP (pesos colombianos) en unidades (no en millones). El campo unit siempre retorna "units". Ejemplo: 18500000000000 = $18.5 billones COP.
Cache y frescura de datos
• Los datos financieros se actualizan anualmente — los de 2024 estarán disponibles aprox. Q2 2025.
• Cache en Edge CDN: 1 hora por endpoint (header Cache-Control: max-age=3600, stale-while-revalidate=86400).
• Si necesitas datos más frescos que 1h, agrega ?_ts={timestamp} como cache-buster.
CORS
La API tiene CORS completamente abierto (Access-Control-Allow-Origin: *). Puedes consumirla directamente desde cualquier frontend, app móvil o herramienta.
Licencia: Los datos son de fuentes oficiales colombianas (SIIS / SFC). Esta API los expone bajo CC BY 4.0. Al publicar análisis derivados, cita la fuente original: Superintendencia de Sociedades (SIIS) o Superintendencia Financiera (SFC).