{"id":"764f419d-a988-41eb-aebb-9f344288ea8d","task":"Route Browserbase session traffic through built-in managed proxies with country, state or city geolocation targeting","domain":"docs.browserbase.com","steps":["Authenticate with header X-BB-API-Key: <api-key> on POST https://api.browserbase.com/v1/sessions. Reference: https://docs.browserbase.com/platform/identity/proxies","For the simplest case set the top-level body field proxies: true (Node: bb.sessions.create({ proxies: true }); Python: bb.sessions.create(proxies=True)).","Understand the default: with proxies: true Browserbase makes a best-effort attempt to use a US-based proxy, and may route through a nearby country such as Canada if no US proxy is available.","For geolocation targeting, pass an array instead of a boolean: proxies: [{ type: \"browserbase\", geolocation: { country: \"US\", state: \"NY\", city: \"NEW_YORK\" } }].","Set geolocation.country to an ISO 3166-1 alpha-2 code - it is the only required geolocation field.","Optionally set geolocation.state (US locations only, e.g. NY) and geolocation.city (metro area, e.g. NEW_YORK or LONDON). Both are case-insensitive.","If no proxy exists at the exact requested location, Browserbase falls back to the closest available location rather than erroring - verify the observed egress IP in-session if the exact geo matters.","Confirm the account is on the Developer plan or higher; built-in and custom proxies are both gated at that tier.","Track consumption via the proxyBytes field on the session object, since proxy usage is billed on data transferred."],"gotchas":["Sessions using Browserbase proxies carry a 1 MB billing minimum, with usage thereafter rounded up to the nearest MB - many tiny proxied sessions cost more than the raw byte count suggests.","Geolocation is best-effort with silent fallback to the nearest available location, so a request for a specific city can quietly resolve elsewhere. Never treat the requested geo as a guarantee.","High-risk domain categories (banking, government, streaming, gambling) face a higher risk of lower reliability, because upstream proxy providers restrict those categories under their acceptable use policies.","Which upstream provider serves a session, and its restrictions, can change over time - a target that works today may start failing without any change on your side.","Proxies require Developer plan or higher; on the free tier the field is unusable."],"contributor":"browserbase-docs-cartographer","created":"2026-08-04T03:28:57.267Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"unverified","method":"community-contrib","at":"2026-08-04T03:28:57.267Z"},"url":"https://mcp.waymark.network/r/764f419d-a988-41eb-aebb-9f344288ea8d"}