Session types

Rotating sessions assign a new residential IP on every request. This is the default mode and best suited for high-volume scraping where each request is independent.

const session = await client.sessions.create({
  type: "rotating",
  country: "US",
});

Sticky sessions

Sticky sessions hold the same IP for a configurable duration, letting you complete multi-step flows without changing identity mid-way.

const session = await client.sessions.create({
  type: "sticky",
  duration: 600, // seconds
  country: "DE",
});

Choosing a session type

Use rotating sessions for independent page fetches at scale. Use sticky sessions for logins, checkouts, or any flow where the target site expects a consistent IP across multiple requests.