域名监视列表 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