Load Time: Multi-Location Testing

By default, Load Time tests a URL from Geekflare’s US server. Pass targetCountries to also test reachability from up to 3 additional locations via proxy, alongside the default US test — useful for confirming a site loads correctly for visitors in different regions, or diagnosing geo-specific outages. Costs a flat 8 credits per request, regardless of how many locations (1–3) you test.

How It Works

For each request with targetCountries set, Geekflare tests the URL from:

The default US server (no proxy)
Each country listed in targetCountries, routed through a proxy in that location

The response reports whether the site was reachable from every tested location, both as an overall summary and a per-location breakdown.

Testing from Multiple Locations

Pass an array of up to 3 ISO alpha-2 country codes in targetCountries:

const result = await client.loadTime({
  url: 'https://example.com',
  targetCountries: ['gb', 'ca']
});

result = client.load_time(LoadTimeDto(
    url='https://example.com',
    target_countries=['gb', 'ca']
))

curl -X POST https://api.geekflare.com/loadtime \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "targetCountries": ["gb", "ca"]}'

Response

{
  "timestamp": 1785938505112,
  "apiStatus": "success",
  "apiCode": 200,
  "message": "Reachable from all 3 tested locations.",
  "meta": {
    "url": "https://example.com",
    "test": { "id": "cc20cf78-3bfb-4ad4-8e75-4be137f7fb3d" },
    "targetCountries": ["us", "gb", "ca"],
    "followRedirect": true
  },
  "summary": {
    "reachable": ["us", "gb", "ca"]
  },
  "locations": [
    { "location": "us", "countryName": "United States", "status": "reachable", "data": {} },
    { "location": "gb", "countryName": "Great Britain", "status": "reachable", "data": {} },
    { "location": "ca", "countryName": "Canada", "status": "reachable", "data": {} }
  ]
}

meta.targetCountries in the response always includes the default us location plus every country you requested. So a 2-country request returns 3 tested locations total.

Without `targetCountries`

If you omit targetCountries, Load Time behaves as before: a single test from the US server, with the full timing breakdown (DNS, connect, TLS, timings, headers, etc.) returned directly in data.

Getting started

Quickstarts

Guides

MCP Server

Capabilities

Best Practices

Troubleshooting

Changelog

Load Time: Multi-Location Testing

How It Works

Testing from Multiple Locations

Without `targetCountries`

Next Steps

Load Time Reference

Using Proxies

​How It Works

​Testing from Multiple Locations

​Without targetCountries

​Next Steps

Load Time Reference

Using Proxies

How It Works

Testing from Multiple Locations

Without `targetCountries`

Next Steps