Skip to main content
Grasp provides built-in support for IP proxies, allowing you to route your browser’s traffic through different locations and IP types. This is essential for web scraping, testing geo-restricted content, and avoiding IP blocks.

​
Overview

When creating a browser container, you can specify a proxy configuration object. Grasp manages the underlying proxy infrastructure, rotating IPs and handling authentication automatically. We support the following proxy types:
  • Residential: Real residential IPs (highest success rate, harder to detect).
  • Datacenter: Fast, cost-effective IPs from data centers.
  • ISP: Static residential IPs.
  • Mobile: 3G/4G/5G mobile network IPs.

​
Usage

import { Grasp } from '@getgrasp/sdk';

const grasp = new Grasp();

const browser = await grasp.create({
  proxy: {
    enabled: true,
    type: 'residential',
    country: 'us',
  }
});

​
Configuration Options

The proxy object supports the following properties:
​
enabled
boolean
default:"false"
Whether to enable the proxy. Defaults to false. Must be set to true to enable proxy functionality.
​
type
string
default:"residential"
The type of proxy. Supported values: 'residential', 'datacenter', 'isp', 'mobile'.
​
country
string
default:"us"
The 2-letter ISO country code (e.g., 'us', 'jp', 'gb').
​
city
string
Specific city name (optional).
​
state
string
Specific state/province name (optional).

​
Best Practices

  • Use Residential Proxies for Scraping: For targets with strict anti-bot measures, residential proxies are recommended as they appear as regular user traffic.
  • Use Datacenter Proxies for Speed: If the target is lenient, datacenter proxies are faster and cheaper.