Documentación Ver secciones Cerrar
Nivel gratuito (DAT-FREE)
La versión del API que responde preguntas sobre la data sin entregar la data: por entidad, si existe, si está vigente, un puñado de booleanos, conteos en rangos y el score. Nunca un nombre de tercero, un monto, una fecha, un documento.
En despliegue. Este es el contrato del nivel gratuito; el gateway lo activa por partes. Hoy los requests sin llave (nivel 0) todavía exigen una llave, por API y por MCP; una llave con saldo cero sigue respondiendo CHK-BIN y DAT-CORE con el límite diario vigente; los 403 y 429 del gateway traen un upgrade_url con el paso siguiente. Esta página cambia a medida que cada parte entra.
Para qué sirve
Con una llave gratuita obtienes el id de Panadata de una entidad y sabes qué hay detrás; los registros cuestan tokens. Alcanza para validar una regla de compuerta sobre un RUC o una cédula, pre-chequear un proveedor, priorizar una lista de 300 filas por señales o probar el JSON mientras construyes. No alcanza, a propósito, para operar una cartera.
Cuatro reglas: respuestas, no registros (todo campo es un booleano, un rango, un año o un score); cada campo apunta a un SKU pagado (DAT-FREE es el menú, el precio está en Precios); mismo meter, mismo id en todos los niveles; y lo que hace el MCP lo hace el API, con el mismo nivel de acceso y la misma respuesta.
Los cuatro niveles
| Nivel | Quién | Qué devuelve | Límite |
|---|---|---|---|
| 0. Sin llave | cualquiera: cualquier sesión de Claude, Cursor o ChatGPT vía el MCP público; cualquier request HTTP a platform.panadata.net sin cabecera |
resolve con ids enmascarados, existe, nombre, tipo, año, score y el menú (codigos_con_datos) |
~20 entidades/día por sesión o IP; presupuesto global de 1,000 consultas/día para todo el nivel |
| 1. Llave gratuita | email + teléfono verificados | la ficha DAT-FREE completa: booleanos y rangos | 500/mes (1,000 con dominio corporativo), 30/día, 1 rps, lote 10 |
| 2. Sandbox US$95 | quien paga | registros completos, 95 tokens, llave permanente | 1 rps |
| 3. Packs | Piloto / Barrido / Programa | registros a volumen, lote 100, estimador | por pack |
El nivel 0 da el menú y el score pero no los booleanos: un agente sin llave aprende «Panadata tiene datos judiciales, inmobiliarios y de comercio sobre esta sociedad y la puntúa 71». Los booleanos detrás cuestan un email y un teléfono. Los registros cuestan tokens.
La ficha DAT-FREE
GET /v5/entities/{id}?include=DAT-FREE cuesta 0 tokens. Ejemplo para una organización, con llave gratuita:
{
"id": "pa_own_4629361",
"nivel": "DAT-FREE",
"existe": true, "vigente": true, "suspendida": false,
"tipo": "organizacion", "anio_constitucion": 1998,
"directores": "3-9",
"tiene_judicial": true, "moroso_css": false, "contrata_con_estado": true,
"en_planilla_estatal": false, "pep_local": false,
"inmuebles": "10+", "comercio_exterior": true, "noticias": true,
"score": 71,
"codigos_con_datos": ["DAT-CORE","DAT-REGISTRY","DAT-BUSINESS","DAT-RISK-JUDICIAL","DAT-ESTADO","DAT-REALESTATE","DAT-REALESTATE-INTEL","DAT-TRADE-INTEL","DAT-NETWORK","DAT-DOC"],
"actualizado": "2026-09",
"siguiente_paso": {"para_ver_los_registros": "https://platform.panadata.net/docs/precios", "tokens_dat_core": 0.66}
}
Sin llave (nivel 0) la ficha se reduce a existe, vigente, suspendida, tipo, anio_constitucion, score, codigos_con_datos, actualizado y siguiente_paso; los booleanos y rangos aparecen con llave gratuita. Para una persona natural la ficha es la misma menos directores, contrata_con_estado y comercio_exterior, y con en_planilla_estatal, pep_local e inmuebles como campos principales.
| Campo | Forma | SKU pagado detrás |
|---|---|---|
| existe, vigente, suspendida | booleanos | DAT-CORE |
| tipo | persona / organizacion / fundacion … | DAT-CORE |
| anio_constitucion | año (solo el año) | DAT-CORE |
| directores | rango 0 / 1-2 / 3-9 / 10+ | DAT-CORE (nombres y cargos) |
| tiene_judicial | booleano | DAT-RISK-JUDICIAL |
| moroso_css | booleano | DAT-RISK-CSS |
| contrata_con_estado | booleano | DAT-ESTADO |
| en_planilla_estatal | booleano | DAT-PAYROLL |
| pep_local | booleano | DAT-PEP-LOCAL |
| inmuebles | rango 0 / 1-2 / 3-9 / 10+ | DAT-REALESTATE |
| comercio_exterior | booleano | DAT-BIZ-TRADE / DAT-TRADE-INTEL |
| noticias | booleano | DAT-RISK-NEWS |
| score | número 0–100, sin desglose | DAT-SCORE (con desglose) |
| codigos_con_datos | lista de códigos DAT que devolverían datos | cada uno |
| actualizado | mes/año del índice | UPD-LIVE (dato en vivo) |
Los tokens de cada SKU están en Precios y en vivo en GET /v5/catalog.
Límites
| Límite | Valor | Por qué |
|---|---|---|
| Nivel 0, por sesión MCP o por IP | ~20 entidades/día, 1 request cada 2 s, una entidad por llamada | suficiente para que un agente responda una pregunta; insuficiente para una lista |
| Nivel 0, global | 1,000 consultas/día para todo el nivel; 429 con enlace a la llave gratuita al agotarse | el techo lo elegimos nosotros; conservador hasta ver tráfico real |
| Entidades por mes (nivel 1) | 500 por cuenta verificada (resolve + fichas DAT-FREE cuentan juntos; dry_run no cuenta) | una muestra de 300 filas o 10 al día en micro-producción caben; una cartera no |
| Con dominio corporativo verificado | 1,000 | premia al comprador probable sin regalar volumen |
| Por día | 30 | que los 500 no se gasten en una tarde sobre una lista |
| Tasa | 1 request/segundo | una muestra de 300 tarda cinco minutos; molesto, pero gratis |
| Lote (resolve/batch) | 10 filas | el batch grande es para packs |
| Vigencia de la llave | 90 días sin compra; cualquier compra (Sandbox US$95 en adelante) la vuelve permanente | evita llaves zombis y cuentas fábrica |
| Verificación | email + teléfono; una cuenta gratuita por teléfono | frena el sharding de cuentas |
| Estimador (resolve/batch con with_presence, agregados) | 5,000 filas/mes gratis; más, por Ventas | no devuelve dato por entidad; es la herramienta de conversión |
Cuando se agota: 429 con code: free_tier_limit y upgrade_url; cuando se pide un código fuera del nivel: 403 con locked_codes y free_tier_codes. El MCP lee esos campos y muestra el paso siguiente en vez de un error.
Sin llave: el mismo request por API y por MCP
Las dos operaciones del nivel 0 responden sin cabecera de autenticación. Cada tool del MCP tiene su ruta HTTP y devuelve lo mismo; si un día una tool solo existe en el MCP, es un bug. Para conectar un agente sin llave:
claude mcp add --transport http panadata https://mcp.panadata.net/mcp
1. Resolver una entidad
API — POST /v5/resolve
curl -X POST 'https://api.panadata.net/v5/resolve' \
--header 'Content-Type: application/json' \
--data '{"name": "Cerveceria Nacional"}'
MCP — tool resolve_entity
resolve_entity({"name": "Cerveceria Nacional"})
Candidatos con nombre, tipo, identificador enmascarado (8-***-2264, 155***-2-2016), confidence, matched_on y exact_homonyms; una fila por llamada. Con llave gratuita, además resolve/batch hasta 10 filas; con tokens, el identificador completo y lote de 100.
2. Leer la ficha DAT-FREE
API — GET /v5/entities/{id}
curl 'https://api.panadata.net/v5/entities/pa_own_4629361?include=DAT-FREE'
MCP — tool get_entity
get_entity({"id": "pa_own_4629361", "include": ["DAT-FREE"]})
Sin llave: existe, vigente, suspendida, tipo, año, score, menú, actualizado y siguiente_paso. Con llave gratuita (Authorization: Bearer pk_…): la ficha completa de arriba. Con tokens: los códigos que el menú anuncia.
Qué no devuelve, aunque nos cueste poco
- Nombres de terceros. Ni directores, ni dueños, ni acreedores, ni contrapartes. Solo el nombre de la entidad resuelta.
- Montos. Ni valores de propiedades, ni salarios, ni valores de contratos.
- Fechas más allá del año de constitución y del mes de actualización.
- Conteos exactos. «Tiene 4 propiedades» es un hecho sobre una persona; «tiene 3–9» es una señal.
- Identificadores completos en
resolve. - Búsquedas. Ningún endpoint que devuelva una lista de entidades a partir de criterios. Siguen pagados.
- Listas internacionales (DAT-SCREEN), documentos, dockets, OCR, dato en vivo, red de control, historial.
Cuando necesites los registros
La ficha dice qué hay; leerlo cuesta tokens. El Sandbox de US$95 da el JSON completo y una llave permanente; los packs, volumen y lote de 100. Ver precios.