diff --git a/docs.json b/docs.json index 06727fa..d707946 100644 --- a/docs.json +++ b/docs.json @@ -72,7 +72,6 @@ "pages": [ "proxies/overview", "proxies/custom", - "proxies/mobile", "proxies/residential", "proxies/isp", "proxies/datacenter" diff --git a/proxies/mobile.mdx b/proxies/mobile.mdx deleted file mode 100644 index 0f18d23..0000000 --- a/proxies/mobile.mdx +++ /dev/null @@ -1,80 +0,0 @@ ---- -title: "Mobile Proxies" ---- - -Mobile proxies use real mobile IPs from devices on cellular networks worldwide. These IPs are distributed by ISPs to mobile devices, where real users opt-in to share their connection. Mobile proxies have limited availability. - -## Configuration - -Mobile proxies support carrier selection and advanced targeting options: - - - -```typescript Typescript/Javascript -import { Kernel } from '@onkernel/sdk'; -const kernel = new Kernel(); - -const proxy = await kernel.proxies.create({ - type: 'mobile', - name: 'mobile-proxy' -}); - -const browser = await kernel.browsers.create({ - proxy_id: proxy.id -}); -``` - -```Python Python -import kernel -client = kernel.Kernel() - -proxy = client.proxies.create( - type='mobile', - name='mobile-proxy' -) - -browser = client.browsers.create( - proxy_id=proxy.id -) -``` - - - -## Configuration Parameters - -- **`country`** - ISO 3166 country code -- **`carrier`** - Mobile carrier name (see available carriers below) -- **`state`** - Two-letter state code. Only supported for US and Australia. Cannot be used with `city` -- **`city`** - City name (lowercase, no spaces, e.g., `newyork`, `losangeles`). Required if `zip` is provided -- **`zip`** - US ZIP code (5 digits). Requires `city` to be provided -- **`asn`** - Autonomous System Number. Mutually exclusive with geo-location targeting - -## Supported Carriers - -Major carriers worldwide are supported: - -**US Carriers:** -- `att` - AT&T -- `verizon` - Verizon -- `tmobile` - T-Mobile -- `sprint` - Sprint -- `comcast` - Xfinity Mobile -- `cox` - Cox Mobile - -**International Carriers:** -- `vodafone` - Vodafone -- `orange` - Orange -- `telefonica` - Telefónica -- `dt` - Deutsche Telekom -- `docomo` - NTT Docomo -- `chinamobile` - China Mobile -- `airtel` - Bharti Airtel -- `telstra` - Telstra - -See API reference for complete list of carriers. - -## Limitations - -Mobile proxies have limited availabilty, especially when more specific configuration options are provided. Sometimes, no mobile proxies are available in any region. Proxy availablity is tested when creating a proxy, and when associating a browser to a proxy. Use residential proxies for better availability, and prefer to use mobile only where it's required and limited availability can be tolerated. - -A 502 error is returned when no proxies are available. \ No newline at end of file diff --git a/proxies/overview.mdx b/proxies/overview.mdx index 70fb6ca..30e3d1d 100644 --- a/proxies/overview.mdx +++ b/proxies/overview.mdx @@ -10,13 +10,14 @@ Kernel proxies enable you to route browser traffic through different types of pr ## Proxy Types -Kernel supports five types of proxies, ranked by quality (from best to worst): +Kernel supports four types of proxies: -0. [**Custom**](/proxies/custom) - Your own proxy servers -1. [**Mobile**](/proxies/mobile) - Traffic routed through mobile carrier networks -2. [**Residential**](/proxies/residential) - Traffic routed through residential ISP connections -3. [**ISP**](/proxies/isp) - Traffic routed through ISP data centers -4. [**Datacenter**](/proxies/datacenter) - Traffic routed through commercial data centers +1. [**Datacenter**](/proxies/datacenter) - Traffic routed through commercial data centers +2. [**ISP**](/proxies/isp) - Traffic routed through data centers, using residential IP addresses leased from from internet service providers +3. [**Residential**](/proxies/residential) - Traffic routed through real residential IP addresses +4. [**Custom**](/proxies/custom) - Your own proxy servers + +Datacenter has the fastest speed, while residential is least detectable. ISP is a balance between the two options, with less-flexible geotargeting. Kernel recommends to use the first option in the list that works for your use case. ## 1. Create a proxy