Learn about Bright Data’s API for Mobile proxy network, how to get started, basic guidelines, and some tips for optimal use.

API Documentation - Mobile proxy network

Our API documentation below describes how to use Bright Data's API commands and optional flags used for automating and controlling single or recurrent actions executed in regard to your Mobile proxy zone.

Bright Data's API supports various programming languages, such as shell, Node.js, Java, C#, VB, PHP, Python, Ruby, Perl, etc.

Authentication methods

When you send a request, using your Mobile proxy you'll need to use your zone credentials as an authentication method (<CUSTOMER_ID> and <ZONE_PASSWORD>).

When you send an account management request, you'll need to use an API token as your authentication method.

Mobile Proxy Request Syntax

The simplest GET request with a Mobile Proxy

curl--proxy brd.superproxy.io:22225 --proxy-user brd-customer-<CUSTOMER_ID>-zone-<ZONE_NAME>:<ZONE_PASSWORD> "https://lumtest.com/myip.json" 

The expected output for this request should look like the following:

{"ip":"ALLOCATED_IP","country":"PK","asn":{"asnum":203020,"org_name":"HostRoyale Technologies Pvt Ltd"},"geo":{"city":"Islamabad","region":"IS","region_name":"Islamabad","postal_code":"44040","latitude":33.7233,"longitude":73.0435,"tz":"Asia/Karachi","lum_city":"islamabad","lum_region":"is"}}

Breakdown of the basic request elements


Address of our load balancer that will find the fastest Super Proxy for your request


Infrastructure port of our Super Proxies that is used to receive your requests

-user brd-customer-<CUSTOMER_ID>-zone-<ZONE_NAME> 

Username authentication. In its most basic form, it defines your username and what zone you will use for your request. 


Zone password. All zones have passwords that are used for authentication

For an in-depth interactive display of all the API use cases, integrations, and preferences, please see our API examples page.

Please note: You'll need to sign up (for free), and log in to the Bright Data control panel in order to access this API tool. If you add your payment method, you’ll even receive a $5 credit to get you started!

General Proxy API Functions

Below are the API functions that apply to most of our proxy products

Mobile-Specific API Functions

Below are the API functions that apply to our Mobile proxy network

Mobile Carrier Targeting

You can choose to use a specific carrier from this list:

a1, aircel, airtel, att, celcom, chinamobile, claro, comcast, cox, digi, dt, docomo, dtac, etisalat, idea, kyivstar, meo, megafon, mtn, mtnza, mts, optus, orange, qwest, reliance_jio, robi, sprint, telefonica, telstra, tmobile, tigo, tim, verizon, vimpelcom, vodacomza, vodafone, vivo, zain, vivabo, telenormyanmar, kcelljsc, swisscom, singtel, asiacell, windit, cellc, ooredoo, drei, umobile, cableone, proximus, tele2, mobitel, o2, bouygues, free, sfr, digicel

  • Example for carrier Deutsche Telekom: 
  • Example for carrier Sprint: 

Target-Specific OS (Android)

You can target the Android operating system when using a Mobile proxy by adding -os-androidto your request

curl --proxy brd.superproxy.io:22225 --proxy-user brd-customer-<USERNAME>-zone-<ZONE>-os-android:<PASSWORD> "<TARGET SITE>

Selecting a Specific gIP

Option available only for zones with Dedicated IP allocation type. To target a specific gIP allocated to your zone, use -gip-gip_name request parameter.

curl--proxy brd.superproxy.io:22225 --proxy-user brd-customer-<CUSTOMER_ID>-zone-<ZONE_NAME>-gip-us_7922_fl_hollywood_0:<ZONE_PASSWORD> "http://target.site"

Was this article helpful?