Kontrollera domäntillgänglighet API-referens

Det här får du

Kontrollera om ett domännamn är tillgängligt för en eller flera TLD.

SynkrontBulkRESTMCPSDKInteraktivt verktyg

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 statusen available, registered eller unknown med stödjande bevis. Availability garanterar inte registrerbarhet.

Det här får du

Kontrollera om ett domännamn är tillgängligt för en eller flera TLD.

Endpoints

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

GET /v1/status Visa API-referens

POST /v1/status/bulk 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.

GET /v1/status

Frågeparametrar

Parameter	Typ	obligatorisk
name	string	valfri
tlds	string	valfri
domain	string	valfri
prefer_cache	boolean Standard `false`	valfri

Svarsfält

Fält	Typ
`name`	string
`results[]`	object[]
`results[]`	object
`results[].domain`	string
`results[].tld`	string
`results[].available`	boolean \| null
`results[].source`	string
`results[].confidence`	string
`results[].checked_at`	string
`results[].latency_ms`	integer
`results[].error`	string
`confidence_summary`	object
`confidence_summary.scope`	string
`confidence_summary.requested_count`	integer
`confidence_summary.result_count`	integer
`confidence_summary.invalid_count`	integer
`confidence_summary.available_count`	integer
`confidence_summary.registered_count`	integer
`confidence_summary.authoritative_count`	integer
`confidence_summary.heuristic_count`	integer
`confidence_summary.cached_count`	integer
`confidence_summary.error_count`	integer
`confidence_summary.ambiguous_count`	integer
`confidence_summary.source_counts`	object
`confidence_summary.primary_source`	string \| null
`confidence_summary.cache_status`	string
`confidence_summary.rdap_calls`	integer
`confidence_summary.refreshes`	integer
`confidence_summary.cache_preference_misses`	integer
`confidence_summary.fallback_chain[]`	string[]
`confidence_summary.confidence_level`	string
`confidence_summary.determinacy_rate`	number
`confidence_summary.ambiguity_reason`	string \| null
`meta`	object
`meta.total_checked`	integer
`meta.available_count`	integer
`meta.duration_ms`	integer

Exempelbegäran

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/status?name=mycompany&tlds=com%2Cnet%2Corg%2Cio&domain=mycompany.com&prefer_cache=false"

Exempelsvar

{
  "name": "mycompany",
  "results": [
    {
      "domain": "mycompany.com",
      "tld": "com",
      "available": false,
      "source": "rdap",
      "latency_ms": 45
    },
    {
      "domain": "mycompany.io",
      "tld": "io",
      "available": true,
      "source": "rdap",
      "latency_ms": 67
    }
  ],
  "meta": {
    "total_checked": 2,
    "available_count": 1,
    "duration_ms": 120
  }
}

Begränsningar och bevisgränser

Okänt betyder att den begärda uppgiften inte kunde fastställas utifrån tillgängliga bevis.

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

Cachat innebär att lagrade bevis användes. Granska metadata för aktualitet när den finns.

Bevis kan förändras över tid. Använd tidsstämplar och fält för aktualitet när de finns.

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 Kontrollera domäntillgänglighet?

Använd API-referensen för Kontrollera domäntillgänglighet 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 Kontrollera domäntillgänglighet?

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 Kontrollera domäntillgänglighet?

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