Domänsöknings-recept API-referens

Det här får du

Köa många API-begäranden som stöds och samla in resultaten utan att hålla en klientanslutning öppen.

AsynkrontRESTMCPSDK

Välj denna produkt när

Vem är det till för?

Använd fokuserade kontroller för ett enskilt beslut eller bygg en bredare profil när kontexten spelar roll.

Välj denna produkt när

Välj detta för att kontrollera kombinationer från en engelsk korpus med enstaka ord över 1 till 5 TLD:er, med upp till 100 ord- och TLD-kontroller per jobb.

Det här får du

Köa många API-begäranden som stöds och samla in resultaten utan att hålla en klientanslutning öppen.

Endpoints

Granska stödda operationer, indata, utdata, körningslägen och svarsbegränsningar innan du integrerar.

POST /v1/domain-discovery/jobs Visa API-referens

Credits och autentisering

1 Autentisering krävs. Se operationsreferensen för exakt kostnad och eventuell prissättning per objekt.

Exempel på operation

Använd dokumenterade operationer för att samla in, bedöma, berika, verifiera, jämföra, skydda eller övervaka offentliga bevis.

POST /v1/domain-discovery/jobs

Brödtextparametrar

Parameter	Typ	obligatorisk
tlds	string[]	obligatorisk
limit	integer	valfri
cursor	string	valfri
min_length	integer Standard `3`	valfri
max_length	integer Standard `16`	valfri
singular_only	boolean Standard `false`	valfri

Svarsfält

Fält	Typ
`job`	object
`job.id`	string
`job.status`	string
`job.total`	integer
`job.counts`	object
`job.counts.pending`	integer
`job.counts.processing`	integer
`job.counts.succeeded`	integer
`job.counts.failed`	integer
`job.counts.cancelled`	integer
`job.billing`	object
`job.billing.credits_charged`	integer
`job.billing.credits_refunded`	integer
`job.billing.credits_net`	integer
`job.webhook`	object
`job.webhook.configured`	boolean
`job.webhook.status`	string
`job.webhook.attempts`	integer
`job.status_url`	string
`job.results_url`	string
`job.results_csv_url`	string
`job.poll_after_ms`	integer \| null
`job.created_at`	string
`job.started_at`	string \| null
`job.completed_at`	string \| null
`job.cancelled_at`	string \| null
`job.updated_at`	string
`job.processing_deadline_at`	string
`job.results_expires_at`	string
`discovery`	object
`discovery.corpus`	string
`discovery.corpus_version`	string
`discovery.total_matching_words`	integer
`discovery.page_offset`	integer
`discovery.page_words`	integer
`discovery.domain_checks`	integer
`discovery.tlds[]`	string[]
`discovery.filters`	object
`discovery.filters.min_length`	integer
`discovery.filters.max_length`	integer
`discovery.filters.singular_only`	boolean
`discovery.credits_per_domain`	integer
`discovery.next_cursor`	string \| null

Exempelbegäran

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

Exempelsvar

{
  "job": {
    "id": "example-id",
    "status": "queued",
    "total": 1,
    "counts": {
      "pending": 1,
      "processing": 1,
      "succeeded": 1,
      "failed": 1,
      "cancelled": 1
    },
    "billing": {
      "credits_charged": 1,
      "credits_refunded": 1,
      "credits_net": 1
    },
    "webhook": {
      "configured": false,
      "status": "not_configured",
      "attempts": 1
    },
    "status_url": "https://example.com",
    "results_url": "https://example.com",
    "results_csv_url": "https://example.com",
    "created_at": "2026-08-27T12:00:00Z",
    "updated_at": "2026-08-27T12:00:00Z",
    "processing_deadline_at": "2026-08-27T12:00:00Z",
    "results_expires_at": "2026-08-27T12:00:00Z",
    "poll_after_ms": 1,
    "started_at": "2026-08-27T12:00:00Z",
    "completed_at": "2026-08-27T12:00:00Z",
    "cancelled_at": "2026-08-27T12:00:00Z"
  },
  "discovery": {
    "corpus": "iannuttall/unclaimed",
    "corpus_version": "example",
    "total_matching_words": 1,
    "page_offset": 1,
    "page_words": 1,
    "domain_checks": 1,
    "tlds": [
      "com",
      "net",
      "org"
    ],
    "filters": {
      "min_length": 1,
      "max_length": 1,
      "singular_only": false
    },
    "credits_per_domain": 1,
    "next_cursor": "example"
  }
}

Begränsningar och bevisgränser

Asynkrona jobb returnerar en identifierare för statuspollning och senare hämtning av resultat.

Bulkoperationer behandlar flera stödda indata och bevarar dokumenterade resultat per objekt.

Partiellt betyder att vissa begärda objekt eller komponenter slutfördes medan andra inte gjorde det.

Täckningen begränsas av dokumenterade indata, budgetar, källor och svarsbegränsningar.

Ett frånvarande eller okänt resultat bevisar inte att en identifierare kan tas i anspråk eller registreras.

Granskad 2026-08-22

Relaterade produkter

Vanliga frågor

Var hittar jag request- och response-referensen för Domänsöknings-recept?

Använd API-referensen för Domänsöknings-recept för att granska parametrar, svarsfält, exempel, statuskoder och stödda körningslägen.

Hur ska jag tolka okända eller ofullständiga resultat från Domänsöknings-recept?

Okända eller partiella resultat betyder att de begärda bevisen inte kunde fastställas helt. Behåll resultatstatus, konfidens, aktualitet och begränsningar i efterföljande beslut.

Hur prissätts Domänsöknings-recept?

Priset beror på operation och körningsläge. Se endpointreferensen för aktuell creditkostnad, autentiseringskrav och regler per objekt.