Справочник разработчика

Защитная регистрация

Изучите документацию API Защитная регистрация, параметры запросов, поля ответов, примеры кода и обработку ошибок для интеграций DomScan.

Защитная регистрация

Защитите свой бренд, определив, какие варианты доменов следует зарегистрировать превентивно. Анализирует риски тайпсквоттинга, популярные TLD и формирует приоритетный список для регистрации.

GET /v1/recipes/defensive-registration

Параметры запроса

Параметр	Тип	обязателен
brand	string	обязателен
owned_domains	string	обязателен
priority_tlds	string	опционально
include_typos	boolean По умолчанию `true`	опционально
budget	number	опционально

Поля ответа

Поле	Тип
`success`	boolean
`data`	object
`data.brand`	string
`data.summary`	object
`data.summary.total_candidates`	number
`data.summary.already_owned`	number
`data.summary.available`	number
`data.summary.registered_by_others`	number
`data.summary.within_budget`	number
`data.priority_registrations[]`	object[]
`data.priority_registrations[]`	object
`data.priority_registrations[].domain`	string
`data.priority_registrations[].type`	string
`data.priority_registrations[].available`	boolean
`data.priority_registrations[].risk_if_unowned`	string
`data.priority_registrations[].price`	number
`data.priority_registrations[].registrar`	string
`data.typo_threats[]`	object[]
`data.typo_threats[]`	object
`data.typo_threats[].domain`	string
`data.typo_threats[].type`	string
`data.typo_threats[].available`	boolean
`data.typo_threats[].risk_if_unowned`	string
`data.typo_threats[].price`	null
`data.typo_threats[].registrar`	null
`data.shopping_cart`	object
`data.shopping_cart.domains[]`	string[]
`data.shopping_cart.total_cost`	number
`data.shopping_cart.within_budget`	boolean
`meta`	object
`meta.recipe_name`	string
`meta.credits_used`	number
`meta.credits_saved`	number
`meta.duration_ms`	number
`meta.components_called[]`	string[]
`meta.cached_components[]`	string[]
`meta.timestamp`	string
`errors[]`	array

Пример запроса

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/recipes/defensive-registration?brand=acme&owned_domains=acme.com&priority_tlds=example.com&include_typos=true&budget=example.com"

Пример ответа

{
  "success": true,
  "data": {
    "brand": "acme",
    "summary": {
      "total_candidates": 18,
      "already_owned": 3,
      "available": 9,
      "registered_by_others": 6,
      "within_budget": 5
    },
    "priority_registrations": [
      {
        "domain": "acme.io",
        "type": "tld_variant",
        "available": true,
        "risk_if_unowned": "high",
        "price": 39.99,
        "registrar": "porkbun"
      }
    ],
    "typo_threats": [
      {
        "domain": "acm3.com",
        "type": "typo",
        "available": false,
        "risk_if_unowned": "high",
        "price": null,
        "registrar": null
      }
    ],
    "shopping_cart": {
      "domains": [
        "acme.io",
        "acme.co"
      ],
      "total_cost": 63.98,
      "within_budget": true
    }
  },
  "meta": {
    "recipe_name": "defensive-registration",
    "credits_used": 12,
    "credits_saved": 8,
    "duration_ms": 688,
    "components_called": [
      "typosquatting",
      "availability",
      "pricing",
      "tld-intelligence"
    ],
    "cached_components": [
      "pricing"
    ],
    "timestamp": "2026-04-15T11:16:00Z"
  },
  "errors": []
}