API Docs

dropseer exposes a small JSON API. No authentication required for MVP. Rate limit: 60 req/min per IP (bring your own key later for higher tiers).

Base URL

https://dropseer.com

POST /v1/check — instant availability

POST/v1/check

Check up to 200 domains. Rotates through registrars (Dynadot, NameSilo, Namecheap, Name.com, OpenProvider) and always cross-checks with RDAP. Returns an OR-gate verdict: if any source says "available", verdict = available.

Request

curl -X POST https://dropseer.com/v1/check \
  -H "Content-Type: application/json" \
  -d '{"domains":["aora.in","example.com"]}'

Options

Response

{
  "results": [
    {
      "domain": "aora.in",
      "verdict": "available",
      "available": true,
      "sources": [
        {"source": "dynadot", "available": false},
        {"source": "rdap", "available": true}
      ]
    }
  ],
  "sources_used": ["dynadot", "rdap"],
  "took_ms": 1280
}

POST /v1/predict — drop date prediction

POST/v1/predict

Given up to 100 domains, run WHOIS, apply per-TLD lifecycle rules (auto-renew grace + RGP + pendingDelete), and return predicted drop date with confidence.

Takes ~3-8s per domain on first call; results cached 24h.

Request

curl -X POST https://dropseer.com/v1/predict \
  -H "Content-Type: application/json" \
  -d '{"domains":["example.com","yourbrand.in"]}'

Response

{
  "results": [
    {
      "domain": "example.com",
      "expiry_date": 1735689600,
      "predicted_drop_at": 1741299600,
      "confidence": "high",
      "method": "whois_lifecycle(com+65d)",
      "status": ["clientTransferProhibited"],
      "registrar": "IANA"
    }
  ],
  "took_ms": 4230
}

Confidence levels

POST /v1/watch — add to watchlist

POST/v1/watch

Start monitoring a domain. We poll on the schedule matching the priority you set, and fire a Telegram/webhook alert on state flip.

Request

curl -X POST https://dropseer.com/v1/watch \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "aora.in",
    "priority": 7,
    "telegram_chat_id": "436019661",
    "min_confirmations": 2
  }'

Fields

Priority → poll interval

GET /v1/watch — list watches

GET/v1/watch
curl https://dropseer.com/v1/watch

DELETE /v1/watch/:domain — stop watching

DELETE/v1/watch/:domain
curl -X DELETE https://dropseer.com/v1/watch/aora.in

GET /v1/watch/:domain — watch details + history

GET/v1/watch/:domain

Returns watch config plus last 100 check events.

Ops endpoints

GET/health — service liveness
GET/v1/sources — registrar health + rotation
GET/v1/stats — watches count, checks 24h, alerts 24h