API-referentie

Domeinovereenkomst API-referentie

Zoek domeinen die op een bepaald domein lijken op basis van naampatronen en trefwoorden. Gebruik deze referentie om het juiste endpoint te kiezen en precies te zien wat het teruggeeft.

Bewerkingen

GET /v1/similarity API-referentie bekijken

GET /v1/similarity

Bewerking: getDomainSimilarity Credits en authenticatie: 2 Authenticatie vereist
GET /v1/similarity Tegoeden: 2

Queryparameters

Parameter Type vereist
domain1 string vereist
domain2 string vereist

Antwoordvelden

Veld Type
domain1 string
domain2 string
overall_similarity number
risk_level string
analysis object
analysis.levenshtein_distance integer
analysis.levenshtein_similarity number
analysis.jaro_winkler_similarity number
analysis.visual_similarity number
analysis.keyboard_distance number
analysis.common_prefix_length integer
analysis.common_suffix_length integer
matching_methods[] string[]
is_potential_typosquat boolean
checked_at string
meta object

Voorbeeldverzoek

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/similarity?domain1=example.com&domain2=example.org"
const response = await fetch("https://domscan.net/v1/similarity?domain1=example.com&domain2=example.org", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
import os
import requests

response = requests.get(
    "https://domscan.net/v1/similarity?domain1=example.com&domain2=example.org",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/similarity?domain1=example.com&domain2=example.org", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	data, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(resp.Status, string(data))
}
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/similarity?domain1=example.com&domain2=example.org")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))

Voorbeeldantwoord

{
  "domain1": "example.com",
  "domain2": "exampel.com",
  "overall_similarity": 79,
  "risk_level": "medium",
  "analysis": {
    "levenshtein_distance": 2,
    "levenshtein_similarity": 71,
    "jaro_winkler_similarity": 97,
    "visual_similarity": 71,
    "keyboard_distance": 6.08,
    "common_prefix_length": 5,
    "common_suffix_length": 0
  },
  "matching_methods": [
    "jaro-winkler",
    "common-prefix",
    "same-tld"
  ],
  "is_potential_typosquat": true,
  "checked_at": "2026-10-09T10:15:30.000Z",
  "meta": {
    "served_by": "pop=MAD country=ES"
  }
}

HTTP-statuscodes

  • 200 OK
  • 400 Ongeldig verzoek
  • 401 Niet geautoriseerd
  • 402 Betaling vereist
  • 429 Te veel verzoeken

Referentiebronnen