🚀 Experience the new and improved APIVoid! Check out what's new

Geo Request API: Test URL Availability Across Global Locations

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.

Get started now
Live demo

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
}
Code analysis

Key Features

Check URL availability worldwide and detect connectivity issues

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.

Multiple Global Locations

Send requests from several locations such as the US, Europe, and Asia to verify global URL accessibility.

Status Code & Headers

Retrieve HTTP status code and response headers for each location to identify blocking or misconfigurations.

Latency Measurement

Measure response latency from each region to detect slowdowns or regional connectivity problems.

IPv4 & IPv6 Support

Choose between IPv4 (default) or IPv6 to test connectivity across different network configurations.

Common Use Cases

Take a look at some real-world use cases of this API service

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:

Check Global Availability

Verify whether a URL is accessible from multiple global locations and detect reachability issues.

Detect Connectivity Issues

Identify connection failures, timeouts, or unexpected status codes when accessing a URL worldwide.

Monitor Performance

Response latency from multiple locations can uncover slowdowns or regional routing problems.

Enrich Monitoring Data

Integrate our results into monitoring or analytics platforms to gain better visibility into global access.

Use cases

EVERYTHING YOU GET

Do it all with one geo request

One request loads the same URL from several countries at once and returns what each location got back: status, headers, redirects, connection timings and the TLS details of each handshake.

Requests from many countries

  • Several continents in one call
  • Continent code and name per location
  • Country code and name per location
  • City of the requesting node
  • Spot geo-blocking and geo-redirects
  • Per-location error message when it fails

Full response per location

  • HTTP status code and message
  • All response headers returned
  • Redirect target per location
  • Remote address that served the request
  • Compare responses side by side
  • Catch country-specific content swaps

Timings and TLS

  • DNS resolution time
  • Connect time
  • TLS handshake time
  • Time to first byte
  • Total request time
  • Optional IPv6 requests

USAGE EXAMPLE

Learn how seamless it is to add and use Geo Request API anywhere you want

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);
}

Start using our API services in just a few minutes

Create your account, activate your free trial and make your first API call. No credit card and no commitment required.

Get started now