Skip to main content
Run browser sessions from specific geographic locations by specifying a country code.

​
Setting Country

Pass a 2-letter ISO country code when creating a session: 
const session = await client.browser.session.create({
  country: "US", // United States
});

​
Supported Countries

Browser Cash supports sessions from multiple countries. Common options include:
CodeCountry
USUnited States
CACanada
Available countries depend on node availability. If no nodes are available in a requested country, the API will return an error.

​
Combining with Node Selection

For maximum control, combine country filtering with specific node selection: 
// First session — let Browser Cash pick a US node
const session1 = await client.browser.session.create({
  country: "US",
});

// Save the node ID for later
const nodeId = session1.servedBy;

// Later — target the exact same node
const session2 = await client.browser.session.create({
  nodeId: nodeId,
});

​
Notes

  • Country filtering is best-effort based on available nodes
  • For consistent location, save and reuse nodeId from previous sessions
  • Some countries may have limited node availability