marketplace
GET /v1/domain-alerts
Domain alerts — the saved-search allowance, the plans and every saved search.
Authentication
Send an API key as a bearer token. The endpoint checks sites.view; a key without it is refused with 403, not 404.
This endpoint takes no organisation id. Your key already identifies the organisation it belongs to, and the response is scoped to it.
Try it
Replace anything in angle brackets with your own values, and the key placeholder with a key from your dashboard.
curl -X GET https://api.zinndigital.com/v1/domain-alerts \
-H "Authorization: Bearer zdk_live_…"Signed in? The API console in your dashboard fills in your real organisation id and your own key, and runs the request against the live API so you can see the actual response. Open this endpoint in the API console
Details
Q321 (V1 parity, pbn.ltd/domain-alerts/). A saved search is the aged-domain list's own filters (GET /v1/marketplace/aged-domains), matched once a day; one e-mail per organisation names every domain newly on sale that matches and every one it was told about that is now at least 10% cheaper. Every organisation keeps free (1) active search with no plan; domain_alerts_10 and domain_alerts_50 (on the add-ons catalogue) add 10 and 50, summed. allowed is null and unlimited true for our own organisation. Paused searches are kept and do not count.
Response
| Name | Type | Required | What it is |
|---|---|---|---|
allowed | object | Yes | Active searches allowed; null when unlimited. |
unlimited | boolean | Yes | — |
free | integer | Yes | Active searches every organisation keeps with no plan. |
active | integer | Yes | — |
hard_max | integer | Yes | Saved searches an organisation may keep at all |
plans | object[] | Yes | — |
searches | DomainAlertSearch[] | Yes | — |
Errors this endpoint can return
401 · 403 · 404