Skip to main content

Supported Countries and Cities

Browser7 supports geo-targeted web scraping across 15 countries and 36 cities worldwide, with city-level proxy targeting for precise location control.

Overview​

Our infrastructure spans two production datacenters:

  • European datacenter - Optimized for European traffic with ≤20ms latency
  • North American datacenter - Optimized for North American traffic with ≤20ms latency

All cities have been selected based on proxy availability, network latency, and geographic coverage to ensure fast, reliable rendering.

Europe (13 Countries, 22 Cities)​

Austria (AT)​

  • Vienna (vienna)

Belgium (BE)​

  • Brussels (brussels)

Croatia (HR)​

  • Zagreb (zagreb)

Czech Republic (CZ)​

  • Prague (prague)

France (FR)​

  • Paris (paris)
  • Lyon (lyon)

Germany (DE)​

  • Berlin (berlin)
  • Hamburg (hamburg)
  • Munich (munich)
  • Frankfurt am Main (frankfurt.am.main)

Hungary (HU)​

  • Budapest (budapest)

Italy (IT)​

  • Milan (milan)
  • Turin (turin)

Netherlands (NL)​

  • Amsterdam (amsterdam)
  • Rotterdam (rotterdam)
  • The Hague (the.hague)
  • Utrecht (utrecht)

Poland (PL)​

  • Warsaw (warsaw)

Slovakia (SK)​

  • Bratislava (bratislava)

Switzerland (CH)​

  • Zurich (zurich)
  • Geneva (geneva)

United Kingdom (GB)​

  • London (london)

North America (2 Countries, 14 Cities)​

Canada (CA)​

  • Montreal (montreal)
  • Ottawa (ottawa)
  • Toronto (toronto)

United States (US)​

  • Boston (boston)
  • Buffalo (buffalo)
  • New York (new.york)
  • Philadelphia (philadelphia)
  • Washington DC (washington.dc)
  • Baltimore (baltimore)
  • Pittsburgh (pittsburgh)
  • Detroit (detroit)
  • Cleveland (cleveland)
  • Columbus (columbus)

Usage​

Specifying Country and City​

Use the countryCode and city parameters when creating a render:

Node.js:

const result = await client.render('https://example.com', {
  countryCode: 'US',
  city: 'new.york'
});

Python:

result = client.render('https://example.com',
    country_code='US',
    city='new.york'
)

PHP:

$result = $client->render('https://example.com', [
    'countryCode' => 'US',
    'city' => 'new.york'
]);

cURL:

curl -X POST https://api.browser7.com/v1/renders \
  -H "Authorization: Bearer b7_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "countryCode": "US",
    "city": "new.york"
  }'

Selection Logic​

Browser7 uses the following logic to select a proxy location:

  1. Both specified (countryCode + city): Uses your exact preferences
  2. Country only (countryCode): Randomly selects a city within that country
  3. Neither specified: AUTO MODE - Uses datacenter proximity-based selection (cities with ≤20ms latency)
  4. City only: Returns error (must specify countryCode with city)

When neither countryCode nor city is specified, Browser7 automatically selects the optimal city based on datacenter proximity:

Node.js:

// Auto-selects nearest city with ≤20ms latency
const result = await client.render('https://example.com');

Auto mode provides:

  • Fastest rendering: Cities selected for optimal latency
  • Smart routing: Automatic datacenter-based selection
  • Maximum availability: Largest pool of available proxies

City Name Format​

City names in the API use a URL-safe format with dots instead of spaces:

Display NameAPI Parameter
New Yorknew.york
Washington DCwashington.dc
The Haguethe.hague
Frankfurt am Mainfrankfurt.am.main

All other cities use lowercase, URL-safe names (e.g., london, paris, toronto).

Country Codes​

All country codes follow the ISO 3166-1 alpha-2 standard:

CountryCode
AustriaAT
BelgiumBE
CanadaCA
CroatiaHR
Czech RepublicCZ
FranceFR
GermanyDE
HungaryHU
ItalyIT
NetherlandsNL
PolandPL
SlovakiaSK
SwitzerlandCH
United KingdomGB
United StatesUS

Datacenter Mapping​

European Datacenter​

Serves: European countries

Countries:

  • Austria (AT)
  • Belgium (BE)
  • Croatia (HR)
  • Czech Republic (CZ)
  • France (FR)
  • Germany (DE)
  • Hungary (HU)
  • Italy (IT)
  • Netherlands (NL)
  • Poland (PL)
  • Slovakia (SK)
  • Switzerland (CH)
  • United Kingdom (GB)

Total: 13 countries, 22 cities

North American Datacenter​

Serves: North American countries

Countries:

  • Canada (CA)
  • United States (US)

Total: 2 countries, 13 cities

Best Practices​

For Maximum Speed​

Use auto mode (omit countryCode and city) to let Browser7 select the nearest city with optimal latency.

For Geo-Specific Content​

Specify countryCode when you need region-specific results but don't care about the exact city:

// Any US city
const result = await client.render('https://example.com', {
  countryCode: 'US'
});

For Precise Targeting​

Specify both countryCode and city when you need content from a specific location:

// Specifically from London
const result = await client.render('https://example.com', {
  countryCode: 'GB',
  city: 'london'
});

For Testing Multiple Locations​

Loop through different cities to test how content varies by location:

const cities = [
  { countryCode: 'US', city: 'new.york' },
  { countryCode: 'GB', city: 'london' },
  { countryCode: 'DE', city: 'frankfurt.am.main' }
];

for (const location of cities) {
  const result = await client.render('https://example.com', location);
  console.log(`From ${location.city}:`, result.html.length);
}

Performance Characteristics​

Latency Ranges​

European Datacenter:

  • Germany: 4-10ms
  • Netherlands: 10-17ms
  • France: 14-18ms
  • Switzerland: 10-13ms
  • Czech Republic, Slovakia: ~10ms
  • Austria, Hungary: 14-16ms
  • Belgium: ~28ms (slightly higher but approved)
  • Other European countries: 15-20ms

North American Datacenter:

  • Canada: 5-9ms
  • US East Coast: 10-20ms

Rendering Speed Impact​

Proxy latency multiplies across 100-200 requests per page:

  • 10ms latency = ~2-4 seconds added to render time
  • 20ms latency = ~4-5 seconds added to render time

All cities have been selected to maintain fast rendering speeds while maximizing geographic coverage.

Timezone Information​

Each city automatically applies the correct timezone for browser geolocation. The browser's navigator.timezone and geolocation coordinates are automatically configured to match the selected city.

Examples:

  • New York: America/New_York
  • London: Europe/London
  • Paris: Europe/Paris
  • Berlin: Europe/Berlin
  • Toronto: America/Toronto

Need More Locations?​

We're continuously expanding our coverage. If you need a specific country or city that's not currently supported, email support@browser7.com.