@mobileproxy/sdk

MobileProxy.Space Node.js SDK

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

Features

• Full API coverage — all endpoints wrapped in async methods with JSDoc
• TypeScript declarations included (index.d.ts)
• Zero dependencies — uses native fetch (Node.js 18+)
• CJS + ESM — works with require() and import
• Typed errors — ApiError, AuthenticationError, RateLimitError
• IP rotation — dedicated changeIp() with no rate limit

Installation

npm install @mobileproxy/sdk

Quick Start

const MobileProxyClient = require('@mobileproxy/sdk');

const client = new MobileProxyClient('YOUR_API_TOKEN');

// Check balance
const balance = await client.getBalance();
console.log(balance);

// List active proxies
const proxies = await client.getMyProxy();

// Get current IP
const ip = await client.getProxyIp(12345);

// Rotate IP (no rate limit)
await client.changeIp('your_proxy_key');

ESM

import MobileProxyClient from '@mobileproxy/sdk';

const client = new MobileProxyClient('YOUR_API_TOKEN');
const balance = await client.getBalance();

API Methods

Proxy Information

Method	Description
getProxyIp(proxyId, options?)	Get current IP address of a proxy
getMyProxy(proxyId?)	List active proxies (all or specific)
getIpStats()	IP address statistics by GEO

Proxy Management

Method	Description
changeProxyCredentials(proxyId, login, password)	Change proxy login/password
rebootProxy(proxyId)	Restart the modem
editProxy(proxyId, options?)	Update proxy settings
changeIp(proxyKey, options?)	Rotate IP (no rate limit)

Equipment & GEO

Method	Description
changeEquipment(proxyId, options?)	Switch modem/SIM/operator/city
getAvailableEquipment(proxyId, options?)	List available equipment by GEO
getGeoList(proxyId, geoId)	Available GEOs for a proxy
getOperators(geoId)	Operators for a GEO
getCountries(onlyAvailable?)	List of countries
getCities()	List of cities

Blacklist

Method	Description
getBlackList(proxyId)	Get equipment/operator blacklist
addOperatorToBlackList(proxyId, operatorId)	Block an operator
removeOperatorFromBlackList(proxyId, operatorId)	Unblock an operator
removeFromBlackList(proxyId, blackListId, eid)	Remove equipment from blacklist

Purchasing & Billing

Method	Description
buyProxy(options)	Purchase a proxy
refundProxy(proxyId)	Request a refund
getBalance()	Account balance
getPrices(countryId)	Prices for a country
getTestProxy(geoId, operator)	Get a free 2-hour trial proxy

Utilities

Method	Description
checkEquipmentAvailability(eid)	Check if equipment is available
viewUrlFromDifferentIps(url, countryId)	Anti-cloaking: view URL from another country
getTaskResult(taskId)	Get async task result

Error Handling

const { ApiError, AuthenticationError, RateLimitError } = require('@mobileproxy/sdk');

try {
  await client.getBalance();
} catch (err) {
  if (err instanceof AuthenticationError) {
    // Invalid API token
  } else if (err instanceof RateLimitError) {
    // Too many requests — back off and retry
  } else if (err instanceof ApiError) {
    console.error(err.message, err.httpCode, err.responseBody);
  }
}

Configuration

const client = new MobileProxyClient('YOUR_API_TOKEN', {
  timeout: 120000,  // request timeout in ms
  baseUrl: '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 changeIp() method uses a separate endpoint with no rate limit.

Requirements

• Node.js 18 or higher (uses native fetch)

Links

• API Documentation
• Dashboard
• Website
• PHP SDK
• Chrome Extension

License

MIT — see LICENSE.