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