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 block-free public web data collection. 

Follow this guide to learn how to set up and start using Mobile Proxies with ease.

Setting up Mobile Proxies

To get started with Mobile Proxies, create an account in the Oxylabs dashboard. You can either select your preferred plan or claim a free trial by contacting our Support Team. 

Once you’ve acquired your Mobile Proxies subscription, you’ll be directed to the setup screen to create your first proxy user.

Creating a proxy user

Find the Create proxy user on your dashboard and give your user a name and a password.

You can also create more users by visiting My Products on the left-hand side and finding Mobile Proxies. Then, locate and select the Users tab — click on New User. As before, create a name and a password. 

Starting with Mobile Proxies

After generating a proxy user, you’ll receive a cURL example that you can run in your terminal or any other setup you prefer.

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

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

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

You can also watch the video below for guidance on making a basic cURL request.

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. To do that, 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

Normally, 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 30 minutes using the sesstime parameter. 

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

Endpoint generator is a configuration tool built to simplify the integration process for Mobile Proxies. This tool enables you to easily customize and retrieve a list of endpoints by specifying such parameters as:

• Output format — choose a format you’ll get your endpoints list in (port, HTTP, HTTPS, SOCKS5). 

• Authentication method — choose to connect with your credentials or use whitelisted IPs.

• Endpoint type — select either backconnect or country entry.

• Location settings — choose a specific proxy location or leave Any for a random location.

• Session type — keep your IP address for 30 minutes with a sticky session or get a random IP with each request via a rotating session.

After you've chosen your parameters, select the number of endpoints and export the data in your preferred file type, such as CSV, JSON, or TXT.

NOTE: The Endpoint generator is a configuration tool only. To use our proxies, you still need your own terminal or other setup.

Find more detailed information in our documentation, or check out the video below.

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

To do that, find and select Usage limits on the left-hand side. Then click on Create a rule, choose your product and proxy user. You can then set either daily, monthly or lifetime traffic limits with a specific amount of GBs. Once you’re finished, hit Create limit rule.