Справочник API

API Список наблюдения доменов

Управляйте списком наблюдения ваших доменов. Получайте уведомления, когда домены становятся доступными или меняют статус. Используйте этот справочник, чтобы выбрать операцию и встроить её документированный контракт ответа.

Открыть страницу продукта

Операции

GET /v1/watchlist Открыть справочник API

POST /v1/watchlist Открыть справочник API

DELETE /v1/watchlist Открыть справочник API

GET /v1/watchlist/expiring Открыть справочник API

GET /v1/watchlist/available Открыть справочник API

GET `/v1/watchlist`

Операция: getWatchlist Кредиты и аутентификация: 1 Требуется аутентификация

GET /v1/watchlist

Поля ответа

Поле	Тип
`watchlist[]`	object[]
`watchlist[]`	object
`watchlist[].domain`	string
`watchlist[].added_at`	string
`watchlist[].status`	string
`watchlist[].last_checked`	string
`watchlist[].expiry_date`	string
`watchlist[].days_until_expiry`	integer
`watchlist[].notify_email`	string
`total`	integer
`updated_at`	string

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

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/watchlist"

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

{
  "watchlist": [
    {
      "domain": "example.com",
      "added_at": "2024-01-01T00:00:00Z",
      "status": "registered",
      "last_checked": "2024-01-15T12:00:00Z"
    }
  ],
  "total": 1,
  "updated_at": "2024-01-15T12:00:00Z"
}

POST `/v1/watchlist`

Операция: addToWatchlist Кредиты и аутентификация: 1 Требуется аутентификация

POST /v1/watchlist

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

Параметр	Тип	обязателен
domain	string	обязателен
notify_email	string	опционально

Поля ответа

Поле	Тип
`success`	boolean
`message`	string
`watchlist[]`	object[]
`watchlist[]`	object
`watchlist[].domain`	string
`watchlist[].added_at`	string
`watchlist[].status`	string
`watchlist[].last_checked`	string
`watchlist[].expiry_date`	string
`watchlist[].days_until_expiry`	integer
`watchlist[].notify_email`	string
`total`	integer

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

curl -X POST "https://domscan.net/v1/watchlist" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{
  "domain": "example.com",
  "notify_email": "[email protected]"
}'

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

{
  "success": true,
  "message": "string",
  "watchlist": [
    {
      "domain": "example.com",
      "added_at": "2026-04-15T12:00:00Z",
      "status": "registered",
      "last_checked": "2026-04-15T12:00:00Z",
      "expiry_date": "2026-04-15T12:00:00Z",
      "days_until_expiry": 1,
      "notify_email": "[email protected]"
    }
  ],
  "total": 1
}

DELETE `/v1/watchlist`

Операция: removeFromWatchlist Кредиты и аутентификация: Бесплатно Требуется аутентификация

DELETE /v1/watchlist

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

Параметр	Тип	обязателен
domain	string	обязателен

Поля ответа

Поле	Тип
`success`	boolean
`message`	string
`domain`	string

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

curl -X DELETE "https://domscan.net/v1/watchlist?domain=example.com" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{}'

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

{
  "success": true,
  "message": "string",
  "domain": "example.com"
}

GET `/v1/watchlist/expiring`

Операция: getExpiringWatchlist Кредиты и аутентификация: 1 Требуется аутентификация

GET /v1/watchlist/expiring

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

Параметр	Тип	обязателен
days	integer По умолчанию `90`	опционально

Поля ответа

Поле	Тип
`expiring_domains[]`	object[]
`expiring_domains[]`	object
`expiring_domains[].domain`	string
`expiring_domains[].added_at`	string
`expiring_domains[].status`	string
`expiring_domains[].last_checked`	string
`expiring_domains[].expiry_date`	string
`expiring_domains[].days_until_expiry`	integer
`expiring_domains[].notify_email`	string
`total`	integer
`threshold_days`	integer

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

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/watchlist/expiring?days=example.com"

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

{
  "expiring_domains": [
    {
      "domain": "example.com",
      "added_at": "2026-04-15T12:00:00Z",
      "status": "registered",
      "last_checked": "2026-04-15T12:00:00Z",
      "expiry_date": "2026-04-15T12:00:00Z",
      "days_until_expiry": 1,
      "notify_email": "[email protected]"
    }
  ],
  "total": 1,
  "threshold_days": 1
}

GET `/v1/watchlist/available`

Операция: getAvailableWatchlist Кредиты и аутентификация: 1 Требуется аутентификация

GET /v1/watchlist/available

Поля ответа

Поле	Тип
`available_domains[]`	object[]
`available_domains[]`	object
`available_domains[].domain`	string
`available_domains[].added_at`	string
`available_domains[].status`	string
`available_domains[].last_checked`	string
`available_domains[].expiry_date`	string
`available_domains[].days_until_expiry`	integer
`available_domains[].notify_email`	string
`total`	integer
`message`	string

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

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/watchlist/available"

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

{
  "available_domains": [
    {
      "domain": "example.com",
      "added_at": "2026-04-15T12:00:00Z",
      "status": "registered",
      "last_checked": "2026-04-15T12:00:00Z",
      "expiry_date": "2026-04-15T12:00:00Z",
      "days_until_expiry": 1,
      "notify_email": "[email protected]"
    }
  ],
  "total": 1,
  "message": "string"
}

Справочные материалы

OpenAPI 3.0 Postman MCP