Mobile Proxies Quick Start Guide

Oxylabs Mobile Proxies run on real mobile devices connected to cellular networks and are equipped with automatic rotation, making them the perfect choice for stable public web data collection. 

Follow this guide to learn how to set up and start using Mobile Proxies with ease. Alternatively, you can teach your coding assistant or AI agent everything about our Mobile Proxies in just a few steps with Agent Skills. Learn how.

Setting up Mobile Proxies

1. Register and create an instance

Start by heading to the Oxylabs Dashboard and create an account. There, click + Add product instance and select Mobile Proxies. Then set an instance name, choose an authentication method, and create the product instance.

For your convenience, you can copy the cURL example below:

curl -x pr.oxylabs.io:7777 -U "customer-USERNAME:PASSWORD" https://ip.oxylabs.io/location

Then, simply paste the cURL example, replace USERNAME and PASSWORD with your credentials, and send the request to get your Mobile IP address.

The following is an example of this query in code form:

curl -x pr.oxylabs.io:7777 -U "customer-USERNAME-cc-GB-city-london:PASSWORD" https://ip.oxylabs.io/location

Session control

You may include additional parameters in your query to control your session. One of the options is to add sessid-abcde12345 to your username string.

Here's a code example you can copy and use for your convenience:

curl -x pr.oxylabs.io:7777 -U "customer-USERNAME-sessid-randomString123:PASSWORD" https://ip.oxylabs.io/location

By default, each request returns a random IP address as Oxylabs Mobile Proxies rotate automatically. The standard session time is 10 minutes, but you can extend it to 24 hours using the sesstime parameter. 

If you need the same IP for the whole session, you can also use the sessid_oneip parameter. This session type keeps the original IP for as long as the proxy is available, up to the configured session duration. Unlike standard sessid sessions, no new IP will be assigned if the original proxy IP becomes unavailable. Instead, the request will return a 502 error.

For a full list of supported parameters and languages, head to our documentation.

Response codes

See the most common response codes in the table below:

If an error originates from our infrastructure, the response will include an X-Error-Description header that provides details about the error and further steps to resolve it. Contact our Support Team for assistance if you run into any other response codes.

Using Endpoint Generator

The Endpoint Generator is an automated tool in Oxylabs Dashboard that’s designed to generate custom lists of Mobile Proxy endpoints. Endpoint Generator can be found in your Mobile Proxy product instance Overview:

We suggest using our Endpoint Generator to easily retrieve a list of endpoints by selecting the necessary parameters. With this tool, you can retrieve a list of endpoints that include:

• Region – a region based on your location.

• Proxy protocol – choose from available proxy protocols: HTTP, HTTPS, or SOCKS5.

• Endpoint type – you can choose between backconnect or country entry.

• Location settings – select a specific proxy country or city location. Alternatively, leave Any to get a random proxy location.

• Session type – you can choose from a sticky session to keep your IP address, a rotating session to get a new IP address with each new request, or a one-IP sticky session that doesn’t switch IPs if the connection breaks before the session duration ends.

• Session duration – Choose the session duration on the slider for your sticky session between 1 minute and 24 hours.

Once you have the parameters set up, choose from popular options like cURL, Python, PHP, Node.js, GO, Java, or get integration details (host, port, username/password, and connection protocol)

Overall, the Endpoint generator is a more convenient way to set up your endpoints and export them. You can find more detailed information in our documentation.

Note: The purpose of the Endpoint generator is to create endpoints only. You need your own terminal or other setup to put the endpoints to use.

In addition to monitoring your proxy usage, you can also set traffic limits using the dashboard.

To do that, open your Mobile Proxy instance, select Configurator tab, and click Limits & spending. There, you can enable usage limits, configure the details, and choose the action: Disable instance when the limit is reached or Send email alerts without disabling the instance.