> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tupana.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Buscar empresas del SII

> Busca en la nómina pública de empresas por tamaño, comuna, rubro o crecimiento

# Buscar empresas

```
GET https://api.tupana.ai/v2/sii-companies/
```

Devuelve empresas de la nómina pública del SII. Sin parámetros responde el
año más reciente cargado, ordenado por tramo de ventas.

```bash theme={null}
curl "https://api.tupana.ai/v2/sii-companies/?size=mediana&district=LAS%20CONDES&active=true" \
  -H "Authorization: Api-Key tk_sandbox_…"
```

```json theme={null}
{
  "year": 2024,
  "count": 1284,
  "page": 1,
  "page_size": 50,
  "results": [
    {
      "tax_id": "76543210-3",
      "name": "CONSTRUCTORA VEGA SPA",
      "year": 2024,
      "sales_tier": 8,
      "sales_tier_label": "Mediana 1 (25.000,01 a 50.000 UF)",
      "size": "mediana",
      "employees": 40,
      "activity_start_date": "2015-03-12",
      "business_end_date": null,
      "is_active": true,
      "taxpayer_type": "PERSONA JURIDICA COMERCIAL",
      "sector": "CONSTRUCCION",
      "subsector": "OBRAS DE INGENIERIA",
      "activity": "CONSTRUCCION DE EDIFICIOS",
      "region": "XIII REGION METROPOLITANA",
      "province": "Santiago",
      "district": "LAS CONDES"
    }
  ]
}
```

## Parámetros

Todos son opcionales y se combinan entre sí.

| Parámetro | Tipo | Qué hace |
| - | - | - |
| `year` | entero | Año comercial. Por defecto, el más reciente cargado. |
| `rut` | texto | RUT exacto con guión (`76543210-3`). |
| `search` | texto | Busca en la razón social. |
| `size` | texto | `micro`, `pequena`, `mediana` o `grande`. |
| `tier_min` / `tier_max` | 1–13 | Rango de tramo de ventas (ver tabla abajo). |
| `region` | texto | Nombre exacto de la región según el SII. |
| `district` | texto | Nombre exacto de la comuna. |
| `sector` | texto | Nombre exacto del rubro económico. |
| `activity` | texto | Coincidencia parcial en la actividad económica. |
| `employees_min` / `employees_max` | entero | Rango de trabajadores. |
| `active` | `true` | Solo empresas sin término de giro. |
| `province` | texto | Nombre exacto de la provincia. |
| `subsector` | texto | Nombre exacto del subrubro. |
| `sales_min_clp` / `sales_max_clp` | pesos | **Facturación anual en pesos.** Se traduce sola a tramos con la UF del día. |
| `growth` | texto | `sostenido`, `subio`, `bajo`, `igual`, `nueva`. |
| `growth_years` | entero | Años sin caer que exige `sostenido`. Por defecto 3. |
| `trend` | texto | Igual que `growth` pero sin la variante `sostenido`. |
| `exclude_known` | `true` | Descarta las que ya existen como empresa en la plataforma. |
| `taxpayer_type` / `taxpayer_subtype` | texto | Tipo de contribuyente. |
| `regime` | texto | Coincidencia parcial en el régimen (`14A`, `14D`, …). |
| `presumptive` | `true`/`false` | Renta presunta. |
| `equity_min` / `equity_max` | 1–13 | Rango de tramo de capital propio positivo. |
| `negative_equity` | `true` | Solo las que informan capital propio negativo. |
| `started_after` / `started_before` | fecha | Inicio de actividades. |
| `min_years` | entero | Antigüedad mínima en años. |
| `closed` | `true` | Solo las que tienen término de giro. |
| `end_type` | texto | Tipo de término de giro. |
| `grew_from` | año | Devuelve las que **subieron de tramo** entre ese año y `year`. |
| `order_by` | texto | `tramo` (por defecto), `tramo_asc`, `trabajadores`, `nombre`, `antiguedad`, `variacion`. |
| `page` / `page_size` | entero | Paginación. `page_size` máximo: 200. |

## Buscar por lo que factura, en pesos

El SII publica tramos en UF y nadie piensa en UF. `sales_min_clp` y
`sales_max_clp` reciben pesos y se traducen solos usando la UF del día:

```bash theme={null}
# "contadores que facturen entre 10 y 100 millones al año"
curl "https://api.tupana.ai/v2/sii-companies/?activity=CONTABILIDAD&sales_min_clp=10000000&sales_max_clp=100000000" \
  -H "Authorization: Api-Key tk_sandbox_…"
```

Se incluye todo tramo que se **solape** con el rango, no solo los que caben
enteros: una empresa del tramo 4 puede perfectamente facturar los 50 millones
que estás buscando.

## Crecimiento sostenido

`growth=subio` devuelve a cualquiera que haya subido de tramo este año,
incluida la que venía cayéndose y rebotó. `growth=sostenido` exige además no
haberse caído en los últimos años — la diferencia entre una tendencia y un
rebote.

Cada fila lo justifica sola:

| Campo | Qué dice |
| - | - |
| `previous_sales_tier` | En qué tramo estaba el año anterior |
| `tier_change` | Cuántos tramos se movió |
| `trend` | `subio`, `bajo`, `igual` o `nueva` |
| `non_declining_years` | Años seguidos sin bajar de tramo |

<Warning>
  Ordenar por `variacion` pone primero a la que más saltó, que a veces es una
  empresa que estaba dormida y se activó. Si buscas volumen real, ordena por
  `trabajadores`.
</Warning>

<Tip>
  Usa [`/sii-companies/metadata/`](/api-reference/v2/free-databases/companies-metadata)
  para obtener los valores exactos de regiones, rubros y años disponibles. La
  nomenclatura del SII tiene sorpresas (`XIII REGION METROPOLITANA`, no
  "Metropolitana").
</Tip>

## Empresas que crecieron

Es la consulta que justifica guardar cada año por separado. Con `grew_from`
comparamos las dos nóminas por RUT y devolvemos las que subieron de tramo:

```bash theme={null}
curl "https://api.tupana.ai/v2/sii-companies/?grew_from=2023&year=2024&region=XIII%20REGION%20METROPOLITANA" \
  -H "Authorization: Api-Key tk_sandbox_…"
```

Las empresas en tramo 1 (*sin información*) quedan fuera de la comparación:
ese tramo no es un tamaño, es la ausencia del dato.

## Tramos según ventas

El SII clasifica el tamaño por las ventas anuales estimadas en UF. Es un
rango, no un monto:

| Tramo | Tamaño | Ventas anuales (UF) |
| - | - | - |
| 1 | Sin información | No se puede estimar |
| 2 | Micro 1 | 0,01 – 200 |
| 3 | Micro 2 | 200,01 – 600 |
| 4 | Micro 3 | 600,01 – 2.400 |
| 5 | Pequeña 1 | 2.400,01 – 5.000 |
| 6 | Pequeña 2 | 5.000,01 – 10.000 |
| 7 | Pequeña 3 | 10.000,01 – 25.000 |
| 8 | Mediana 1 | 25.000,01 – 50.000 |
| 9 | Mediana 2 | 50.000,01 – 100.000 |
| 10 | Grande 1 | 100.000,01 – 200.000 |
| 11 | Grande 2 | 200.000,01 – 600.000 |
| 12 | Grande 3 | 600.000,01 – 1.000.000 |
| 13 | Grande 4 | Más de 1.000.000 |

El campo `size` agrupa estos tramos en las cuatro categorías de las que habla
todo el mundo, para que no tengas que memorizar la tabla.

## Tramos de capital propio

Los campos `equity_tier_positive` y `equity_tier_negative` usan otra escala,
también en UF:

| Tramo | Capital propio (UF) |
| - | - |
| 1 | 0 – 10 |
| 2 | 10 – 25 |
| 3 | 25 – 50 |
| 4 | 50 – 100 |
| 5 | 100 – 250 |
| 6 | 250 – 500 |
| 7 | 500 – 1.000 |
| 8 | 1.000 – 2.000 |
| 9 | 2.000 – 10.000 |
| 10 | Más de 10.000 |

## Desde tu asistente

Los mismos datos están expuestos en el MCP de Tupana, así que puedes
preguntarlo en español desde Claude, Cursor o ChatGPT:

> *"¿Qué empresas de construcción en Santiago crecieron entre 2023 y 2024 y
> tienen más de 20 trabajadores?"*

Ver [Conectar tu asistente](/user-guide/mcp).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.