> For the complete documentation index see https://domscan.net/llms.txt. Markdown versions of every docs page are available by appending .md to the page URL.

Source: https://domscan.net/pt/docs/credits-pricing

# Créditos e preços

API da DomScan: DomScan inclui 10.000 créditos gratuitos por mês. Sem necessidade de cartão de crédito. Comece a usar em segundos.

DomScan inclui 10.000 créditos gratuitos por mês. Sem necessidade de cartão de crédito. Comece a usar em segundos.

Os créditos são renovados mensalmente no aniversário do cadastro. Precisa de mais créditos? Compre pacotes que nunca expiram:

### Créditos por endpoint

Consulte abaixo os custos dos endpoints mais comuns. Alguns endpoints de referência são gratuitos. Para obter a tabela de preços completa e legível por máquina, use /v1/pricing.

| Ponto final | Créditos | Descrição |
| --- | --- | --- |
| `/v1/coverage` | 0 | Listar TLDs com mapeamentos RDAP |
| `/v1/tlds` | 0 | Lista de metadados de TLD |
| `/v1/watchlist` | 1 | Ver a sua lista de observação |
| `/v1/webhooks` | 2 | Por alerta entregue ao seu endpoint de webhook. As entregas com falha são reembolsadas e os eventos de teste são gratuitos. |
| `/v1/status` | 1 | Verificar disponibilidade de domínio |
| `/v1/health/quick` | 1 | Verificação de saúde rápida |
| `/v1/dns` | 1 | Consulta DNS |
| `/v1/dns/bulk` | 1/domain | Pesquisa DNS em lote (até 25 domínios) |
| `/v1/ip` | 1 | Geolocalização de IP |
| `/v1/value` | 2 | Avaliação de domínio |
| `/v1/prices` | 0-1/pair | Preços de registo |
| `/v1/tlds/:tld` | 1 | Detalhes de TLD |
| `/v1/watchlist/check` | 1 | Verificar item da lista de observação |
| `/v1/typos/permutations` | 1 | Permutações de typos |
| `/v1/typos/score` | 1 | Pontuação de risco de typo |
| `/v1/email/check` | 1 | Verificação de lista negra de email |
| `/v1/status/bulk` | 1/domain | Verifique disponibilidade para vários nomes de domínios ao mesmo tempo. Suporta até 50 domínios por pedido. |
| `/v1/health` | 3 | Verificação de saúde completa |
| `/v1/dns/all` | 2 | Todos os registos DNS |
| `/v1/profile` | 3 | Perfil de domínio |
| `/v1/redirects` | 2 | Cadeia de redirecionamento |
| `/v1/tech` | 3-9 | Detecção de pilha tecnológica |
| `/v1/categorize` | 3 | Categorização de website |
| `/v1/similarity` | 2 | Similaridade de domínios |
| `/v1/typos` | 2-3 | Detecção de typosquatting |
| `/v1/reputation` | 3 | Reputação de domínio |
| `/v1/reputation/bulk` | 3/domain | Reputação de domínios em lote (até 3 domínios) |
| `/v1/certificates` | 2 | Certificado SSL |
| `/v1/certificates/bulk` | 2/domain | Certificado SSL |
| `/v1/social` | 2 | Verificação de nomes em redes sociais |
| `/v1/social/bulk` | 2/handle | Verificação em massa de nomes de usuário nas redes sociais |
| `/v1/company` | 3 | Consulta de empresa |
| `/v1/suggest` | 2-5 | Sugestões de domínios |
| `/v1/whois` | 3 | Consulta WHOIS |
| `/v1/whois/history` | 3 | Histórico de alterações WHOIS |
| `/v1/whois/bulk` | 3/domain | Consulta WHOIS em massa (até 20 domínios) |
| `/v1/rdap/bulk` | 2/query | Consulta WHOIS |
| `/v1/prices/bulk` | 1/pair | Preços em massa |
| `/v1/dns/security` | 3 | Análise de segurança DNS |
| `/v1/dns/propagation` | 2 | Propagação de DNS |
| `/v1/dns/propagation/bulk` | 2/domain | Propagação de DNS |
| `/v1/email-auth/bulk` | 3/domain | Autenticação de email |
| `/v1/hosting/bulk` | 3/domain | Detecção de alojamento |
| `/v1/value/bulk` | 2/domain | Avaliação em massa |
| `/v1/health/bulk` | 3/domain | Verificação de saúde em massa |
| `/v1/subdomains` | 4-5 | Localizador de subdomínios |
| `/v1/subdomains/bulk` | 4-5/domain | Localizador de subdomínios |
| `/v1/report` | 5 | Relatório abrangente (poupa ~10 créditos em comparação com chamadas individuais) |

### Controle de créditos

Quando seus créditos chegam a zero, as solicitações de API que custam créditos retornam HTTP 402 (pagamento obrigatório). Ferramentas gratuitas baseadas em navegador não são afetadas.

`HTTP 402 Payment Required`

```json
{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Insufficient credits. This endpoint costs 2 credits but you have 0.",
    "credits_remaining": 0,
    "credits_required": 2,
    "purchase_url": "https://domscan.net/billing"
  }
}
```

Os créditos são renovados mensalmente no aniversário do cadastro.

### Cabeçalhos de resposta de créditos

Todas as respostas autenticadas da API incluem um cabeçalho X-Credits-Remaining mostrando seu saldo de crédito atual após a solicitação.

`X-Credits-Remaining: 9500`

Toda resposta /v1 autenticada, inclusive as de erro, traz estes cabeçalhos:

- `X-Credits-Charged`: créditos cobrados por esta requisição, líquidos de qualquer reembolso feito na mesma requisição (0 quando nada foi cobrado).

- `X-Credits-Remaining`: seu saldo após a requisição. É omitido no raro caso de o saldo não ser conhecido de antemão.

- `X-RateLimit-Limit`, `X-RateLimit-Remaining` e `X-RateLimit-Reset`: sua capacidade de rajada, as requisições que você ainda pode enviar imediatamente e o horário Unix em segundos em que a capacidade é totalmente reposta.

- MCP sobre HTTP retorna `X-Credits-Charged` e `X-Credits-Remaining` para as chamadas de ferramentas de cada requisição.

### Estime o custo antes de executar

Envie o método, o caminho, a consulta e o corpo de uma requisição para `POST /v1/estimate` para obter os créditos que ela cobraria, com detalhamento e observações. Nada é executado e a estimativa custa 0 créditos. Quando a cobrança final depende do resultado, a estimativa é o máximo e uma observação explica o motivo.

POST /v1/estimate

#### Corpo da requisição

| Parâmetro | Tipo | Descrição |
| --- | --- | --- |
| method obrigatório | string Valores permitidos `GET`, `POST`, `PUT`, `PATCH`, `DELETE` | Método HTTP da requisição a ser estimada. |
| path obrigatório | string | Caminho da requisição a ser estimada, por exemplo `/v1/value/bulk`. Uma query string no caminho também é lida. |
| query opcional | object | Parâmetros de consulta como objeto. Arrays são unidos por vírgulas. |
| body opcional | any | Corpo JSON que a requisição enviaria. |

#### Exemplo de requisição

```bash
curl -X POST "https://domscan.net/v1/estimate" \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"method":"POST","path":"/v1/value/bulk","body":{"domains":["example.com","example.org"]}}'
```

#### Exemplo de resposta

```json
{
  "credits": 2,
  "breakdown": [
    { "component": "domains", "quantity": 2, "unit_credits": 1, "credits": 2 }
  ],
  "notes": ["Requisições rejeitadas com status 4xx ou que falham com status 5xx são reembolsadas automaticamente."],
  "maximum": false,
  "rejected": false
}
```

#### Campos da resposta

| Campo | Tipo |
| --- | --- |
| `credits` | integer |
| `breakdown[]` | object[] |
| `breakdown[]` | object |
| `breakdown[].component` | string |
| `breakdown[].quantity` | integer |
| `breakdown[].unit_credits` | number |
| `breakdown[].credits` | integer |
| `notes[]` | string[] |
| `maximum` | boolean |
| `rejected` | boolean |
| `billing_model` | string |
| `endpoint` | object |
| `endpoint.method` | string |
| `endpoint.path` | string |
| `dry_run` | boolean |

Os endpoints de bulk, compare, recipe e pricing também aceitam `dry_run=true`. A requisição é respondida com HTTP 200 e a mesma estimativa mais `"dry_run": true`, sem executá-la nem cobrar créditos.

### Calculadora de créditos

Estime o seu uso de créditos para operações em massa:

Ponto final

Número de chamadas de API

Total de créditos necessários

100

Isso representa 1.0 % dos seus créditos mensais gratuitos
Ultrapassa o nível gratuito por 0 créditos

### Pacotes de créditos

Precisa de mais créditos? Compre pacotes que nunca expiram:

| Pacote | Preço | Por crédito |
| --- | --- | --- |
| 50,000 créditos | €9 / £7.50 / ¥1,500 | €0.00018 |
| 250,000 créditos | €29 / £24 / ¥4,800 | €0.000116 |
| 1,000,000 créditos | €79 / £66 / ¥13,000 | €0.000079 |