Entwickler-Referenz

Credits und Preise

DomScan-API: DomScan enthält 10.000 kostenlose Credits pro Monat. Keine Kreditkarte erforderlich. Wir

Credits und Preise

DomScan enthält 10.000 kostenlose Credits pro Monat. Keine Kreditkarte erforderlich. Wir

Guthaben wird monatlich zum Registrierungsjubiläum erneuert. Benötigen Sie mehr Credits? Kaufen Sie Pakete, die niemals verfallen:

Credits pro Endpoint

Nachfolgend finden Sie die Kosten gängiger Endpunkte. Einige Referenzendpunkte sind kostenlos. Die vollständige, maschinenlesbare Preisliste finden Sie unter /v1/pricing.

EndpointCreditsBeschreibung
/v1/coverage 0 TLDs mit RDAP-Zuordnungen auflisten
/v1/tlds 0 TLD-Metadatenliste
/v1/watchlist 1 Ihre Überwachungsliste anzeigen
/v1/webhooks 2 Pro an Ihren Webhook-Endpunkt zugestelltem Alarm. Fehlgeschlagene Zustellungen werden erstattet, Testereignisse sind kostenlos.
/v1/status 1 Domain-Verfügbarkeit überprüfen
/v1/health/quick 1 Schnelle Gesundheitsprüfung
/v1/dns 1 DNS-Lookup
/v1/dns/bulk 1/domain Bulk-DNS-Abfrage (bis zu 25 Domains)
/v1/ip 1 IP-Geolokalisierung
/v1/value 2 Domain-Bewertung
/v1/prices 0-1/pair Registrierungspreise
/v1/tlds/:tld 1 TLD-Details
/v1/watchlist/check 1 Überwachungslisten-Element überprüfen
/v1/typos/permutations 1 Typo-Permutationen
/v1/typos/score 1 Typo-Risikobewertung
/v1/email/check 1 E-Mail-Blacklist-Prüfung
/v1/status/bulk 1/domain Überprüfen Sie die Verfügbarkeit mehrerer Domain-Namen auf einmal. Unterstützt bis zu 50 Domains pro Anfrage.
/v1/health 3 Vollständige Gesundheitsprüfung
/v1/dns/all 2 Alle DNS-Einträge
/v1/profile 3 Domain-Profil
/v1/redirects 2 Weiterleitungskette
/v1/tech 3-9 Tech-Stack-Erkennung
/v1/categorize 3 Website-Kategorisierung
/v1/similarity 2 Domain-Ähnlichkeit
/v1/typos 2-3 Typosquatting-Erkennung
/v1/reputation 3 Domain-Reputation
/v1/reputation/bulk 3/domain Domain-Reputation im Bulk (bis zu 3 Domains)
/v1/certificates 2 SSL-Zertifikat
/v1/certificates/bulk 2/domain SSL-Zertifikat
/v1/social 2 Social-Media-Verfügbarkeitsprüfung
/v1/social/bulk 2/handle Massenprüfung von Social-Media-Handles
/v1/company 3 Unternehmenssuche
/v1/suggest 2-5 Domain-Vorschläge
/v1/whois 3 WHOIS-Lookup
/v1/whois/history 3 WHOIS-Änderungsverlauf
/v1/whois/bulk 3/domain Massen-WHOIS-Abfrage (bis zu 20 Domains)
/v1/rdap/bulk 2/query WHOIS-Lookup
/v1/prices/bulk 1/pair Massen-Preisgestaltung
/v1/dns/security 3 DNS-Sicherheitsanalyse
/v1/dns/propagation 2 DNS-Propagation
/v1/dns/propagation/bulk 2/domain DNS-Propagation
/v1/email-auth/bulk 3/domain E-Mail-Authentifizierung
/v1/hosting/bulk 3/domain Hosting-Erkennung
/v1/value/bulk 2/domain Massen-Bewertung
/v1/health/bulk 3/domain Massen-Gesundheitsprüfung
/v1/subdomains 4-5 Subdomain-Finder
/v1/subdomains/bulk 4-5/domain Subdomain-Finder
/v1/report 5 Umfassender Bericht (spart ca. 10 Credits gegenüber einzelnen Aufrufen)

Credit-Durchsetzung

Wenn Ihr Guthaben Null erreicht, geben API-Anfragen, die Gutschriften kosten, HTTP 402 (Zahlung erforderlich) zurück. Kostenlose browserbasierte Tools sind nicht betroffen.

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

Benötigen Sie mehr Credits? Kaufen Sie Pakete, die niemals verfallen:

Guthaben wird monatlich zum Registrierungsjubiläum erneuert.

Credit-Antwort-Header

Alle authentifizierten API-Antworten enthalten einen X-Credits-Remaining-Header, der Ihr aktuelles Guthaben nach der Anfrage anzeigt.

X-Credits-Remaining: 9500

Jede authentifizierte /v1-Antwort, auch bei Fehlern, enthält diese Header:

  • X-Credits-Charged: Credits, die diese Anfrage berechnet hat, abzüglich einer Erstattung in derselben Anfrage (0, wenn nichts berechnet wurde).
  • X-Credits-Remaining: Ihr Guthaben nach der Anfrage. Der Header entfällt im seltenen Fall, dass das Guthaben nicht bereits bekannt ist.
  • X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset: Ihre Burst-Kapazität, die Anfragen, die Sie noch sofort senden können, und die Unix-Zeit in Sekunden, zu der die Kapazität vollständig aufgefüllt ist.
  • MCP über HTTP gibt X-Credits-Charged und X-Credits-Remaining für die Tool-Aufrufe jeder Anfrage zurück.

Kosten vor der Ausführung schätzen

Senden Sie Methode, Pfad, Query und Body einer Anfrage an POST /v1/estimate, um die Credits zu erhalten, die sie berechnen würde, samt Aufschlüsselung und Hinweisen. Es wird nichts ausgeführt und die Schätzung kostet 0 Credits. Hängt die endgültige Berechnung vom Ergebnis ab, ist die Schätzung der Höchstwert und ein Hinweis erklärt den Grund.

POST /v1/estimate

Anfragetext

ParameterTypBeschreibung
method erforderlich string
Zulässige Werte GETPOSTPUTPATCHDELETE
HTTP-Methode der Anfrage, die geschätzt werden soll.
path erforderlich string Pfad der Anfrage, die geschätzt werden soll, zum Beispiel /v1/value/bulk. Ein Query-String im Pfad wird ebenfalls gelesen.
query optional object Query-Parameter als Objekt. Arrays werden mit Kommas verbunden.
body optional any JSON-Body, den die Anfrage senden würde.

Beispielanfrage

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

Beispielantwort

{
  "credits": 2,
  "breakdown": [
    { "component": "domains", "quantity": 2, "unit_credits": 1, "credits": 2 }
  ],
  "notes": ["Anfragen, die mit einem 4xx-Status abgelehnt werden oder mit einem 5xx-Status fehlschlagen, werden automatisch erstattet."],
  "maximum": false,
  "rejected": false
}

Antwortfelder

Feld Typ
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- und Pricing-Endpoints akzeptieren außerdem dry_run=true. Die Anfrage wird mit HTTP 200 und derselben Schätzung plus "dry_run": true beantwortet, ohne sie auszuführen oder Credits zu berechnen.

Credit-Rechner

Schätzen Sie Ihren Credit-Verbrauch für Massen-Operationen:

Benötigte Credits insgesamt
100
Das sind 1.0% Ihrer kostenlosen monatlichen Credits

Credit-Pakete

Benötigen Sie mehr Credits? Kaufen Sie Pakete, die niemals verfallen:

PaketPreisPro Credit
50,000 Credits €9 / £7.50 / ¥1,500 €0.00018
250,000 Credits €29 / £24 / ¥4,800 €0.000116
1,000,000 Credits €79 / £66 / ¥13,000 €0.000079