From 8ad205d5dc21bd4598868645df2f73fe7e6491e8 Mon Sep 17 00:00:00 2001 From: tnsardesai <18272584+tnsardesai@users.noreply.github.com> Date: Mon, 14 Sep 2026 23:32:43 +0000 Subject: [PATCH] Document regional ISP proxy support --- proxies/isp.mdx | 26 +++++++++++++++++++++----- proxies/overview.mdx | 2 +- reference/cli/proxies.mdx | 5 ++++- 3 files changed, 26 insertions(+), 7 deletions(-) diff --git a/proxies/isp.mdx b/proxies/isp.mdx index 131b6c71..1bb9322e 100644 --- a/proxies/isp.mdx +++ b/proxies/isp.mdx @@ -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: + + +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`. + ```typescript Typescript/Javascript @@ -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({ @@ -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) @@ -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) @@ -75,8 +90,9 @@ func main() { ``` -## 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 diff --git a/proxies/overview.mdx b/proxies/overview.mdx index fe1ac500..3cae5c04 100644 --- a/proxies/overview.mdx +++ b/proxies/overview.mdx @@ -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. 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. diff --git a/reference/cli/proxies.mdx b/reference/cli/proxies.mdx index 79f6696f..42077f97 100644 --- a/reference/cli/proxies.mdx +++ b/reference/cli/proxies.mdx @@ -26,7 +26,7 @@ Create a new proxy configuration. Proxy quality for bot detection avoidance, bes | `--type ` | `datacenter`, `isp`, `residential`, `mobile`, or `custom`. Required. | | `--name ` | Proxy configuration name. | | `--protocol ` | Protocol to use (`http` or `https`; default: `https`). | -| `--country ` | ISO 3166 country code or `EU`. | +| `--country ` | ISO 3166 country code or `EU`. ISP proxies support `US`, `SG`, `GB`, `FR`, and `DE`. | | `--city ` | City name or provider alias. Residential and mobile; requires `--country`. | | `--state ` | State/region code. Residential, or US-only for mobile. | | `--zip ` | ZIP/postal code. Residential only. | @@ -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