Cobrança

A API cobra em créditos. Cada requisição custa o preço base do seu endpoint, mais os recursos que retornam dados e os acréscimos que você escolher. Os preços são os mesmos em todo plano. O seu plano decide quais recursos você pode usar.

Você solicita os recursos de fetch-organization um a um. Cada um só custa quando retorna dados:

Com todos os recursos e os dois acréscimos, uma requisição a fetch-organization custa no máximo 215 créditos. Esse escopo está incluído no Max.

Um monitor custa um preço fixo por período de 30 dias, conforme o intervalo de verificação. Criá-lo e a primeira linha de base são grátis.

Um intervalo entre esses degraus custa tanto quanto o próximo degrau mais frequente. Mais em account/monitors.

Um recurso sem dados não custa nada. Se ele retorna null ou uma lista vazia, você não paga por ele. Isso vale para todo recurso, incluindo insolvency_publications: sem avisos de insolvência, é grátis.

O preço base e os acréscimos seguem regras próprias. Você paga o preço base por todo perfil de empresa entregue. O Modo IA custa mesmo sem correspondência. O Tempo real custa a cada consulta ao vivo bem-sucedida, mesmo que nada tenha mudado no registro. Mais em Acréscimos.

Para alguns recursos, conta um conteúdo específico:

• shareholders e shareholders_deep só custam quando há entradas atuais. Um histórico sozinho é grátis.
• mergers_and_acquisitions só custa com operações, relações de controle ou sucessões legais.
• network só custa com pelo menos uma ligação.
• news custa assim que a lista contém pelo menos um artigo.

fetch-organization omite um recurso que o seu plano não inclui e não o cobra.

Na Busca & Exportação, em documentos e em Signals, você paga pela própria requisição: uma página de resultados, um documento, uma página de Signals. Uma busca sem resultados e uma página vazia de Signals também são cobradas.

Uma requisição que falhou ou foi recusada não custa nada, veja Erros.

fetch-organization tem dois acréscimos que você ativa por requisição.

Modo IA (ai_search=on-default, +20 créditos) encontra a empresa mesmo a partir de entradas vagas e pesquisa na web. Ele é cobrado assim que a pesquisa foi feita, mesmo que não encontre empresa ou a fonte de dados informe um erro. Só quando a API interrompe a requisição com 408 ele não é cobrado.

Tempo real (realtime_mode=handelsregister-default, +10 créditos) busca as pessoas registradas ao vivo no Handelsregister (registro comercial). Cobramos o acréscimo quando a consulta ao vivo é bem-sucedida, independentemente do que retorna. Então _realtime_mode.status tem o valor success.

Qualquer outro valor ali significa que a consulta ao vivo falhou. Você então recebe os dados armazenados e paga o resto da requisição, sem o acréscimo de Tempo real. Se a requisição demorar demais, a API responde com 408 e não cobra nada.

Toda resposta diz quanto custou. Em respostas JSON, isso está em meta; para documentos, nos headers.

Recusas na autenticação (401, 403) e acima do limite (429) geralmente vêm sem meta. Elas nunca custam nada.

Cada cobrança está em Conta › Uso e pela API em GET /v1/account/usage/transactions, veja account.

Antes de processar uma requisição, a API verifica se o seu saldo cobre o maior custo possível: preço base, todos os recursos solicitados e os acréscimos. Se não cobrir, a API responde com 402 e não cobra nada.

A resposta mostra esse máximo em meta.request_credit_cost e o seu saldo em meta.credits_remaining. O valor cobrado depois muitas vezes é menor, porque recursos sem dados não custam nada.

Um exemplo: dados básicos com Modo IA e o recurso ubos precisam de 35 créditos de antemão. Se ubos não retornar dados, a requisição custa 25 créditos.

signals responde com Problem Details e o código INSUFFICIENT_CREDITS.

Toda conta nova recebe 150 créditos iniciais. Eles valem por 30 dias.

Com uma assinatura de créditos (Plus, Pro, Max ou Enterprise), você recebe créditos todo mês. Eles valem até o fim do período de cobrança. Se você mudar de plano, leva os créditos mensais não usados para o novo período. A partir do Plus você pode usar fetch-person; Pro e Max liberam dados adicionais.

Você compra créditos de recarga uma única vez, como complemento. Sem assinatura de créditos, eles valem por 30 dias. Enquanto uma assinatura de créditos estiver ativa, nem os créditos de recarga nem os iniciais expiram.

Você vê seu saldo e o que expira quando em Conta › Créditos e pela API em GET /v1/account/credits.

Todos os planos e preços estão na página de preços.