Référence Développeur

Domain Watchlist

API DomScan : Surveillez les domaines pour les changements d'expiration et de disponibilité. Recevez des alertes lorsque les domaines enregistrés deviennent disponibles.

Domain Watchlist

Surveillez les domaines pour les changements d'expiration et de disponibilité. Recevez des alertes lorsque les domaines enregistrés deviennent disponibles.

Surveiller

Connectez-vous avec Google pour accéder à votre liste de surveillance de domaine personnalisée avec alertes e-mail, webhooks et bien plus.

Recevez des notifications par e-mail, télégramme, Slack, Discord ou Webhook.

Surveiller Paramètres Surveillance de marque

GET /v1/watchlist

Obtenez tous les domaines de votre liste de surveillance.

Exemple de Réponse

{
                "watchlist": [
                {
                "domain": "startup.com",
                "added_at": "2024-01-15T10:30:00Z",
                "status": "registered",
                "expiry_date": "2025-01-15T00:00:00Z",
                "days_until_expiry": 287,
                "last_checked": "2024-03-01T12:00:00Z",
                "notify_email": "alerts@example.com",
                "check_count": 4
                }
                ],
                "total": 1,
                "updated_at": "2024-03-01T12:00:00Z"
                }

Champs de Réponse

Champ	Type
`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

POST /v1/watchlist

Ajoutez un domaine à votre liste de surveillance.

Corps de la requête

{
                "domain": "mydomain.com",
                "notify_email": "alerts@example.com"
                }

Champs de Réponse

Champ	Type
`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

Exemple de Réponse

{
  "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": "alerts@example.com"
    }
  ],
  "total": 1
}

DELETE /v1/watchlist?domain=mydomain.com

Retirer de la liste de surveillance

curl -X DELETE -H "X-API-Key: your-api-key" "https://domscan.net/v1/watchlist?domain=mydomain.com"

Champs de Réponse

Champ	Type
`success`	boolean
`message`	string
`domain`	string

Exemple de Réponse

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

GET /v1/watchlist/expiring?days=30

Expire bientôt

Exemple de Réponse

{
                "expiring_domains": [
                {
                "domain": "renewal-window.com",
                "status": "expiring_soon",
                "expiry_date": "2026-05-12T00:00:00Z",
                "days_until_expiry": 28,
                "check_count": 11
                }
                ],
                "total": 1,
                "threshold_days": 30
                }

Champs de Réponse

Champ	Type
`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

GET /v1/watchlist/available

Disponible

Exemple de Réponse

{
                "available_domains": [
                {
                "domain": "startupdrop.ai",
                "status": "available",
                "last_checked": "2026-04-14T08:30:00Z",
                "check_count": 18
                }
                ],
                "total": 1,
                "message": "Ces domaines de votre liste de surveillance sont maintenant disponibles à l'enregistrement !"
                }

Champs de Réponse

Champ	Type
`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