Skip to content

Document regional ISP proxy support #571

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
tnsardesai merged 1 commit into from
Sep 15, 2026
+26 −7
Merged

Document regional ISP proxy support #571

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 21 additions & 5 deletions proxies/isp.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,11 @@ This makes ISP proxies suitable for use cases that require a stable IP, such as

## Configuration

Create an ISP proxy:
Create an ISP proxy with an exit IP in Singapore:

<Info>
ISP proxies support country targeting in the United States (`US`), Singapore (`SG`), the United Kingdom (`GB`), France (`FR`), and Germany (`DE`). If you omit `country`, the proxy defaults to `US`.
</Info>

<CodeGroup>
```typescript Typescript/Javascript
Expand All @@ -22,7 +26,10 @@ const kernel = new Kernel();

const proxy = await kernel.proxies.create({
type: 'isp',
name: 'my-isp-proxy',
name: 'my-sg-isp-proxy',
config: {
country: 'SG',
},
});

const browser = await kernel.browsers.create({
Expand All @@ -37,7 +44,10 @@ kernel = Kernel()

proxy = kernel.proxies.create(
type="isp",
name="my-isp-proxy",
name="my-sg-isp-proxy",
config={
"country": "SG",
},
)

browser = kernel.browsers.create(proxy_id=proxy.id)
Expand All @@ -58,7 +68,12 @@ func main() {

proxy, err := client.Proxies.New(ctx, kernel.ProxyNewParams{
Type: kernel.ProxyNewParamsTypeIsp,
Name: kernel.String("my-isp-proxy"),
Name: kernel.String("my-sg-isp-proxy"),
Config: kernel.ProxyNewParamsConfigUnion{
OfProxyNewsConfigIspProxyConfig: &kernel.ProxyNewParamsConfigIspProxyConfig{
Country: kernel.String("SG"),
},
},
})
if err != nil {
panic(err)
Expand All @@ -75,8 +90,9 @@ func main() {
```
</CodeGroup>

## Configuration Parameters
## Configuration parameters

- **`country`** (optional) - ISO 3166 country code. Supported values are `US`, `SG`, `GB`, `FR`, and `DE`. Defaults to `US`.
- **`bypass_hosts`** (optional) - Array of hostnames that bypass the proxy and connect directly (max 100 entries)

## Bypass hosts
Expand Down
2 changes: 1 addition & 1 deletion proxies/overview.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ Kernel supports five types of proxies:
4. [**Mobile**](/proxies/mobile) - Traffic routed through mobile carrier networks
5. [**Custom**](/proxies/custom) - Your own proxy servers

Datacenter has the fastest speed, while residential and mobile are least detectable. ISP is a balance between the options, with less-flexible geotargeting. Kernel recommends using the first option in the list that works for your use case.
Datacenter has the fastest speed, while residential and mobile are least detectable. ISP balances speed, stability, and bot detection avoidance, with country targeting in the United States (`US`), Singapore (`SG`), the United Kingdom (`GB`), France (`FR`), and Germany (`DE`). Kernel recommends using the first option in the list that works for your use case.

<Note>
Kernel-provided proxies are unmetered and not billed, subject to the fair use rules and restricted destinations in our [Acceptable Use Policy](/acceptable-use#proxy-fair-use). Some destination categories — including banking and payment domains — are blocked by our upstream network providers and will fail at the proxy layer. Reach them directly or with a [custom proxy](/proxies/custom) instead.
Expand Down
5 changes: 4 additions & 1 deletion reference/cli/proxies.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ Create a new proxy configuration. Proxy quality for bot detection avoidance, bes
| `--type <type>` | `datacenter`, `isp`, `residential`, `mobile`, or `custom`. Required. |
| `--name <name>` | Proxy configuration name. |
| `--protocol <protocol>` | Protocol to use (`http` or `https`; default: `https`). |
| `--country <code>` | ISO 3166 country code or `EU`. |
| `--country <code>` | ISO 3166 country code or `EU`. ISP proxies support `US`, `SG`, `GB`, `FR`, and `DE`. |
| `--city <name>` | City name or provider alias. Residential and mobile; requires `--country`. |
| `--state <code>` | State/region code. Residential, or US-only for mobile. |
| `--zip <zip>` | ZIP/postal code. Residential only. |
Expand All @@ -43,6 +43,9 @@ Create a new proxy configuration. Proxy quality for bot detection avoidance, bes
# Datacenter proxy in the US
kernel proxies create --type datacenter --country US --name "US Datacenter"

# ISP proxy with a static exit IP in the United Kingdom
kernel proxies create --type isp --country GB --name "GB ISP"

# Custom proxy server
kernel proxies create --type custom --host proxy.example.com --port 8080 --username myuser --password mypass

Expand Down
Loading