Facturación
Lo que cuesta una solicitud y cómo puedes comprobarlo.
Precios por endpoint y función
La API factura en créditos. Cada solicitud cuesta el precio base de su endpoint, más las funciones que devuelven datos y los recargos que elijas. Los precios son los mismos en todos los planes. Tu plan decide qué funciones puedes usar.
| Endpoint | Qué | Créditos |
|---|---|---|
| fetch-organization | Perfil de empresa con los datos básicos | 5 |
| fetch-organization | Funciones, consulta la tabla siguiente | 1 a 80 |
| fetch-organization | Recargo del modo IA, incluso sin coincidencia | +20 |
| fetch-organization | Recargo de Tiempo real, por cada consulta en directo correcta | +10 |
| fetch-person | Perfil de persona, investigación web incluida (desde Plus) | 15 |
| fetch-person |
Función shareholdings, solo si devuelve datos
|
+5 |
| fetch-person |
Función network (Pro, Max), solo si devuelve datos
|
+25 |
| search-organizations | Una página de resultados, aunque esté vacía | 1 |
| fetch-document | Un documento entregado | 15 |
| signals | Una página de Signals o una sola señal | 20 |
| signals |
El catálogo de temas /v1/signals/catalog
|
gratis |
| account, auth | Cuenta, saldo, consumo, claves, tokens y endpoints de webhook | gratis |
Las funciones de fetch-organization las pides una a una. Cada una solo cuesta cuando devuelve datos:
| Función | Contenido | Créditos | Plan |
|---|---|---|---|
| related_persons | Administración | 2 | cualquier cuenta |
| shareholders | Socios (Beta) | 5 | cualquier cuenta |
| shareholders_deep | Socios en profundidad | 80 | Max |
| ubos | Titulares reales (UBO, Beta) | 10 | cualquier cuenta |
| shareholdings | Participaciones (Beta) | 5 | cualquier cuenta |
| mergers_and_acquisitions | Fusiones y adquisiciones (M&A, Beta) | 20 | cualquier cuenta |
| network | Red de empresas (Beta) | 25 | Pro, Max |
| publications | Historial: los anuncios registrales | 1 | cualquier cuenta |
| financial_kpi | KPI financieros | 1 | cualquier cuenta |
| balance_sheet_accounts | Balance | 3 | cualquier cuenta |
| profit_and_loss_account | Cuenta de pérdidas y ganancias | 3 | cualquier cuenta |
| annual_financial_statements | Cuentas anuales (Markdown) | 5 | cualquier cuenta |
| annual_financial_statements__html | Cuentas anuales (HTML) | 5 | cualquier cuenta |
| insolvency_publications | Publicaciones de insolvencia | 5 | cualquier cuenta |
| news | Noticias | 10 | cualquier cuenta |
| website_content | Contenido del sitio web · solo con modo IA | gratis | cualquier cuenta |
Con todas las funciones y ambos recargos, una solicitud a fetch-organization cuesta como máximo 215 créditos. Este alcance viene con Max.
Un monitor cuesta un precio fijo por periodo de 30 días, según el intervalo de comprobación. Crearlo y la primera línea base son gratis.
| Intervalo de comprobación | Créditos por 30 días |
|---|---|
| cada día | 50 |
| cada 3 días | 40 |
| cada 7 días | 20 |
| cada 30 días | 10 |
| Cada comprobación correcta adicional en el periodo | +2 |
Un intervalo entre estos escalones cuesta lo mismo que el siguiente escalón más frecuente. Más en account/monitors.
Pagar solo lo que devuelve datos
Una función sin datos no cuesta nada. Si devuelve null o una lista vacía, no la pagas. Esto aplica a todas las funciones, también a insolvency_publications: sin anuncios de insolvencia es gratis.
El precio base y los recargos siguen sus propias reglas. Pagas el precio base por cada perfil de empresa entregado. El modo IA cuesta incluso sin coincidencia. Tiempo real cuesta por cada consulta en directo correcta, aunque nada haya cambiado en el registro. Más en Recargos.
En algunas funciones importa un contenido concreto:
shareholdersyshareholders_deepsolo cuestan cuando hay entradas actuales. Un historial solo es gratis.mergers_and_acquisitionssolo cuesta con transacciones, relaciones de control o sucesiones legales.networksolo cuesta con al menos una conexión.newscuesta en cuanto la lista contiene al menos un artículo.
fetch-organization omite una función que tu plan no incluye y no la cobra.
En Búsqueda y exportación, documentos y Signals pagas la solicitud en sí: una página de resultados, un documento, una página de Signals. Una búsqueda sin resultados y una página vacía de Signals también se cobran.
Una solicitud fallida o rechazada no cuesta nada, consulta Errores.
Recargos del modo IA y Tiempo real
fetch-organization tiene dos recargos que activas por solicitud.
Modo IA (ai_search=on-default, +20 créditos) encuentra la empresa incluso a partir de entradas vagas e investiga en la web. Se cobra en cuanto la investigación se ha ejecutado, aunque no encuentre ninguna empresa o la fuente de datos informe de un error. Solo cuando la API interrumpe la solicitud con 408 no se cobra.
Tiempo real (realtime_mode=handelsregister-default, +10 créditos) obtiene en directo las personas inscritas del Handelsregister (Registro Mercantil). Cobramos el recargo cuando la consulta en directo tiene éxito, devuelva lo que devuelva. Entonces _realtime_mode.status tiene el valor success.
Cualquier otro valor ahí significa que la consulta en directo falló. Recibes entonces los datos guardados y pagas el resto de la solicitud, sin el recargo de Tiempo real. Si la solicitud tarda demasiado, la API responde con 408 y no cobra nada.
1{2 "name": "Hetzner Online GmbH",3 "_realtime_mode": {4 "mode": "handelsregister-default",5 "status": "success"6 },7 "meta": {8 "request_credit_cost": 15,9 "credits_remaining": 14510 }11}
Costes en la respuesta
Cada respuesta te dice lo que costó. En las respuestas JSON está en meta, en los documentos en headers.
| Dónde | Significado |
|---|---|
| meta.request_credit_cost |
Lo que costó esta solicitud. En reintentos con clave de idempotencia y en casi todos los errores, es 0.
|
| meta.credits_remaining | Tu saldo después de la solicitud. |
| X-Credits-Charged | signals y un documento entregado: lo que costó la solicitud, como header. |
| X-Credits-Remaining | Un documento entregado: tu saldo después de la solicitud, como header. |
1{2 "name": "Hetzner Online GmbH",3 "meta": {4 "request_credit_cost": 5,5 "credits_remaining": 1456 }7}
Los rechazos en la autenticación (401, 403) y por encima del límite (429) suelen llegar sin meta. Nunca cuestan nada.
Cada cargo lo encuentras en Cuenta › Consumo y a través de la API en GET /v1/account/usage/transactions, consulta account.
Créditos insuficientes
Antes de procesar una solicitud, la API comprueba si tu saldo cubre el coste más alto posible: precio base, todas las funciones solicitadas y los recargos. Si no, responde con 402 y no cobra nada.
La respuesta muestra este máximo en meta.request_credit_cost y tu saldo en meta.credits_remaining. El importe cobrado después suele ser menor, porque las funciones sin datos no cuestan nada.
Un ejemplo: los datos básicos con modo IA y la función ubos necesitan de antemano 35 créditos. Si ubos no devuelve datos, la solicitud cuesta 25 créditos.
signals responde con Problem Details y el código INSUFFICIENT_CREDITS.
Suscripción de créditos y créditos de recarga
Cada cuenta nueva recibe 150 créditos iniciales. Son válidos durante 30 días.
Con una suscripción de créditos (Plus, Pro, Max o Enterprise) recibes créditos cada mes. Son válidos hasta el final del periodo de facturación. Si cambias de plan, te llevas los créditos mensuales no usados al nuevo periodo. Desde Plus puedes usar fetch-person; Pro y Max desbloquean datos adicionales.
Los créditos de recarga los compras una vez, como extra. Sin suscripción de créditos son válidos durante 30 días. Mientras haya una suscripción de créditos en curso, no caducan ni los créditos de recarga ni los iniciales.
Tu saldo y lo que caduca y cuándo lo ves en Cuenta › Créditos y a través de la API en GET /v1/account/credits.
Todos los planes y precios están en la página de precios.