Zap Filter API

Base URL https://zap.besmartnow.my · version /v1 · all responses are JSON.

Authentication

Send your key as a Bearer token (recommended), an x-api-key header, or a ?key= query parameter.

curl -H "Authorization: Bearer YOUR_KEY" https://zap.besmartnow.my/api/public/v1/filters

Endpoints

GET/api/public/v1/filters

Lists every supported filter and its id.

curl -H "Authorization: Bearer YOUR_KEY" \
  https://zap.besmartnow.my/api/public/v1/filters

{ "filters": [ { "id": "securly", "name": "Securly" }, ... ] }

GET/api/public/v1/zap?filter=securly&goal=3&concurrency=100

Zap: freshly scrapes the complete FreeDNS shared domain registry (public + private) and checks it against the filter with a worker pool, returning only unblocked domains until the goal is met or the registry runs out. A full run takes a while.

curl -H "Authorization: Bearer YOUR_KEY" \
  "https://zap.besmartnow.my/api/public/v1/zap?filter=securly&goal=3"

{ "filter": "securly", "goal": 3, "checked": 118, "pool": 21496,
  "reachedGoal": true,
  "unblocked": [ { "domain": "epac.to", "category": "Business" } ] }

Public keys

Any of these four keys works.

zap_fd86a84ba9b502621233113264689013
zap_4b8bd9a7e645a5e6838b135ae96741ce
zap_037d97749c934528ad99ec823c65734d
zap_2d4c295c991bfa88a8c16c8abf861ca7

Errors

401 unauthorized for a missing or unknown key, 400 bad_request for missing parameters. Filter lookups that fail upstream return { blocked: true, category: "Error", error: "..." }.