Crediti e prezzi

Crediti e prezzi

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.

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.

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

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

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.

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.

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

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

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:

Pacchetti di crediti

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