🚀 Experience the new and improved APIVoid! Check out what's new
A JSON API to check whether a URL is accessible from multiple global locations (USA, Europe, Asia). Make HTTP GET requests and retrieve status codes, response headers, and latency metrics from each location. Requests can be performed over IPv4 or IPv6.
Consumes 5 credits per API call
# Example Curl request from the command line:
curl -X POST "https://api.apivoid.com/v2/geo-request" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY_HERE" \
-d '{"url": "https://www.yahoo.com/"}'
# Example JSON output for a 200 HTTP status code:
{
"url": "https://www.yahoo.com/",
"locations": [
{
"continent_code": "NA",
"continent_name": "North America",
"country_code": "CA",
"country_name": "Canada",
"city_name": "Toronto",
"request_output": {
"status_code": 302,
"status_message": "302 Found",
"response_headers": {
"age": [
"0"
],
"cache-control": [
"no-store"
],
"connection": [
"keep-alive"
],
"content-language": [
"en"
],
"content-length": [
"17"
],
"content-security-policy": [
"frame-ancestors 'self' https://*.builtbygirls.com https://*.rivals.com https://*.engadget.com https://*.intheknow.com https://*.autoblog.com https://*.techcrunch.com https://*.yahoo.com https://*.aol.com https://*.huffingtonpost.com https://*.oath.com https://*.search.yahoo.com https://*.pnr.ouryahoo.com https://pnr.ouryahoo.com https://*.search.aol.com https://*.search.huffpost.com https://*.onesearch.com https://*.verizonmedia.com https://*.publishing.oath.com https://*.autoblog.com; sandbox allow-forms allow-same-origin allow-scripts allow-popups allow-popups-to-escape-sandbox allow-presentation; report-uri https://csp.yahoo.com/beacon/csp?src=ats&site=frontpage®ion=US&lang=en-US&device=desktop&yrid=2a1aachkl2j7m&partner=;"
],
"content-type": [
"text/html"
],
"date": [
"Sun, 28 Dec 2025 15:29:58 GMT"
],
"location": [
"https://ca.yahoo.com/?p=us"
],
"referrer-policy": [
"no-referrer-when-downgrade"
],
"server": [
"ATS"
],
"set-cookie": [
"RRC=st=1766935798.3485&cnt=1; expires=Sun, 28-Dec-2025 15:30:28 GMT; path=/; domain=.www.yahoo.com; HttpOnly"
],
"strict-transport-security": [
"max-age=31536000"
],
"x-content-type-options": [
"nosniff"
],
"x-frame-options": [
"SAMEORIGIN"
],
"x-xss-protection": [
"1; mode=block"
]
},
"redirects_to": "https://ca.yahoo.com/?p=us",
"timings": {
"dns_ms": 2,
"connect_ms": 6,
"tls_ms": 6,
"ttfb_ms": 37,
"total_ms": 52
},
"remote_addr": "66.218.84.42",
"network": "tcp4",
"http_version": "HTTP/1.1",
"tls_version": "TLS1.3",
"cipher_suite": "TLS_AES_128_GCM_SHA256",
"error_message": "",
"elapsed_ms": 91
},
"error": ""
},
{
"continent_code": "EU",
"continent_name": "Europe",
"country_code": "DE",
"country_name": "Germany",
"city_name": "Frankfurt",
"request_output": {
"status_code": 302,
"status_message": "302 Found",
"response_headers": {
"age": [
"0"
],
"cache-control": [
"no-store"
],
"connection": [
"keep-alive"
],
"content-language": [
"en"
],
"content-length": [
"17"
],
"content-security-policy": [
"frame-ancestors 'self' https://*.builtbygirls.com https://*.rivals.com https://*.engadget.com https://*.intheknow.com https://*.autoblog.com https://*.techcrunch.com https://*.yahoo.com https://*.aol.com https://*.huffingtonpost.com https://*.oath.com https://*.search.yahoo.com https://*.pnr.ouryahoo.com https://pnr.ouryahoo.com https://*.search.aol.com https://*.search.huffpost.com https://*.onesearch.com https://*.verizonmedia.com https://*.publishing.oath.com https://*.autoblog.com; sandbox allow-forms allow-same-origin allow-scripts allow-popups allow-popups-to-escape-sandbox allow-presentation; report-uri https://csp.yahoo.com/beacon/csp?src=ats&site=frontpage®ion=US&lang=en-US&device=desktop&yrid=39iu909kl2j7m&partner=;"
],
"content-type": [
"text/html"
],
"date": [
"Sun, 28 Dec 2025 15:29:58 GMT"
],
"location": [
"https://de.yahoo.com/?p=us"
],
"referrer-policy": [
"no-referrer-when-downgrade"
],
"server": [
"ATS"
],
"set-cookie": [
"RRC=st=1766935798.5121&cnt=1; expires=Sun, 28-Dec-2025 15:30:28 GMT; path=/; domain=.www.yahoo.com; HttpOnly"
],
"strict-transport-security": [
"max-age=31536000"
],
"x-content-type-options": [
"nosniff"
],
"x-frame-options": [
"SAMEORIGIN"
],
"x-xss-protection": [
"1; mode=block"
]
},
"redirects_to": "https://de.yahoo.com/?p=us",
"timings": {
"dns_ms": 6,
"connect_ms": 1,
"tls_ms": 8,
"ttfb_ms": 89,
"total_ms": 100
},
"remote_addr": "87.248.119.252",
"network": "tcp4",
"http_version": "HTTP/1.1",
"tls_version": "TLS1.3",
"cipher_suite": "TLS_AES_128_GCM_SHA256",
"error_message": "",
"elapsed_ms": 100
},
"error": ""
},
...
],
"elapsed_ms": 1223
}
Key Features
Businesses and developers use this Geo Request API to perform HTTP GET requests to a URL from multiple global locations and verify availability, latency, and response details.
Send requests from several locations such as the US, Europe, and Asia to verify global URL accessibility.
Retrieve HTTP status code and response headers for each location to identify blocking or misconfigurations.
Measure response latency from each region to detect slowdowns or regional connectivity problems.
Choose between IPv4 (default) or IPv6 to test connectivity across different network configurations.
Common Use Cases
Our API can be used in many ways, from monitoring and troubleshooting to research and testing tasks. Below are the most common use cases based on customer usage:
Verify whether a URL is accessible from multiple global locations and detect reachability issues.
Identify connection failures, timeouts, or unexpected status codes when accessing a URL worldwide.
Response latency from multiple locations can uncover slowdowns or regional routing problems.
Integrate our results into monitoring or analytics platforms to gain better visibility into global access.
USAGE EXAMPLE
All it takes is a HTTPS POST request with JSON payload to our endpoint, and you’ll receive the response within seconds, usually within 1-2 seconds. Here are a few code examples to use the API:
$url = 'https://www.yahoo.com/';
$apiUrl = 'https://api.apivoid.com/v2/geo-request';
$apiKey = 'your_api_key_here';
$ch = curl_init($apiUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json', 'X-API-Key: ' . $apiKey]);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(['url' => $url]));
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($httpCode === 200) {
$responseData = json_decode($response, true);
print_r($responseData);
} else {
print_r('An error occurred: '.$response);
}Create your account, pick a subscription plan, and make your first API call instantly with your API key—simple as that!
Get started now