TorWatch Open API Documentation

Usage Policy & Limits

The TorWatch API provides free, open access to our verified Darknet Market and service status data.

❗ Limit: 20 requests per minute per IP address.

Endpoints

GET /api/v1/links

Returns a list of all active (non-archived) services and their primary status.

https://torwatch.org/api/v1/links

GET /api/v1/service/{''}

Returns full detail for a single service by its slug name.

https://torwatch.org/api/v1/service/nexus-market

GET /api/v1/domain/{''}

Returns full detail for a service by the hostname of one of its mirrors.

(Note: Address must be clean hostname, no http:// or trailing slash.)

https://torwatch.org/api/v1/domain/torproject.org

Status Codes

  • 200 OK: Request successful.
  • 404 Not Found: Service or link not found.
  • 429 Too Many Requests: Rate limit exceeded (Slow down!).

Integrate Push Notifications

You may integrate our push notification system into your own PWA/Application. See the dedicated push API endpoints:

  • POST /api/push/subscribe
  • GET /api/push/get_key