Skip to content

mobile.mdx

Latest commit

 

History

History
86 lines (65 loc) · 2.36 KB

mobile.mdx

File metadata and controls

86 lines (65 loc) · 2.36 KB
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:

import { Kernel } from '@onkernel/sdk';
const kernel = new Kernel();

const proxy = await kernel.proxies.create({
  type: 'mobile',
  name: 'my-tmobile-proxy',
  config: {
    carrier: 'tmobile'
  }
});

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

proxy = client.proxies.create(
    type='mobile',
    name='my-tmobile-proxy',
    config={
        'carrier': 'tmobile'
    }
)

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.