Référence Développeur

Liste de surveillance des domaines

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

Liste de surveillance des domaines

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": "[email protected]",
                "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": "[email protected]"
                }

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": "Request completed",
  "watchlist": [
    {
      "domain": "example.com",
      "added_at": "2026-08-27T12:00:00Z",
      "status": "registered",
      "last_checked": "2026-08-27T12:00:00Z",
      "expiry_date": "2026-08-27T12:00:00Z",
      "days_until_expiry": 1,
      "notify_email": "[email protected]"
    }
  ],
  "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": "Request completed",
  "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