Who it is for
Use automation when the same decision must run across time, across a list, or across several products.
Monitoring & Automation · DomScan product
Domain Watchlist API
Manage your domain watchlist. Get notified when domains become available or change status.
What you get
Manage your domain watchlist. Get notified when domains become available or change status.
SynchronousRESTMCPSDKInteractive tool
Choose this product when
Choose this product when
Choose this to track up to 100 domains for availability, expiry, and status-oriented changes with configurable alerts.
What you get
Manage your domain watchlist. Get notified when domains become available or change status.
Endpoints
Review the supported operations, inputs, outputs, execution modes, and response limits before integrating.
Credits and authentication
0-1 Authentication required. Check the operation reference for the exact cost and any per-item pricing.
Example operation
Use documented operations to collect, assess, enrich, verify, compare, protect, or monitor public evidence.
GET
/v1/watchlist
Credits: 1
Query parameters
| Parameter | Type | required |
|---|---|---|
| limit | integer | optional |
| cursor | string | optional |
Response fields
| Field | Type |
|---|---|
has_more |
boolean |
next_cursor |
string | null |
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 |
watchlist[].check_count |
integer |
total |
integer |
updated_at |
string |
Example request
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/watchlist"const response = await fetch("https://domscan.net/v1/watchlist", {
headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);import os
import requests
response = requests.get(
"https://domscan.net/v1/watchlist",
headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/watchlist", nil)
if err != nil {
panic(err)
}
req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
data, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
fmt.Println(resp.Status, string(data))
}require "json"
require "net/http"
uri = URI("https://domscan.net/v1/watchlist")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))Example response
{
"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"
}HTTP status codes
200OK400Bad Request401Unauthorized402Payment Required429Too Many Requests
Frequently asked questions
Where can I find the Domain Watchlist request and response reference?
Use the API reference for Domain Watchlist to review parameters, response fields, examples, status codes, and supported operation modes.
How should I interpret unknown or incomplete results from Domain Watchlist?
Unknown or partial results mean that the requested evidence could not be fully determined. Keep the result state, confidence, freshness, and limitations in downstream decisions.
How is Domain Watchlist priced?
Pricing depends on the operation and execution mode. Check the endpoint reference for the current credit cost, authentication requirement, and per-item rules.
