Tor Test API Reference
Check if a website is accessible from the Tor network: the URL is requested through a Tor exit node and the API returns the HTTP status code, response headers and page details as seen from Tor. Useful to verify whether a site blocks or challenges Tor visitors.
Service details and pricing: Tor Test API
Request example
Query the endpoint via an HTTPS POST request (replace YOUR_API_KEY_HERE with your API key):
curl -X POST "https://api.apivoid.com/v2/tor-test" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY_HERE" \
-d '{"url": "https://www.nvidia.com/"}'The same request in PHP:
$url = 'https://www.nvidia.com/';
$apiKey = 'YOUR_API_KEY_HERE';
$curl = curl_init('https://api.apivoid.com/v2/tor-test');
curl_setopt($curl, CURLOPT_HTTPHEADER, ['Content-Type: application/json', 'X-API-Key: ' . $apiKey]);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode(['url' => $url]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($curl);
$httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($httpCode === 200) {
$responseData = json_decode($response, true);
print_r($responseData);
} else {
print_r('An error occurred: '.$response);
}Request parameters
Required
URL to submit, e.g. https://www.nvidia.com/.
⚠ Government and educational domains are blocked.
Response example
A successful request returns HTTP 200 with a JSON body:
{
"url": "https://www.nvidia.com/",
"accessible": false,
"status_code": 403,
"debug_message": "",
"response_headers": {
"content-length": "366",
"content-type": "text/html",
"date": "Fri, 28 Mar 2025 15:20:54 GMT",
"expires": "Fri, 28 Mar 2025 15:20:54 GMT",
"last-modified": "Fri, 28 Mar 2025 15:20:54 GMT",
"mime-version": "1.0",
"server": "AkamaiGHost",
"set-cookie": "c_code=DE; Path=/; Secure",
"x-cache-status": "Error from child",
"x-cdn": "akam",
"x-cdn-version": "v373"
},
"html_info": {
"title": "Access Denied",
"description": ""
},
"elapsed_ms": 678
}Response fields
The fields returned in the JSON response:
urlstring
URL submitted for the Tor accessibility test.
accessibleboolean
Returns true if the URL is accessible from the Tor network.
status_codeinteger
HTTP status code returned by the server.
debug_messagestring
Debug or error details about the request, if any. Empty string if none.
response_headersobject
HTTP response headers returned by the server to the Tor exit node, keyed by lowercase header name.
html_info → titlestring
Title of the page returned to the Tor exit node.
html_info → descriptionstring
Meta description of the page returned to the Tor exit node.
elapsed_msinteger
Time taken to process the request, in milliseconds.