Ontwikkelaarsreferentie

Credits en prijzen

DomScan-API: DomScan bevat 10.000 gratis tegels per maand. Geen creditcard vereist. Wij

Credits en prijzen

DomScan bevat 10.000 gratis tegels per maand. Geen creditcard vereist. Wij

Credits worden maandelijks vernieuwd op aanmeldjubileum. Meer credits nodig? Koop pakketten die nooit verlopen:

Credits per eindpunt

Hieronder vind je de kosten van veelgebruikte endpoints. Sommige referentie-endpoints zijn gratis. Gebruik /v1/pricing voor het volledige, machineleesbare tarievenoverzicht.

EindpuntTegoedenBeschrijving
/v1/coverage 0 TLD’s met RDAP-koppelingen weergeven
/v1/tlds 0 Lijst met TLD-metagegevens
/v1/watchlist 1 Uw volglijst weergeven
/v1/webhooks 2 Per melding die aan uw webhook-endpoint wordt geleverd. Mislukte leveringen worden terugbetaald en testgebeurtenissen zijn gratis.
/v1/status 1 Domeinbeschikbaarheid controleren
/v1/health/quick 1 Snelle gezondheidscontrole
/v1/dns 1 DNS-opzoeken
/v1/dns/bulk 1/domain Bulk-DNS-opzoeking (tot 25 domeinen)
/v1/ip 1 IP-geolocatie
/v1/value 2 Domeinwaardering
/v1/prices 0-1/pair Registratieprijzen
/v1/tlds/:tld 1 TLD-details
/v1/watchlist/check 1 Watchlist-item controleren
/v1/typos/permutations 1 Typovariaties
/v1/typos/score 1 Typosquatting-risicoscore
/v1/email/check 1 E-mailzwartelijst controleren
/v1/status/bulk 1/domain Controleer beschikbaarheid voor meerdere domeinnamen tegelijk. Ondersteunt tot 50 domeinen per aanvraag.
/v1/health 3 Volledige gezondheidscontrole
/v1/dns/all 2 Alle DNS-records
/v1/profile 3 Domeinprofiel
/v1/redirects 2 Omleidingsketen
/v1/tech 3-9 Technologiestack-detectie
/v1/categorize 3 Website categorisatie
/v1/similarity 2 Domeinovereenkomst
/v1/typos 2-3 Typosquatting-detectie
/v1/reputation 3 Domeinreputatie
/v1/reputation/bulk 3/domain Bulk domeinreputatie (tot 3 domeinen)
/v1/certificates 2 SSL-certificaat
/v1/certificates/bulk 2/domain SSL-certificaat
/v1/social 2 Controle sociale handgreep
/v1/social/bulk 2/handle Socialmediahandles in bulk controleren
/v1/company 3 Bedrijfsopzoeking
/v1/suggest 2-5 Domeinsuggersties
/v1/whois 3 WHOIS-opzoeken
/v1/whois/history 3 WHOIS-wijzigingsgeschiedenis
/v1/whois/bulk 3/domain Bulk WHOIS-zoekopdracht (maximaal 20 domeinen)
/v1/rdap/bulk 2/query WHOIS-opzoeken
/v1/prices/bulk 1/pair Bulkprijzen
/v1/dns/security 3 DNS-veiligheidsanalyse
/v1/dns/propagation 2 DNS-resolvers vergelijken
/v1/dns/propagation/bulk 2/domain DNS-resolvers vergelijken
/v1/email-auth/bulk 3/domain E-mailverificatie
/v1/hosting/bulk 3/domain Hostingdetectie
/v1/value/bulk 2/domain Bulk waardering
/v1/health/bulk 3/domain Bulk gezondheidscontrole
/v1/subdomains 4-5 Subdomeinzoeker
/v1/subdomains/bulk 4-5/domain Subdomeinzoeker
/v1/report 5 Uitgebreid rapport (bespaart ongeveer 10 tegels ten opzichte van individuele oproepen)

Afhandeling van credits

Wanneer uw credits op nul komen, retourneren API-verzoeken die credits kosten HTTP 402 (betaling vereist). Gratis browsertools worden niet beïnvloed.

HTTP 402 Payment Required
{
  "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"
  }
}

Meer credits nodig? Koop pakketten die nooit verlopen:

Credits worden maandelijks vernieuwd op aanmeldjubileum.

Creditheaders

Alle geverifieerde API-responses bevatten een X-Credits-Remaining-header die uw huidige creditsaldo na het verzoek weergeeft.

X-Credits-Remaining: 9500

Elk geauthenticeerd /v1-antwoord, ook bij fouten, bevat deze headers:

  • X-Credits-Charged: credits die dit verzoek heeft gekost, na aftrek van een terugbetaling binnen hetzelfde verzoek (0 als er niets in rekening is gebracht).
  • X-Credits-Remaining: uw saldo na het verzoek. Wordt weggelaten in het zeldzame geval dat het saldo nog niet bekend is.
  • X-RateLimit-Limit, X-RateLimit-Remaining en X-RateLimit-Reset: uw burstcapaciteit, het aantal verzoeken dat u direct nog kunt sturen en de Unix-tijd in seconden waarop de capaciteit volledig is aangevuld.
  • MCP via HTTP geeft X-Credits-Charged en X-Credits-Remaining terug voor de toolaanroepen in elk verzoek.

Raam de kosten voordat u uitvoert

Stuur de methode, het pad, de query en de body van een verzoek naar POST /v1/estimate om te zien hoeveel credits het zou kosten, met een specificatie en toelichting. Er wordt niets uitgevoerd en de raming kost 0 credits. Als de uiteindelijke kosten van de uitkomst afhangen, is de raming het maximum en legt een toelichting uit waarom.

POST /v1/estimate

Inhoud van het verzoek

ParameterTypeBeschrijving
method vereist string
Toegestane waarden GETPOSTPUTPATCHDELETE
HTTP-methode van het te ramen verzoek.
path vereist string Pad van het te ramen verzoek, bijvoorbeeld /v1/value/bulk. Een query string in het pad wordt ook gelezen.
query optioneel object Queryparameters als object. Arrays worden met komma's samengevoegd.
body optioneel any JSON-body die het verzoek zou verzenden.

Voorbeeldverzoek

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

Voorbeeldantwoord

{
  "credits": 2,
  "breakdown": [
    { "component": "domains", "quantity": 2, "unit_credits": 1, "credits": 2 }
  ],
  "notes": ["Verzoeken die met een 4xx-status worden afgewezen of met een 5xx-status mislukken, worden automatisch terugbetaald."],
  "maximum": false,
  "rejected": false
}

Antwoordvelden

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

Bulk-, compare-, recipe- en pricing-endpoints accepteren ook dry_run=true. Het verzoek wordt beantwoord met HTTP 200 en dezelfde raming plus "dry_run": true, zonder het uit te voeren of credits in rekening te brengen.

Creditcalculator

Schat uw creditverbruik voor bulkbewerkingen:

Totaal benodigde credits
100
Dat is 1.0% van uw gratis maandelijkse credits

Creditpakketten

Meer credits nodig? Koop pakketten die nooit verlopen:

PakketPrijsPer tegoed
50,000 tegoeden €9 / £7.50 / ¥1,500 €0.00018
250,000 tegoeden €29 / £24 / ¥4,800 €0.000116
1,000,000 tegoeden €79 / £66 / ¥13,000 €0.000079