Saltar al contenido
Menú de la documentación

Revelaciones y costes

Qué te da una revelación, cuánto cuesta y cuándo es gratis.

Una revelación desbloquea una empresa: su dominio, sitio web, emails, teléfonos y contactos con nombre. Cuesta una unidad de tu cuota mensual, igual que en el sitio, y la cuota se comparte con tu uso del sitio.

Qué es gratis

  • Buscar, contar, leer una ficha y todas las consultas de valores no gastan cuota.
  • Volver a revelar una empresa en el mismo periodo de facturación no cuesta nada: charged es false.
  • Consultar el coste con GET /businesses/{id}/reveal no cuesta nada.

Cuando termina el periodo

El dominio y el sitio web de una empresa que revelaste siguen visibles para ti para siempre. Los datos de contacto siguen el periodo: volver a verlos en un periodo nuevo requiere una nueva revelación, que cuesta una unidad.

Nada se gasta por accidente

  • Con REST, solo POST /businesses/{id}/reveal gasta cuota. Las lecturas rechazan el antiguo parámetro reveal= con 400 use_reveal_endpoint.
  • Con MCP, solo reveal_company gasta cuota, y solo con confirm: true. Sin él, la herramienta devuelve el coste.

Cuando se rechaza una revelación

  • 402 quota_exhausted: no quedan revelaciones. No se ha gastado nada.
  • 404 not_found: la empresa no existe o se retiró a petición de su propietario.
  • 409 email_invalid: su email está marcado como no válido. No se ha gastado nada.
  • 429 rate_limited: demasiadas revelaciones este minuto. No se ha gastado nada.

Empresas que se han retirado

Una empresa retirada a petición de su propietario desaparece de todos los endpoints y de todas las herramientas, y no se puede revelar.

Volver a findbytown