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