API-Referenz

API für Domain-Überwachungsliste

Verwalten Sie Ihre Domain-Überwachungsliste. Erhalten Sie Benachrichtigungen, wenn Domains verfügbar werden oder ihren Status ändern. Nutzen Sie diese Referenz, um eine Operation auszuwählen und den dokumentierten Response-Vertrag zu integrieren.

Produktseite ansehen

Operationen

GET /v1/watchlist API-Referenz ansehen

POST /v1/watchlist API-Referenz ansehen

DELETE /v1/watchlist API-Referenz ansehen

GET /v1/watchlist/expiring API-Referenz ansehen

GET /v1/watchlist/available API-Referenz ansehen

GET `/v1/watchlist`

Operation: getWatchlist Credits und Authentifizierung: 1 Authentifizierung erforderlich

GET /v1/watchlist

Antwort-Felder

Feld	Typ
`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

Beispielanfrage

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

Beispielantwort

{
  "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`

Operation: addToWatchlist Credits und Authentifizierung: 1 Authentifizierung erforderlich

POST /v1/watchlist

Body-Parameter

Parameter	Typ	erforderlich
domain	string	erforderlich
notify_email	string	optional

Antwort-Felder

Feld	Typ
`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

Beispielanfrage

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]"
}'

Beispielantwort

{
  "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`

Operation: removeFromWatchlist Credits und Authentifizierung: Kostenlos Authentifizierung erforderlich

DELETE /v1/watchlist

Abfrageparameter

Parameter	Typ	erforderlich
domain	string	erforderlich

Antwort-Felder

Feld	Typ
`success`	boolean
`message`	string
`domain`	string

Beispielanfrage

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

Beispielantwort

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

GET `/v1/watchlist/expiring`

Operation: getExpiringWatchlist Credits und Authentifizierung: 1 Authentifizierung erforderlich

GET /v1/watchlist/expiring

Abfrageparameter

Parameter	Typ	erforderlich
days	integer Standard `90`	optional

Antwort-Felder

Feld	Typ
`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

Beispielanfrage

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

Beispielantwort

{
  "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`

Operation: getAvailableWatchlist Credits und Authentifizierung: 1 Authentifizierung erforderlich

GET /v1/watchlist/available

Antwort-Felder

Feld	Typ
`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

Beispielanfrage

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

Beispielantwort

{
  "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"
}

Referenzressourcen

OpenAPI 3.0 Postman MCP