> 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/it/docs/credits-pricing

# Crediti e prezzi

API DomScan: DomScan include 10.000 crediti gratuiti al mese. Nessuna carta di credito richiesta. Noi

DomScan include 10.000 crediti gratuiti al mese. Nessuna carta di credito richiesta. Noi

I crediti si rinnovano mensilmente alla data anniversario della registrazione. Hai bisogno di più crediti? Acquista pacchetti che non scadono mai:

### Crediti per endpoint

Di seguito trovi i costi degli endpoint più comuni. Alcuni endpoint di riferimento sono gratuiti. Per il tariffario completo e leggibile dalle macchine, usa /v1/pricing.

| Endpoint | Crediti | Descrizione |
| --- | --- | --- |
| `/v1/coverage` | 0 | Elenca i TLD con mappature RDAP |
| `/v1/tlds` | 0 | Elenco metadati TLD |
| `/v1/watchlist` | 1 | Visualizza la tua lista di controllo |
| `/v1/webhooks` | 2 | Per ogni avviso consegnato al tuo endpoint webhook. Le consegne non riuscite vengono rimborsate e gli eventi di test sono gratuiti. |
| `/v1/status` | 1 | Controlla la disponibilità del dominio |
| `/v1/health/quick` | 1 | Controllo salute rapido |
| `/v1/dns` | 1 | Ricerca DNS |
| `/v1/dns/bulk` | 1/domain | Lookup DNS bulk (fino a 25 domini) |
| `/v1/ip` | 1 | Geolocalizzazione IP |
| `/v1/value` | 2 | Valutazione del dominio |
| `/v1/prices` | 0-1/pair | Prezzi di registrazione |
| `/v1/tlds/:tld` | 1 | Dettagli TLD |
| `/v1/watchlist/check` | 1 | Controlla elemento della lista di controllo |
| `/v1/typos/permutations` | 1 | Permutazioni di errori di digitazione |
| `/v1/typos/score` | 1 | Punteggio di rischio di errori di digitazione |
| `/v1/email/check` | 1 | Controllo lista nera email |
| `/v1/status/bulk` | 1/domain | Controlla la disponibilità di più nomi di dominio contemporaneamente. Supporta fino a 50 domini per richiesta. |
| `/v1/health` | 3 | Controllo salute completo |
| `/v1/dns/all` | 2 | Tutti i record DNS |
| `/v1/profile` | 3 | Profilo del dominio |
| `/v1/redirects` | 2 | Catena di reindirizzamento |
| `/v1/tech` | 3-9 | Rilevamento stack tecnologico |
| `/v1/categorize` | 3 | Categorizzazione sito web |
| `/v1/similarity` | 2 | Somiglianza dominio |
| `/v1/typos` | 2-3 | Rilevamento typosquatting |
| `/v1/reputation` | 3 | Reputazione del dominio |
| `/v1/reputation/bulk` | 3/domain | Reputazione domini bulk (fino a 3 domini) |
| `/v1/certificates` | 2 | Certificato SSL |
| `/v1/certificates/bulk` | 2/domain | Certificato SSL |
| `/v1/social` | 2 | Controllo handle social |
| `/v1/social/bulk` | 2/handle | Verifica in blocco degli handle social |
| `/v1/company` | 3 | Ricerca azienda |
| `/v1/suggest` | 2-5 | Suggerimenti di domini |
| `/v1/whois` | 3 | Ricerca WHOIS |
| `/v1/whois/history` | 3 | Cronologia modifiche WHOIS |
| `/v1/whois/bulk` | 3/domain | Ricerca WHOIS in blocco (fino a 20 domini) |
| `/v1/rdap/bulk` | 2/query | Ricerca WHOIS |
| `/v1/prices/bulk` | 1/pair | Prezzi in massa |
| `/v1/dns/security` | 3 | Analisi della sicurezza DNS |
| `/v1/dns/propagation` | 2 | Confronto tra resolver DNS |
| `/v1/dns/propagation/bulk` | 2/domain | Confronto tra resolver DNS |
| `/v1/email-auth/bulk` | 3/domain | Autenticazione email |
| `/v1/hosting/bulk` | 3/domain | Rilevamento hosting |
| `/v1/value/bulk` | 2/domain | Valutazione in massa |
| `/v1/health/bulk` | 3/domain | Controllo salute in massa |
| `/v1/subdomains` | 4-5 | Finder sottodomini |
| `/v1/subdomains/bulk` | 4-5/domain | Finder sottodomini |
| `/v1/report` | 5 | Rapporto completo (risparmia ~10 crediti rispetto alle chiamate individuali) |

### Applicazione dei crediti

Quando i tuoi crediti raggiungono lo zero, le richieste API che costano crediti restituiscono HTTP 402 (Pagamento richiesto). Gli strumenti gratuiti basati su browser non sono interessati.

`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"
  }
}
```

I crediti si rinnovano mensilmente alla data anniversario della registrazione.

### Header di risposta sui crediti

Tutte le risposte API autenticate includono un'intestazione X-Credits-Remaining che mostra il saldo del tuo credito attuale dopo la richiesta.

`X-Credits-Remaining: 9500`

Ogni risposta /v1 autenticata, errori inclusi, riporta questi header:

- `X-Credits-Charged`: crediti addebitati da questa richiesta, al netto di eventuali rimborsi effettuati nella stessa richiesta (0 quando non è stato addebitato nulla).

- `X-Credits-Remaining`: il tuo saldo dopo la richiesta. Viene omesso nel raro caso in cui il saldo non sia già noto.

- `X-RateLimit-Limit`, `X-RateLimit-Remaining` e `X-RateLimit-Reset`: la tua capacità di burst, le richieste che puoi ancora inviare subito e l’ora Unix in secondi in cui la capacità si ricostituisce completamente.

- MCP su HTTP restituisce `X-Credits-Charged` e `X-Credits-Remaining` per le chiamate agli strumenti di ogni richiesta.

### Stima il costo prima di eseguire

Invia metodo, percorso, query e body di una richiesta a `POST /v1/estimate` per ottenere i crediti che addebiterebbe, con dettaglio e note. Non viene eseguito nulla e la stima costa 0 crediti. Quando l’addebito finale dipende dall’esito, la stima è il massimo e una nota ne spiega il motivo.

POST /v1/estimate

#### Corpo della richiesta

| Parametro | Tipo | Descrizione |
| --- | --- | --- |
| method obbligatorio | string Valori consentiti `GET`, `POST`, `PUT`, `PATCH`, `DELETE` | Metodo HTTP della richiesta da stimare. |
| path obbligatorio | string | Percorso della richiesta da stimare, ad esempio `/v1/value/bulk`. Viene letta anche una query string nel percorso. |
| query facoltativo | object | Parametri di query come oggetto. Gli array vengono uniti con virgole. |
| body facoltativo | any | Body JSON che la richiesta invierebbe. |

#### Richiesta di esempio

```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"]}}'
```

#### Risposta di esempio

```json
{
  "credits": 2,
  "breakdown": [
    { "component": "domains", "quantity": 2, "unit_credits": 1, "credits": 2 }
  ],
  "notes": ["Le richieste rifiutate con stato 4xx o che falliscono con stato 5xx vengono rimborsate automaticamente."],
  "maximum": false,
  "rejected": false
}
```

#### Campi della risposta

| 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 |

Gli endpoint bulk, compare, recipe e pricing accettano anche `dry_run=true`. La richiesta riceve una risposta HTTP 200 con la stessa stima più `"dry_run": true`, senza essere eseguita né addebitare crediti.

### Calcolatore di crediti

Stima l'utilizzo dei crediti per le operazioni in massa:

Endpoint

Numero di chiamate API

Crediti totali necessari

100

Si tratta del 1.0 % dei tuoi crediti mensili gratuiti
Supera il livello gratuito di 0 crediti

### Pacchetti di crediti

Hai bisogno di più crediti? Acquista pacchetti che non scadono mai:

| Pacchetto | Prezzo | Per credito |
| --- | --- | --- |
| 50,000 crediti | €9 / £7.50 / ¥1,500 | €0.00018 |
| 250,000 crediti | €29 / £24 / ¥4,800 | €0.000116 |
| 1,000,000 crediti | €79 / £66 / ¥13,000 | €0.000079 |