Skip to main content
Residential proxies route traffic through real residential IP addresses. They support advanced targeting options including city, state, and operating system.

Configuration

Residential proxies support multiple targeting parameters:
import { Kernel } from '@onkernel/sdk';
const kernel = new Kernel();

const proxy = await kernel.proxies.create({
  type: 'residential',
  name: 'my-la-residential',
  config: {
    country: 'US',
    city: 'los_angeles'
  }
});

const browser = await kernel.browsers.create({
  proxy_id: proxy.id
});

Configuration Parameters

  • country - ISO 3166 country code. Must be provided when providing other targeting options.
  • state - Two-letter state code. Only supported for US.
  • city - City name (lowercase, no spaces, e.g., sanfrancisco, newyork).
  • zip - US ZIP code (5 digits). Conflicts with city and state.
  • asn - Autonomous System Number. Conflicts with city and state.
I