Proxy locations


North America

South America




See all locations

Network statusCareers

Back to blog

Mobile Proxies Quick Start Guide

Vytenis Kaubrė

2023-05-313 min read

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.

Creating a proxy user

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.

Sample cURL

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

curl '' -U 'customer-USERNAME:PASSWORD' -x ''

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.

Location settings

You can use a single backconnect entry node to specify your targeting preferences by adding parameters in the username:

For instance, see an example of a query structure with country and city parameters:

cURL with country and city parameters

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

curl -x -U "customer-USERNAME-cc-GB-city-london:PASSWORD"

Session control

You may include additional parameters in your query to control your session. To do that, add sessid-abcde12345 to your username string.

cURL with session parameters

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

curl -x -U "customer-USERNAME-sessid-randomString123:PASSWORD"

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:

Response Description
400 Bad Request A proxy server can return this error code if the request doesn’t contain a host to connect to or if there was a generic error when parsing an HTTP request. Make sure you formed the request correctly, including the URL in the request, then try again.
407 Proxy Authentication Required The request lacks proxy authentication information, or the username or password is invalid. Include the Proxy-Authorization header in your request, ensure that your username and password are formed correctly, then try again.
500 Internal Server Error The proxy server has encountered an internal error. Retry the request at a later time.
502 Bad Gateway A proxy server received an invalid response from the upstream server. Retry request.
Response Code 502 signifies that the IP assigned to your session ID is no longer available. If you encounter this error, there are two ways to work around it. The first is to wait for one minute as the system automatically assigns a new IP address to your session ID. Another approach is to switch to a new session ID (i.e., change the sessid parameter) – this way, you’ll receive a new IP address.
522 Timeout A proxy server didn’t receive a response from the upstream server in time. Retry request.
525 No Exit Found Custom HTTP status code - this means the proxy couldn’t find an exit node that satisfies the request. Change request filter parameters or try again at a later time.

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.

Endpoint generator

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.

Usage statistics

The Statistics tab enables you to see detailed information about your daily traffic usage. You can see usage graphs for any selected time period, filter them by users, and export this data to a CSV file.

Usage statistics

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.

Additional resources

If you have any questions or want to claim Oxylabs Mobile Proxies free trial, feel free to contact our Support Team

Also, dive into other developer-focused resources for more insights: 

Frequently asked questions

What is my proxy IP address?

To find out your proxy IP address, either visit or send a request to it via your terminal — your IP address will be returned to you.

How can I change my password?

If you forgot your password, go to the dashboard, click on Forgot password?, and follow the instructions.

Where do I set up a proxy to connect to? Is it in the endpoint generator?

No, the Endpoint generator is dedicated to generating endpoints for your existing proxies. To set up a proxy, find Mobile Proxies in your dashboard and select the Users tab. Then, locate and click the New user button.

What devices can I use Mobile Proxies on, and how to check if they are working?

Any device. Mobile simply means a connection type, not the device it should be used on. This means you can use them in the same way as other proxies. Make a connection request to our service, and you’re good to go! 

For more details, check out our documentation.

How to add more traffic to my Mobile Proxy account?

To quickly top-up the Mobile Proxy traffic, use the self-service option on the dashboard.

When you get through the 50% of your monthly subscription (Starter, Advanced, Premium, Venture, Business or Corporate), you’ll notice the Add more traffic option appearing on the dashboard. Simply click on it, select the amount of GBs, and you’re good to go.

To top-up more GBs than your subscription allows, please contact our support team at Keep in mind that the topped-up traffic doesn’t transfer to the next billing period.

 For more information on pricing and topping up, check out this page.

What Mobile Proxies’ pricing plans does Oxylabs offer?

We offer different monthly subscription plans to suit individual needs:

Regular plans accessible via self-service:

  • Pay as you go — $9/GB (up to 30GB per month)

  • Micro — $99, 12GB ($8.50/GB)

  • Starter — $300, 38GB ($8/GB)

  • Advanced — $600, 80GB ($7.50/GB)

Enterprise plans available via self-service:

  • Premium — $800, 123GB ($6.50/GB)

  • Venture — $1,750, 292GB ($6/GB)

  • Corporate — $3,000, 600GB ($5/GB)

A custom plan is available via contacting sales:

  • Custom — from $5,000, 1TB+ ($4.50/GB)

If you need any help with choosing a Custom plan or getting started with a product, make sure to contact our expert sales team.

Do I get a list of IPs after the purchase?

You don’t get a list of IPs after the purchase. Instead, you’ll have to use an entry node to connect. Our main entry node is, or you can use country-specific entry nodes.

How do I use the proxies once I’ve generated an entry node?

You can start using our proxies on a number of platforms. To find out more, check out our list of integration guides.

Are there any restricted targets?

Yes, to avoid abuse and suspicious activities, some websites are restricted on our Mobile Proxy network. Scraping of such targets as financial institutions, government websites, streaming services, mailing services, and more (please see our documentation for a more detailed list) is prohibited. 

Keep in mind that we also don’t allow using our Mobile Proxies for scraping or navigating search engines. Instead, we offer other solutions, such as Dedicated Datacenter Proxies or SERP Scraper API.

To get further information on Oxylabs’ Mobile Proxies can be utilized for your use case, please get in touch with the customer support team at or via the 24/7 live chat.

About the author

Vytenis Kaubrė

Junior Technical Copywriter

Vytenis Kaubrė is a Junior Technical Copywriter at Oxylabs. His love for creative writing and a growing interest in technology fuels his daily work, where he crafts technical content and web scrapers with Oxylabs’ solutions. Off duty, you might catch him working on personal projects, coding with Python, or jamming on his electric guitar.

All information on Oxylabs Blog is provided on an "as is" basis and for informational purposes only. We make no representation and disclaim all liability with respect to your use of any information contained on Oxylabs Blog or any third-party websites that may be linked therein. Before engaging in scraping activities of any kind you should consult your legal advisors and carefully read the particular website's terms of service or receive a scraping license.

Related articles

Get the latest news from data gathering world

I’m interested