Developer Reference
ZeroBot API
Integrate ZeroBot's real-time anti-bot intelligence into your application
Quick Example
Make a single API call to check any visitor:
GET /v3/openapi?license=YOUR_LICENSE&ip=185.220.101.1&domain=https://example.com&vpn=1&datacenter=1
// Response { "username": "aBcDeFgHiJkLmNoPqRsTuVwXyZ=", "license": "YOUR_LICENSE_KEY", "total": 50241, "left": 30, "plan": "Unlimited", "asn": "AS16276", "country_name": "France", "country_code": "fr", "isp": "OVH SAS", "hostname": "vps-d077f993.vps.ovh.net", "is_bot": true, "reason": "VPN", "risk_score": 70, "tor": false, "vpn": true, "datacenter": true }
// Response { "username": "aBcDeFgHiJkLmNoPqRsTuVwXyZ=", "license": "YOUR_LICENSE_KEY", "total": 50241, "left": 30, "plan": "Unlimited", "asn": "AS16276", "country_name": "France", "country_code": "fr", "isp": "OVH SAS", "hostname": "vps-d077f993.vps.ovh.net", "is_bot": true, "reason": "VPN", "risk_score": 70, "tor": false, "vpn": true, "datacenter": true }
The
&domain= parameter checks if the domain is in your Authorized Domains list. Make sure to add your domain in the dashboard before using it in API calls, otherwise the request will be rejected.
Use
&vpn=0 to allow VPN visitors and &datacenter=0 to allow datacenter/hosting IPs. By default both are 1 (blocked). When allowed, the response will still show "vpn": true or "datacenter": true so you know the IP type, but "is_bot" will be false and the reason will be "VPN Allowed" or "Datacenter Allowed".