Costo en Créditos

Una llamada cuesta la tarifa base de la entidad por registro devuelto, más la tarifa de cada campo premium, indicador o de enriquecimiento que solicite explícitamente. Los campos estándar no suman nada.

Cómo funciona

Cada llamada descuenta (tarifa base de la entidad + la tarifa de cada campo premium / indicador / enriquecimiento solicitado) × la cantidad de registros devueltos. Los campos estándar están cubiertos por la tarifa base.
`fields` reduce el tamaño de la respuesta, no el costo: quitar campos estándar no cambia nada. Solo baja el costo cuando el campo que quita es premium / indicador / enriquecimiento. Si omite `fields`, paga solo la tarifa base.
Los endpoints agregados (stats, trend, delta, top-by, pivot, points, market-report), la búsqueda y los reportes se cobran por LLAMADA a una tarifa fija, no por registro. El monto exacto se devuelve en `meta.creditCost` en cada respuesta.
Los contactos y los propietarios son exclusivos de Enterprise: contactos de predio (y expand=contacts), solicitudes de contacto, enriquecimiento de contactos, la entidad owners y sus agregaciones se rechazan en otros planes con un 403 cuyo details.code es TIER_REQUIRED. Todo lo demás está abierto a todos los planes, facturado al costo en créditos indicado; lo que cambia entre planes es tu asignación mensual de créditos.
Los campos premium (descripciones con IA, valuación AVM, enriquecimiento) suelen costar más que los campos estándar.
El enriquecimiento de contactos (POST /v1/enrichment/contacts) se cobra al precio de contacts_enriched solo cuando desbloquea a alguien que tu organización no tenía — sin coincidencia o una búsqueda repetida cuesta 0. Las solicitudes de contacto (POST /v1/contacts/requests) se cobran al precio de contacts por cada contacto desbloqueado.

Cómo funciona

Cada llamada descuenta (tarifa base de la entidad + la tarifa de cada campo premium / indicador / enriquecimiento solicitado) × la cantidad de registros devueltos. Los campos estándar están cubiertos por la tarifa base.

`fields` reduce el tamaño de la respuesta, no el costo: quitar campos estándar no cambia nada. Solo baja el costo cuando el campo que quita es premium / indicador / enriquecimiento. Si omite `fields`, paga solo la tarifa base.

Los endpoints agregados (stats, trend, delta, top-by, pivot, points, market-report), la búsqueda y los reportes se cobran por LLAMADA a una tarifa fija, no por registro. El monto exacto se devuelve en `meta.creditCost` en cada respuesta.

Los contactos y los propietarios son exclusivos de Enterprise: contactos de predio (y expand=contacts), solicitudes de contacto, enriquecimiento de contactos, la entidad owners y sus agregaciones se rechazan en otros planes con un 403 cuyo details.code es TIER_REQUIRED. Todo lo demás está abierto a todos los planes, facturado al costo en créditos indicado; lo que cambia entre planes es tu asignación mensual de créditos.

Los campos premium (descripciones con IA, valuación AVM, enriquecimiento) suelen costar más que los campos estándar.

El enriquecimiento de contactos (POST /v1/enrichment/contacts) se cobra al precio de contacts_enriched solo cuando desbloquea a alguien que tu organización no tenía — sin coincidencia o una búsqueda repetida cuesta 0. Las solicitudes de contacto (POST /v1/contacts/requests) se cobran al precio de contacts por cada contacto desbloqueado.