Domeinzoekrecept-API

Q: Welke endpoints zijn inbegrepen?

Deze gids behandelt 4 publieke 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": "..." } }

Categorie Domein zoeken en prijzen

Endpoints 4

Credits 0-1/item

Authenticatie Authenticatie vereist

Gebruikt door mensen bij geweldige bedrijven

Vertrouwenssignalen voordat je integreert

Transparante documentatie, geauthenticeerde requests en zichtbare betrouwbaarheidsdetails maken DomScan makkelijker te beoordelen voor livegang.

Live Servicestatus

Controleer vóór de integratie de live servicestatus en de gedocumenteerde foutreacties.

OpenAPI API-artifacts

OpenAPI, Swagger, Postman, CLI, SDK en MCP-links zijn één klik verwijderd.

API-sleutels Beschermde toegang

Geauthenticeerde endpoints gebruiken API-sleutels met duidelijke creditkosten voordat je ze aanroept.

10,000 Gratis tegoed

Begin met 10.000 maandelijkse credits en upgrade pas wanneer het gebruik groeit.

Wat deze API je helpt bouwen

Gebruik deze pagina als productiebriefing: endpoints, voorbeelden, responsstructuur en workflow-onderdelen om DomScan in je product te koppelen.

Productworkflows

Integreer domeinchecks, DNS-intelligence, risicosignalen of verrijking in onboarding, zoeken en interne tools.

Analistautomatisering

Vervang herhaalde handmatige lookups door geplande taken, alerts en reproduceerbare onderzoeksstappen.

Schone JSON-data

Gebruik voorspelbare velden, gedocumenteerde statuscodes en kredietkosten in plaats van providerpagina’s te scrapen.

AI- en ops-tools

Voed agents, dashboards, SOAR-playbooks en CRMs via OpenAPI, SDK, Postman of MCP.

Integratieworkflow

Een eenvoudig pad van de eerste request naar herhaalbaar productiegebruik.

Eenmalig authenticeren

Stuur je API-sleutel met de gedocumenteerde header en houd requests consistent tussen services.

Query met voorbeelden

Start met de curl- en HTTP-voorbeelden en map daarna de parameters naar je applicatiecode.

Opereren en monitoren

Gebruik statuscodes, kredietkosten en responsvelden om retries, logs en alerts te bouwen.

Developerkit

Ga vanaf deze pagina naar machineleesbare docs, requestcollecties, SDKs of agenttools.

OpenAPI-schema

Genereer clients of inspecteer elke request- en responsvorm.

Postman-collectie

Importeer kant-en-klare requests voor handmatig testen en overdracht aan het team.

SDKs en CLI

Gebruik onderhouden pakketten en commandline-workflows in plaats van boilerplate te schrijven.

MCP-integratie

Stel domeinintelligence beschikbaar aan AI-agents en interne assistentworkflows.

Parameter- en responskaart

Bekijk inputs, outputvelden en statuscodes voordat je het endpoint in je client aansluit.

Requestparameters

Parameter

tldslimitcursormin_lengthmax_lengthsingular_onlyjob_idafterformat

Responsvelden

Voorbeeldantwoord

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

Statusdekking

HTTP-statuscodes

200202400401402409429

Endpoints

POST /v1/domain-discovery/jobs

Credits: 1/itemAuthenticatie: Authenticatie vereist

tldslimitcursormin_lengthmax_lengthsingular_only

GET /v1/batches/:job_id

Credits: 0Authenticatie: Authenticatie vereist

job_id

GET /v1/batches/:job_id/results

Credits: 0Authenticatie: Authenticatie vereist

job_idafterlimitformat

DELETE /v1/batches/:job_id

Credits: 0Authenticatie: Authenticatie vereist

job_id

Vertrouwenssignalen voordat je integreert

Transparante documentatie, geauthenticeerde requests en zichtbare betrouwbaarheidsdetails maken DomScan makkelijker te beoordelen voor livegang.

Servicestatus API-artifacts

OpenAPI, Swagger, Postman, CLI, SDK en MCP-links zijn één klik verwijderd.

API-sleutels Beschermde toegang

Geauthenticeerde endpoints gebruiken API-sleutels met duidelijke creditkosten voordat je ze aanroept.

Gratis tegoed Gratis Registreren

Begin met 10.000 maandelijkse credits en upgrade pas wanneer het gebruik groeit.

Actief Voorbeeldverzoek

Start met de curl- en HTTP-voorbeelden en map daarna de parameters naar je applicatiecode.

Belangrijkste functies

Endpoints

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

0-1/item / Authenticatie vereist

Voorbeeldverzoek

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

Voorbeeldantwoord

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

Veelgestelde vragen

Welke endpoints zijn inbegrepen?

Deze gids behandelt 4 publieke endpoints: POST /v1/domain-discovery/jobs, GET /v1/batches/:job_id, GET /v1/batches/:job_id/results, DELETE /v1/batches/:job_id.

Is voor deze API authenticatie vereist?

Ja. Stuur uw API-sleutel mee in de `X-API-Key`- of `Authorization: Bearer`-header wanneer u Domeinzoekrecept aanroept.

Hoeveel credits gebruikt het?

Verzoeken in deze gidsen gebruiken 0-1/item credits, afhankelijk van het endpoint. Voor bulk-endpoints gebruiken credits het standaardtarief per item.

Waar kan ik de volledige parameters en gerelateerde endpoints zien?

Gebruik de volledige documentatie voor Domeinzoekrecept om parameterdetails, authenticatie-notities en gerelateerde endpoints binnen dezelfde API-familie te bekijken.

Gerelateerde hulpprogramma's en bronnen

HTTP-statuscodes

We documenteren de HTTP-statuscodes die je client moet afhandelen, zodat je succesvolle responses, authenticatieproblemen, credits, ratelimieten, ontbrekende gegevens en upstreamfouten kunt onderscheiden.

OK 200

Aanvraag geslaagd

Geaccepteerd 202

Cache-only subdomeinmisser geaccepteerd voor vernieuwing op de achtergrond. Er worden geen credits gerekend; probeer opnieuw na de Retry-After-vertraging.

Ongeldig verzoek 400

Ongeldige parameters

Niet geautoriseerd 401

API-sleutel of sessie ontbreekt of is ongeldig.

Betaling vereist 402

Niet genoeg credits om deze aanvraag uit te voeren.

HTTP 409 409

Te veel verzoeken 429

Snelheidslimiet overschreden

Start gratis met 10.000 tegoeden per maand. Gebruik elke openbare API en voeg alleen tegoeden toe wanneer u ze nodig hebt.

Gratis Starten Documentatie bekijken