Domain-Finder Rezept-API

Q: Welche Endpoints sind enthalten?

Dieser Leitfaden umfasst 4 öffentliche Endpoints: POST /v1/domain-discovery/jobs , GET /v1/batches/:job_id , GET /v1/batches/:job_id/results , DELETE /v1/batches/:job_id .

curl -X POST "https://domscan.net/v1/domain-discovery/jobs" \ -H "X-API-Key: $DOMSCAN_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: discovery-com-io-1" \ -d '{"tlds":["com","io"],"limit":25,"min_length":4,"max_length":12,"singular_only":true}'

{ "job": { "id": "bat_...", "status": "queued", "total": 50, "status_url": "https://domscan.net/v1/batches/bat_...", "results_url": "https://domscan.net/v1/batches/bat_.../results" }, "discovery": { "page_words": 25, "tlds": ["com", "io"], "domain_checks": 50, "credits_per_domain": 1, "next_cursor": "..." } }

Kategorie Domain-Suche und Preise

Endpunkte 4

Credits 0-1/item

Authentifizierung Authentifizierung erforderlich

Wird von Menschen in großartigen Unternehmen verwendet

Vertrauenssignale vor der Integration

Transparente Dokumentation, authentifizierte Anfragen und sichtbare Zuverlässigkeitsdetails erleichtern die Bewertung von DomScan vor dem Launch.

Live Dienststatus

Prüfen Sie vor der Integration den aktuellen Dienstzustand und die dokumentierten Fehlerantworten.

OpenAPI API-Artefakte

OpenAPI, Swagger, Postman, CLI, SDK und MCP-Links sind nur einen Klick entfernt.

API-Schlüssel Geschützter Zugriff

Authentifizierte Endpunkte nutzen API-Schlüssel mit klaren Credit-Kosten vor dem Aufruf.

10,000 Kostenloses Kontingent

Starte mit 10.000 monatlichen Credits und upgrade erst, wenn die Nutzung wächst.

Wobei diese API beim Bauen hilft

Nutze diese Seite als Produktionsbriefing: Endpoints, Beispiele, Antwortstruktur und Workflow-Bausteine, um DomScan in dein Produkt einzubinden.

Produkt-Workflows

Bette Domainchecks, DNS-Intelligence, Risikosignale oder Anreicherung in Onboarding, Suche und interne Tools ein.

Analysten-Automatisierung

Ersetze wiederholte manuelle Lookups durch geplante Jobs, Alerts und reproduzierbare Untersuchungsschritte.

Saubere JSON-Daten

Nutze vorhersehbare Felder, dokumentierte Statuscodes und Credit-Kosten statt Provider-Seiten zu scrapen.

KI- und Ops-Tools

Versorge Agenten, Dashboards, SOAR-Playbooks und CRMs über OpenAPI, SDK, Postman oder MCP.

Integrationsablauf

Ein einfacher Weg von der ersten Anfrage bis zur wiederholbaren Nutzung in Produktion.

Einmal authentifizieren

Sende deinen API-Schlüssel mit dem dokumentierten Header und halte Anfragen über Services hinweg konsistent.

Mit Beispielen abfragen

Starte mit den curl- und HTTP-Beispielen und übertrage die Parameter dann in deinen Anwendungscode.

Betreiben und überwachen

Nutze Statuscodes, Credit-Kosten und Antwortfelder, um Retries, Logs und Alerts zu bauen.

Developer-Kit

Wechsle von dieser Seite zu maschinenlesbaren Docs, Request-Sammlungen, SDKs oder Agenten-Tools.

OpenAPI-Schema

Generiere Clients oder prüfe jede Request- und Response-Struktur.

Postman-Collection

Importiere fertige Requests für manuelle Tests und Team-Handoff.

SDKs und CLI

Nutze gepflegte Pakete und Kommandozeilen-Workflows statt Boilerplate zu schreiben.

MCP-Integration

Stelle Domain-Intelligence für KI-Agenten und interne Assistenten bereit.

Parameter- und Antwortkarte

Prüfe Eingaben, Ausgabefelder und Statuscodes, bevor du den Endpoint in deinen Client einbindest.

Request-Parameter

Parameter

tldslimitcursormin_lengthmax_lengthsingular_onlyjob_idafterformat

Antwortfelder

Beispielantwort

jobjob.idjob.statusjob.totaljob.status_urljob.results_urldiscoverydiscovery.page_wordsdiscovery.tldsdiscovery.domain_checksdiscovery.credits_per_domaindiscovery.next_cursor

Statusabdeckung

HTTP-Statuscodes

200202400401402409429

Endpunkte

POST /v1/domain-discovery/jobs

Credits: 1/itemAuthentifizierung: Authentifizierung erforderlich

tldslimitcursormin_lengthmax_lengthsingular_only

GET /v1/batches/:job_id

Credits: 0Authentifizierung: Authentifizierung erforderlich

job_id

GET /v1/batches/:job_id/results

Credits: 0Authentifizierung: Authentifizierung erforderlich

job_idafterlimitformat

DELETE /v1/batches/:job_id

Credits: 0Authentifizierung: Authentifizierung erforderlich

job_id

Vertrauenssignale vor der Integration

Transparente Dokumentation, authentifizierte Anfragen und sichtbare Zuverlässigkeitsdetails erleichtern die Bewertung von DomScan vor dem Launch.

Dienststatus API-Artefakte

OpenAPI, Swagger, Postman, CLI, SDK und MCP-Links sind nur einen Klick entfernt.

API-Schlüssel Geschützter Zugriff

Authentifizierte Endpunkte nutzen API-Schlüssel mit klaren Credit-Kosten vor dem Aufruf.

Kostenloses Kontingent Kostenlos Anmelden

Starte mit 10.000 monatlichen Credits und upgrade erst, wenn die Nutzung wächst.

Aktiv Beispielanfrage

Starte mit den curl- und HTTP-Beispielen und übertrage die Parameter dann in deinen Anwendungscode.

Hauptfunktionen

Endpunkte

POST /v1/domain-discovery/jobs • GET /v1/batches/:job_id • GET /v1/batches/:job_id/results • DELETE /v1/batches/:job_id

Parameter

tlds, limit, cursor, min_length, max_length, singular_only, job_id, after, format

HTTP-Statuscodes

200, 202, 400, 401, 402, 409, 429

Credits / Authentifizierung

0-1/item / Authentifizierung erforderlich

Beispielanfrage

POST /v1/domain-discovery/jobs bash

curl -X POST "https://domscan.net/v1/domain-discovery/jobs" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: discovery-com-io-1" \
  -d '{"tlds":["com","io"],"limit":25,"min_length":4,"max_length":12,"singular_only":true}'

Beispielantwort

202 Accepted json

{
  "job": {
    "id": "bat_...",
    "status": "queued",
    "total": 50,
    "status_url": "https://domscan.net/v1/batches/bat_...",
    "results_url": "https://domscan.net/v1/batches/bat_.../results"
  },
  "discovery": {
    "page_words": 25,
    "tlds": ["com", "io"],
    "domain_checks": 50,
    "credits_per_domain": 1,
    "next_cursor": "..."
  }
}

Häufig gestellte Fragen

Welche Endpoints sind enthalten?

Dieser Leitfaden umfasst 4 öffentliche Endpoints: POST /v1/domain-discovery/jobs, GET /v1/batches/:job_id, GET /v1/batches/:job_id/results, DELETE /v1/batches/:job_id.

Benötigt diese API eine Authentifizierung?

Ja. Senden Sie Ihren API-Schlüssel mit dem Header `X-API-Key` oder `Authorization: Bearer`, wenn Sie Domain-Finder Rezept aufrufen.

Wie viele Credits werden verwendet?

Anfragen in diesen Leitfäden verwenden je nach Endpoint 0-1/item Credits. Bei Bulk-Endpunkten werden Credits zum standardmäßigen Satz pro Element berechnet.

Wo sehe ich die vollständigen Parameter und verwandten Endpoints?

Nutzen Sie die vollständige Dokumentation für Domain-Finder Rezept, um Parameterdetails, Authentifizierungshinweise und verwandte Endpoints derselben API-Familie zu prüfen.

HTTP-Statuscodes

Wir dokumentieren die HTTP-Statuscodes, die Ihr Client behandeln sollte, damit Sie erfolgreiche Antworten, Authentifizierungsprobleme, Credits, Ratenlimits, fehlende Daten und Upstream-Fehler unterscheiden können.

OK 200

Anfrage erfolgreich

Akzeptiert 202

Cache-only-Subdomain-Fehltreffer für eine Hintergrundaktualisierung akzeptiert. Es werden keine Credits berechnet; versuche es nach der Retry-After-Wartezeit erneut.

Bad Request 400

Ungültige Parameter

Nicht autorisiert 401

API-Schlüssel oder Sitzung fehlt oder ist ungültig.

Zahlung erforderlich 402

Nicht genügend Credits für diese Anfrage.

HTTP 409 409

Too Many Requests 429

Ratenlimit überschritten

Starten Sie kostenlos mit 10.000 Credits pro Monat. Nutzen Sie jede öffentliche API und fügen Sie nur bei Bedarf Credits hinzu.

Kostenlos starten Dokumentation anzeigen

Support

Domain-Finder Rezept-API

Vertrauenssignale vor der Integration

Wobei diese API beim Bauen hilft

Integrationsablauf

Developer-Kit

Parameter- und Antwortkarte

Endpunkte

Vertrauenssignale vor der Integration

Hauptfunktionen

Beispielanfrage

Beispielantwort

Häufig gestellte Fragen

Verwandte Tools & Ressourcen

HTTP-Statuscodes