MobileProxy.Space Python SDK

Official Python SDK for the MobileProxy.Space API — private mobile proxies on real GSM devices across 52 countries.

Features

• Full API coverage — all endpoints wrapped in typed, documented methods
• Context manager support (with Client(...) as client:)
• Typed exceptions — ApiError, AuthenticationError, RateLimitError
• IP rotation — dedicated change_ip() with no rate limit
• Python 3.8+ compatible
• Type hints throughout + py.typed marker (PEP 561)

Installation

pip install mobileproxy-sdk

Quick Start

from mobileproxy import Client

client = Client("YOUR_API_TOKEN")

# Check balance
balance = client.get_balance()
print(balance)

# List active proxies
proxies = client.get_my_proxy()

# Get current IP
ip = client.get_proxy_ip(12345)

# Rotate IP (no rate limit)
client.change_ip("your_proxy_key")

Context Manager

with Client("YOUR_API_TOKEN") as client:
    balance = client.get_balance()
    print(balance)
# session is closed automatically

API Methods

Proxy Information

Proxy Management

Equipment & GEO

Blacklist

Purchasing & Billing

Utilities

Error Handling

from mobileproxy import Client, ApiError, AuthenticationError, RateLimitError

client = Client("YOUR_API_TOKEN")

try:
    client.get_balance()
except AuthenticationError as e:
    # Invalid API token
    print(e, e.http_code)
except RateLimitError as e:
    # Too many requests — back off and retry
    # Limit: 3 × (number of active proxies) requests/sec
    print(e)
except ApiError as e:
    print(e.http_code, e.response_body)

Configuration

client = Client(
    "YOUR_API_TOKEN",
    timeout=120,     # request timeout in seconds
    base_url="https://mobileproxy.space/api.html",  # default
)

Rate Limits

API requests are limited to 3 × (number of active proxies) per second. For example, 10 proxies = 30 req/s. The change_ip() method uses a separate endpoint with no rate limit.

Requirements

• Python 3.8 or higher
• requests library (installed automatically)

Links

• API Documentation
• Dashboard
• Website
• PHP SDK
• Node.js SDK
• Chrome Extension

License

MIT — see LICENSE.