Skip to main content
public preview

This is a proposed contract. No concrete public host or key-issuer URL is published. Every command and response is illustrative.

Residential routing contract

How to evaluate a residential browser API.

A residential browser API joins two services. One runs the browser remotely. Another routes its outbound traffic.

Browser control never proves network behavior. Require each contract separately.

Legba publishes a proposed lifecycle contract, not a callable API. Its public routing contract remains undefined.

Written byLegbaReviewed byAakash HarishSecurity Research Contributor, LegbaReviewed 2026-09-01 · Updated 2026-09-01

The short version

Residential is not a connection contract.

A residential browser API combines two services.

A residential browser API joins remote browser execution. It also adds managed network routing. Both services may share one vendor.

That category differs from a proxy API. A proxy API supplies network access. Your team still owns browser execution.

Managed browsers change process ownership and cleanup. Residential routing changes location and network identity. Neither contract proves the other.

Start with the job being purchased. Then require every supporting contract. Record missing behavior as unknown.

SourcesBrowserbase proxiesBrowser Use proxiesBrowserless proxiesBright Data Browser API FAQsPlaywright BrowserType

Residential and datacenter describe the exit network.

Datacenter addresses come from server infrastructure. Residential routes use participating devices in a provider's documented network. These labels describe egress, not browser execution.

Datacenter networks often prioritize speed and cost. Residential networks add peer availability questions. Sourcing and access policy also matter. So do rotation and location precision.

Neither network class guarantees task success. Require a documented selection field. Verify fallback and session continuity. Review the acceptable-use model.

Measure both classes with one authorized workload. Keep browser version, actions, geography, and timing constant. Record failures instead of hiding them in an average.

The network class changes the evaluation, not the browser contract.
FactorDatacenter routeResidential routeBuyer check
Address originAssigned from datacenter server infrastructure.Routed through participating devices in the provider network.Require a current network description and sourcing policy.
Operating tradeoffThe cited provider positions this class for speed and lower cost.Capacity, rotation, and location depend on available peers.Measure latency, availability, and cost on the same task.
Session behaviorShared or dedicated allocation still needs definition.Rotating, sticky, shared, or dedicated behavior still needs definition.Document duration, rotation triggers, fallback, and failure semantics.
Browser compatibilityNot established by the network label.Not established by the network label.Verify the browser protocol and version separately.

The network class changes the evaluation, not the browser contract.

SourcesBright Data datacenter proxy introductionBright Data residential proxy introductionPlaywright BrowserType

Separate the three control planes.

A complete service exposes three control planes. Each plane answers different engineering questions. One endpoint may cover several planes.

Lifecycle controls provision and terminate browser resources. Browser protocols carry automation commands. Network controls choose outbound routing behavior.

Teams often collapse these layers mentally. That shortcut hides ownership and failure boundaries. Separate them before evaluating any provider.

Three contracts govern one managed browser workflow.
FactorResponsibilityRequired proofFailure question
Lifecycle planeProvision, inspect, and terminate browser resources.Published create, status, and termination operations.Can failed clients leave billable resources running?
Browser planeCarry automation commands to the browser.Named protocol, endpoint, authentication, and versions.Does connection loss terminate anything remotely?
Network planeChoose outbound network and location behavior.Fields, defaults, availability, fallback, and stickiness.What happens when requested routing is unavailable?

SourcesLegba browser API contract guide

Normalize the published provider contracts.

Official providers expose routing through different surfaces. Similar labels hide different operational contracts. Normalize the fields before comparing products.

The matrix records published behavior only. It awards no reliability or performance credit. Private contract terms remain outside this review.

No row proves universal task success. Test the chosen contract against real workloads. Recheck every source before procurement.

Official documentation shows materially different routing contracts.
FactorSelection surfaceLocation behaviorSession behaviorImportant limit
BrowserbaseSet proxies during session creation.Country, U.S. state, and city targeting is best effort.Managed, custom, and domain-routed proxies are documented.Proxy access and transferred data depend on plan terms.
Browser UseSet proxyCountryCode inside browser settings.A United States residential route is default.Managed routing can be disabled or replaced.Pass custom proxy settings again for newly provisioned browsers.
BrowserlessPass proxy fields through request parameters.Country and plan-gated city targeting are documented.Sticky defaults vary across endpoint families.Network choice changes usage units and errors.
Bright DataConnect through documented browser endpoints and credentials.Residential routing is default with documented exceptions.A separate mechanism can preserve one proxy peer.Browser connection is not exposed through REST.
ArchonumRequest a browser endpoint through REST.Country selection follows current device capacity.Session and TTL fields request continuity.Unavailable country capacity returns an error.

Official documentation shows materially different routing contracts.

SourcesBrowserbase proxiesBrowser Use proxiesBrowserless proxiesBright Data Browser API FAQsArchonum API documentation

Define routing semantics before choosing fields.

Residential routing still leaves important choices unresolved. Geography can be exact or approximate. Session labels may preserve different things.

Fallback behavior changes the user-visible result. Silent fallback favors completion over exact location. Failure preserves location requirements but stops work.

Write required behavior before selecting fields. Then test every disputed assumption. Sales language cannot replace interface documentation.

Each routing label needs an operational definition.
FactorBuyer questionWhy it mattersRequired evidence
Default networkIs managed routing enabled automatically?Defaults change cost and observed location.Documented default and explicit disabling behavior.
Geography precisionWhich country, region, or city fields exist?Narrower targeting can reduce available capacity.Supported values and availability semantics.
Unavailable geographyDoes the provider fail or fall back?Silent changes can invalidate localized results.Published fallback and error behavior.
Session continuityWhat remains stable during one session?Address changes can break stateful workflows.Sticky key, duration, scope, and caveats.
Custom routingCan teams bring their own proxy?Custom routing changes ownership and support.Protocol support, credentials, errors, and plan access.
Restricted targetsWhich targets require approval or another product?Restrictions can block production workflows completely.Current acceptable-use and restriction documentation.

Model network costs and restrictions separately.

Browser cost and network cost often differ. One provider meters transferred data. Another combines subscriptions and proxy allowances.

Minimums can dominate short sessions. Media requests can dominate transferred bytes. Restricted targets can force different products.

Compare one representative workflow end to end. Include retries, idle time, and failed starts. Keep published prices outside durable prose.

Cost reviews need more than browser runtime.
FactorCost or constraintMeasurement questionProcurement evidence
Browser runtimeWhich minutes remain billable?Measure startup, idle time, work, and cleanup.Current runtime meter and rounding rules.
Network trafficWhich transferred bytes enter the bill?Capture documents, media, headers, and retries.Current bandwidth meter and minimum charge.
Network tierDoes network choice change usage units?Compare the same workload across allowed networks.Current network-specific usage policy.
Failed startsCan failed provisioning consume credits?Force one documented failure during evaluation.Published charge and refund behavior.
Target restrictionsWhich categories or domains remain unavailable?Test authorized representative targets before purchase.Current restriction and approval requirements.

Validate one production-shaped routing contract.

Documentation starts the evaluation. Controlled tests finish it. Use accounts and targets you may access.

Run one production-shaped task. Keep the target and actions constant. Change only the provider contract.

Capture resource identifiers and timestamps. Record selected geography and observed egress. Preserve errors without exposing credentials.

  1. 01

    Capture the contract revision.

    Save the source URL and verification date. Record the tested plan.

  2. 02

    Provision through documented methods.

    Create one browser through documented methods. Save every returned field.

  3. 03

    Verify observed egress.

    Open a controlled address-check endpoint. Compare requested and observed locations.

  4. 04

    Test session continuity.

    Repeat requests inside one session. Record every observed address change.

  5. 05

    Force routing failure.

    Request unavailable geography intentionally. Record fallback, rejection, and error details.

  6. 06

    Interrupt the connection.

    Interrupt the browser connection. Confirm provider resources reach final cleanup.

  7. 07

    Measure the complete bill.

    Measure browser time and network bytes. Include retries and failed starts.

SourcesBrowserbase proxiesBrowser Use proxiesBrowserless proxiesBright Data Browser API FAQsArchonum API documentation

Keep Legba's current boundary explicit.

Legba publishes a proposed lifecycle contract. It publishes no concrete public browser API host. It publishes no public key-issuer URL.

The preview contains no network-selection field. It contains no geography identifiers or routing fallback contract.

No Playwright endpoint is documented. No CDP endpoint is documented. No callable browser-control contract is published.

Therefore, no Legba routing quickstart is supportable. Recheck canonical docs before implementation.

Current Legba evidence supports narrow conclusions.
FactorDocumented nowStill unknownRequired action
Publication statusA proposed lifecycle shape is public.Production host, issuer, and launch date.Do not call the illustrative endpoints.
Routing fieldsNo public residential routing contract.Network, geography, fallback, and stickiness behavior.Never invent a routing request body.
Browser accessNo callable browser endpoint is published.Protocol, endpoint, versions, and authentication.Never transform it into a guessed endpoint.
Agent accessThe ready agent skill is the published path.A public self-serve browser API remains unavailable.Use the published interface only.

Current Legba evidence supports narrow conclusions.

SourcesLegba API documentationLegba browser API contract guideLegba language model guidance

Choose the smallest complete contract.

Choose the smallest contract meeting actual requirements. More routing options create more failure modes. Unused flexibility still costs review time.

Rank mandatory answers before comparing vendors. Keep optional preferences separate. Reject any mandatory undocumented behavior.

Use the matrix during technical review. Use the checklist during trials. Keep results beside their source dates.

Legba should remain outside implementation comparisons today. Its preview lacks the required routing contract. Update this conclusion after documentation changes.

  • Name the required browser protocol first.
  • Choose exact geography or acceptable fallback.
  • Define required session continuity.
  • Set restricted-target requirements early.
  • Model network and browser costs.
  • Require observable failure behavior.
  • Verify cleanup after interrupted clients.

SourcesLegba browser API contract guideBrowserbase proxiesBrowser Use proxiesBrowserless proxiesBright Data Browser API FAQsArchonum API documentation

FAQs.

What is a residential browser API?
It combines remote browser execution with residential network routing. Each capability still needs separate documentation.
Is a residential browser API a proxy API?
They are different products. Proxy APIs supply network access. Browser APIs also own browser execution.
Does residential routing guarantee an exact location?
No universal guarantee exists. Providers publish different targeting and fallback behavior.
Does residential routing guarantee a stable address?
No universal guarantee exists. Stability depends on documented session and rotation semantics.
Can Playwright connect to every residential browser service?
No universal compatibility exists. Playwright needs a compatible documented endpoint. Residential routing proves no protocol.
Does Legba document residential routing today?
The proposed API contract publishes no routing field. It publishes no geography contract.
What should teams validate first?
Validate browser protocol and routing defaults first. Then test failure and cleanup behavior.

References

  1. 01
  2. 02
  3. 03
  4. 04
  5. 05
  6. 06
  7. 07
  8. 08
  9. 09
  10. 10
  11. 11
  12. 12
  13. 13
  14. 14
    Playwright BrowserTypeMicrosoft Playwright

Keep exploring