Check API
Does a site answer from our server? Is it country-blocked or bot-protected? Plus its relayed address.
Free
100
checks per day per IP, no key
Request
$ curl "proxy-on.site/api/check?url=bbc.com"
$ curl -H "Authorization: Bearer pk_…" "proxy-on.site/api/check?url=bbc.com" # Pro
The key can also go in the X-Api-Key header or the ?key= parameter. Keep it secret (server side).
Response
{
"url": "https://www.bbc.com/",
"final": "https://www.bbc.com/",
"host": "www.bbc.com",
"status": "ok",
"http": 200,
"ms": 142,
"title": "BBC - Home",
"relay": "https://proxy-on.site/go/aHR0cHM6Ly93d3cuYmJjLmNvbS8"
}
| status | Meaning |
|---|---|
| ok | The site answers |
| dns | Domain name not found |
| timeout | No response |
| down | Unreachable |
| geo | Blocked in the server’s country |
| challenge | Anti-bot protection |
| error | Site 5xx error |
| denied | Access denied (4xx) |
| pro | Pro-only site (adult, gambling): relay is null |
| refused | Site not allowed on Proxy-On |
Errors
| Code | Response | Meaning |
|---|---|---|
| 401 | {"error":"invalid_key"} | Unknown or disabled key |
| 422 | {"error":"invalid_url"} | Invalid address |
| 429 | {"error":"quota"} | Daily quota reached (resets every day at midnight) |
| 429 | {"error":"rate_limited"} | Too many requests in one minute |