Hyperbrowser supports deploying browser sessions across multiple geographic regions worldwide. This allows you to optimize for latency and improve performance for your users.
Available Regions
Hyperbrowser currently supports the following regions:
| Region Code | Location | Description |
|---|
us-central | United States (Central) | Optimal for North American users |
us-east | United States (East) | East coast US region |
us-west | United States (West) | West coast US region |
europe-west | Europe (West) | Optimal for European users |
asia-south | Asia (South) | Optimal for Asian users |
Why Use Multi-Region Support?
Reduced Latency: Deploy sessions closer to your target websites or end users to minimize network latency and improve response times.
Geographic Testing: Test how websites behave from different geographic locations, useful for geo-restricted content or region-specific features.
Load Distribution: Distribute workloads across multiple regions for better scalability and reliability.
Quick Start
Specify the region when creating a session:
import { Hyperbrowser } from "@hyperbrowser/sdk";
const client = new Hyperbrowser({
apiKey: process.env.HYPERBROWSER_API_KEY,
});
async function main() {
// Create session in Europe
const session = await client.sessions.create({
region: "europe-west",
});
console.log("Session ID:", session.id);
console.log("WebSocket:", session.wsEndpoint);
}
main();
Region Selection Best Practices
Combine with Proxy Settings
You can also combine region selection with proxy settings from the same geographic area:
// European session with European proxy
const session = await client.sessions.create({
region: "europe-west",
useProxy: true,
proxyCountry: "DE", // Germany
useStealth: true,
});
Matching your session region with your proxy country can reduce latency and make your traffic patterns appear more natural.
Troubleshooting
High Latency
If you’re experiencing high latency:
- Check region selection: Ensure you’re using the region closest to your target
- Verify network connectivity: Test your connection to the region
- Consider proxy settings: Proxy routing can add latency
Session Creation Timeout
If session creation times out in a specific region:
- Try a different region: Some regions may be experiencing high load
- Check region status: Contact support for region availability
- Increase timeout: Adjust your client timeout settings
API Reference
For complete API details on the region parameter, see:
Next Steps
