API Documentation

API

Contenido del artículo

Límites para trabajar con la API

  • Las mismas solicitudes se pueden enviar no más de 1 vez cada 5 segundos. Si superas la limitación de frecuencia, el servidor devolverá un error: "Too many lonely requests. Timeout 5 second"
  • A los métodos API se puede acceder no más de 3*(cantidad de proxies activos comprados) veces por segundo. Si superas la limitación de frecuencia, el servidor devolverá un error: "Too many requests per second". (Si tienes 10 proxies entonces el límite es 30 solicitudes por segundo, si 100 proxies entonces 300 solicitudes por segundo...)

SDK

PHP SDK
Node SDK
Python SDK
OpenAPI Spec

Quick Start

Esta solicitud permite saber qué dirección IP está proporcionando tu proxy en este momento

curl --request GET \
  --url 'https://mpsapi.com/api.html?command=get_my_proxy' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
$ch = curl_init('https://mpsapi.com/api.html?command=get_my_proxy');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer {do_not_working_token_only_for_preview}']
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);
import requests
response = requests.get(
    'https://mpsapi.com/api.html',
    params={'command': 'get_my_proxy'},
    headers={'Authorization': 'Bearer {do_not_working_token_only_for_preview}'}
)
result = response.json()
Rate limit: 3 req/sec (×N active proxies). Same request cooldown: 3 sec. HTTP 429 on exceed.

ERRORS Response format & errors

Success
{
  "status": "ok",
  ...
}
Error
{
  "status": "err",
  "message": "Human-readable description of the problem"
}
The HTTP status code is 200 even for errors (the only exception is 429 when the rate limit is exceeded). Always branch on the status field, not on the HTTP code. Some errors add extra fields, e.g. url, details, proxy_type.
Authorization errors
Authorization error #1. No authorization header — the Authorization header is missing
Authorization error #2. No authorization token — the header has no Bearer token
Authorization error #3. Wrong token — token is unknown or revoked
Authorization error #4. Wrong IP — token is used from an IP that is not in your API IP whitelist
Common command errors
NULL proxy_id / NULL eid / NULL IP — a required parameter is missing or not numeric
not enough balance / Low balance. Need X, you have Y — top up the balance to perform the operation
Modem always rented or can not rent — the chosen equipment is already taken or unavailable
Modem not support this command — the rotation/command code is not 1–4
proxy_not_found / proxy_invalid — proxy does not exist or does not belong to you
proxy_connect_failed — could not connect through the proxy (see details, proxy_type)
proxy_or_proxy_id_required — pass either proxy or proxy_id
Only http/https URLs are allowed — the supplied URL scheme is not permitted
No json data / Not valid json data / Invalid JSON — the POST body is missing or malformed
specify at least one filter: id_country, operator_id or geoid — required for get_free_eid_list
Cannot disable equipment #X: N active client rental(s)… — release active rentals first
Good to know when parsing responses: numeric values are often returned as strings (e.g. "15"); proxy_exp is a MySQL DATETIME string (YYYY-MM-DD HH:MM:SS), not a Unix timestamp; and a few legacy commands return status in a different case ("OK") — compare it case-insensitively.

GET Obtener dirección IP de tu proxy

Esta solicitud permite saber qué dirección IP está proporcionando tu proxy en este momento

Solicitud Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=proxy_ip&proxy_id={proxy_id}{&check_spam=true}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Parámetros de la solicitud
proxy_id int, int list , *obligatorio — ID del proxy, para múltiples usar coma: 1,2,3,4
check_spam bool — Si se especifica el parámetro check_spam=true, se verificará la dirección IP del proxy proporcionada en la base de datos de direcciones de spam de IPGuardian.net.: true
Respuesta JSON
{
  "status": "ok",
  "ip": "123.45.67.89",
  "ipguardian.net": { ... }
}

GET Cambio de IP proxy

Esta solicitud no requiere encabezado de autorización, basta con abrir el enlace de cambio de IP desde el navegador. Si usas una llamada programática, es obligatorio especificar el User-Agent del navegador. El enlace se encuentra en la tabla Mis proxies en la columna Cambio de IP. Este comando no tiene el límite API de 3 solicitudes por segundo.

Solicitud Curl
curl --request GET --url 'https://changeip.mobileproxy.space/?proxy_key={proxy_key}&format={format}'
Parámetros de la solicitud
proxy_key varchar(32) , *obligatorio — Clave proxy, está en link para cambiar IP en sección Mis proxies
format string — Formato respuesta: json o 0
Respuesta JSON
{
  "status": "ok",
  "code": 0,
  "new_ip": "1.2.3.4",
  "rt": 1234,
  "message": "...",
  "proxy_id": 123
}

GET Obtención de precios

Solicitud Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=get_price&id_country={id_country}¤cy={currency}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}' \
  --header 'Accept-Language: en'
Parámetros de la solicitud
id_country int, int list — Identificador del país (obtenido con comando get_id_country): 1,2,3,4
currency string — usd, rub (default rub)
Respuesta JSON
{
  "status": "ok",
  "price": [
    {
      "id_country": 1,
      "iso": "RU",
      "amount": 700,
      "country_name": "..",
      "period": 30
    },
    ...
  ]
}

GET Obtener lista negra de equipo y operadores

Solicitud Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=get_black_list&proxy_id={proxy_id}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Parámetros de la solicitud
proxy_id int, int list — ID del proxy, para múltiples usar coma: 1,2,3,4
Respuesta JSON
{
  "status": "ok",
  "black_list_equipment": {
    "123": {
      "black_list_id": 123,
      "eid": 456,
      "proxy_id": 789,
      "operator_id": 1,
      "geoid": 10
    }
  },
  "black_list_operators": {
    "1": {
      "operator_black_list_id": 1,
      "proxy_id": 789,
      "operator_id": 1,
      "operator_name": "..",
      "id_country": 1
    }
  }
}

GET Agregar operador a lista negra

Solicitud Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=add_operator_to_black_list&proxy_id={proxy_id}&operator_id={operator_id}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Parámetros de la solicitud
proxy_id int — ID proxy
operator_id int , *obligatorio — ID del operador
Respuesta JSON
{ "status": "ok" }

GET Eliminar operador de lista negra

Solicitud Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=remove_operator_black_list&proxy_id={proxy_id}&operator_id={operator_id}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Parámetros de la solicitud
proxy_id int, int list — ID de proxy, para cambiar varios usa coma: 1,2,3,4
operator_id int , *obligatorio — ID del operador

Si no se especifica ningún parámetro, se limpiará toda la lista

Respuesta JSON
{ "status": "ok" }

GET Eliminar registros de lista negra de equipo

Solicitud Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=remove_black_list&proxy_id={proxy_id}&black_list_id={black_list_id}&eid={eid}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Parámetros de la solicitud
proxy_id int, int list — ID de proxy, para cambiar varios usa coma: 1,2,3,4
black_list_id int — Identificador del registro
eid int — Identificador del equipo

Si no se especifica ningún parámetro, se limpiará toda la lista

Respuesta JSON
{ "status": "ok" }

GET Obtener lista de tus proxies activos

Solicitud Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=get_my_proxy&proxy_id={proxy_id}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Parámetros de la solicitud
proxy_id int, int list — ID del proxy, para múltiples usar coma: 1,2,3,4
Respuesta JSON
[
  {
    "proxy_id": 123,
    "proxy_exp": "2025-12-31 23:59:59",
    "proxy_login": "abc123",
    "proxy_pass": "xyz789",
    "proxy_hostname": "s1.example.com",
    "proxy_host_ip": "1.2.3.4",
    "proxy_independent_http_hostname": "..",
    "proxy_independent_http_host_ip": "..",
    "proxy_independent_socks5_hostname": "..",
    "proxy_independent_socks5_host_ip": "..",
    "proxy_independent_port": 1234,
    "proxy_http_port": 5000,
    "proxy_socks5_port": 5001,
    "proxy_operator": "MTS",
    "proxy_geo": "Moscow, Russia",
    "proxy_auto_renewal": 1,
    "proxy_change_ip_url": "https://...",
    "proxy_reboot_time": 5,
    "proxy_ipauth": "1.2.3.4",
    "proxy_groups_name": "Group1",
    "proxy_auto_change_equipment": 0,
    "eid": 456,
    "geoid": 10,
    "id_country": 1,
    "proxy_self": 0,
    "proxy_testing": 0,
    "proxy_comment": "My proxy"
  },
  ...
]

GET Cambiar login y contraseña del proxy

Solicitud Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=change_proxy_login_password&proxy_id={proxy_id}&proxy_login={proxy_login}&proxy_pass={proxy_pass}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Parámetros de la solicitud
proxy_id int, int list , *obligatorio — Identificador del proxy
proxy_login text , *obligatorio — Login (solo letras y números latinos), si no se indica se genera automáticamente
proxy_pass text , *obligatorio — Contraseña (solo letras y números latinos), si no se indica se genera automáticamente
Respuesta JSON
{
  "status": "ok",
  "proxy_id": 123,
  "proxy_login": "new",
  "proxy_pass": "pass"
}

GET Reinicio del proxy

Solicitud Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=reboot_proxy&proxy_id={proxy_id}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Parámetros de la solicitud
proxy_id int , *obligatorio — Identificador del proxy
Respuesta JSON
{
  "status": "ok",
  "message": "..."
}

GET Obtener solo equipo disponible agrupado por GEO y operador

Solicitud Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=get_geo_operator_list{&type={type}}{&equipments_back_list=1}{&operators_back_list=1}{&show_count_null=1}{&proxy_id={proxy_id}}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Parámetros de la solicitud
type int — Tipo de proxy: 0 — móvil, 1 — servidor, 2 — backconnect (por defecto 0): 0/1/2 (auto-detected from proxy_id if omitted)
equipments_back_list isset — Excluir de la lista el contenido de la lista negra de equipo
operators_back_list isset — Excluir de la lista el contenido de la lista negra de operadores (type=0 only)
proxy_id int — Identificador del proxy, si se especifica, en la respuesta a la solicitud se indicarán los servidores a los cuales se puede cambiar GEO (also sets type to this proxy's type unless overridden)
show_count_null bool — Show null count, default false
Respuesta JSON (type=0)
{
  "status": "ok",
  "geo_operator_list": {
    "10": {
      "geoid": 10,
      "geo_caption": "Moscow",
      "id_city": 1,
      "id_country": 1,
      "count_free": {
        "MTS": 15,
        "Beeline": 8
      }
    },
    ...
  }
}
Respuesta JSON (type=1, type=2)
{
  "status": "ok",
  "geo_operator_list": {
    "42": {
      "geoid": 42,
      "geo_caption": "Frankfurt",
      "id_city": 7,
      "id_country": 13,
      "count_free": 27
    },
    ...
  }
}

GET Free EID list

Solicitud Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=get_free_eid_list&id_country={id_country}{&operator_id={operator_id}}{&geoid={geoid}}{&type={type}}{&equipments_back_list=1}{&limit={limit}}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Parámetros de la solicitud
id_country int, int list — Filter by country: 1,13. At least one of id_country / operator_id / geoid is required
operator_id int, int list — Filter by operator (type=0 only)
geoid int, int list — Filter by geo point (partners_modems_id)
type int — 0/1/2, default 0
equipments_back_list isset — Excluir de la lista el contenido de la lista negra de equipo
limit int — Max rows, default 1000, max 10000
The "free" predicate is identical to count_free from get_geo_operator_list, so the number of returned eid matches that catalog counter.
Respuesta JSON
{
  "status": "ok",
  "count": 2,
  "free_eid": [
    {
      "eid": 12345,
      "geoid": 42,
      "operator_id": 3,
      "id_country": 13,
      "id_city": 7
    },
    ...
  ]
}

GET Obtener lista de operadores

Solicitud Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=get_operators_list&geoid={geoid}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Parámetros de la solicitud
geoid int, int list — IDs de GEO para obtener cantidad de puertos con operadores por GEO, separados por coma: 1,2,3,4
Respuesta JSON
[
  {
    "operator": "MTS",
    "id_country": 1,
    "count_free": 15
  },
  ...
]

GET Obtener lista de países

curl --request GET \
  --url 'https://mpsapi.com/api.html?command=get_id_country&only_avaliable=1' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}' \
  --header 'Accept-Language: en'
Parámetros de la solicitud
only_avaliable bool — Si especificas este parámetro, el comando devolverá solo países con equipo disponible para alquiler con indicación de cantidad , opcional
Respuesta JSON
{
  "status": "ok",
  "id_country": { ... }
}

GET Obtener lista de ciudades

curl --request GET \
  --url 'https://mpsapi.com/api.html?command=get_id_city' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}' \
  --header 'Accept-Language: en'
Respuesta JSON
{
  "status": "ok",
  "id_city": { ... }
}

GET Obtener lista de GEO disponibles

Solicitud Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=get_geo_list&proxy_id={proxy_id}&geoid={geoid}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Parámetros de la solicitud
proxy_id int — Identificador del proxy, si se especifica, en la respuesta a la solicitud se indicarán los servidores a los cuales se puede cambiar GEO
geoid int, int list — IDs de GEO para obtener cantidad de puertos con operadores por GEO, separados por coma: 1,2,3,4
Respuesta JSON
[
  {
    "geoid": 10,
    "geo_caption": "Moscow",
    "count_free": 15,
    "iso": "RU",
    "id_city": 1
  },
  ...
]

GET Cambio de equipo

Solicitud Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=change_equipment&proxy_id={proxy_id}&operator={operator}&geoid={geoid}&id_country={id_country}&id_city={id_city}&eid={eid}{&add_to_black_list=1}{&check_after_change=true}{&check_spam=true}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Parámetros de la solicitud
proxy_id int, int list , *obligatorio — ID de proxy, para cambiar varios usa coma: 1,2,3,4
operator varchar — ID del operador (opcional), obtenido de get_operators_list
geoid int — ID de GEO (opcional), obtenido de get_geo_list
id_country int — Identificador del país (obtenido con comando get_id_country)
id_city int — Identificador de la ciudad (obtenido con comando get_id_city)
eid int — Identificador del equipo
add_to_black_list int — Agregar equipo usado a lista negra para que no te salga al cambiar. ¿Para qué sirve?: 1/0
check_after_change bool — Si este parámetro se establece en true, la solicitud, después del cambio de equipo, solicitará una nueva dirección IP en el nuevo dispositivo y la devolverá en la respuesta
check_spam bool — Si se especifica el parámetro check_spam=true, se verificará la dirección IP del proxy proporcionada en la base de datos de direcciones de spam de IPGuardian.net.: true
Respuesta JSON
{
  "status": "ok",
  "message": { ... },
  "error": { ... },
  "checked": { ... },
  "ipguardian.net": { ... }
}

GET Generar browser fingerprint

Solicitud Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=fingerprint_generate&proxy_id={proxy_id}{&os=windows}{&seed={seed}}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Parámetros de la solicitud
proxy_id int — ID de tu proxy activo (prioridad). Se verifica la pertenencia a la cuenta. Si se especifica, el servidor detecta automáticamente la IP y el país a través de tu proxy
proxy varchar — Proxy arbitrario si no se especifica proxy_id. Formatos: host:port:login:pass, login:pass:host:port, login:pass@host:port, host:port
os varchar — Sistema operativo del perfil: windows | macos | android | ios (por defecto: windows)
seed varchar — Cadena opcional para la reproducibilidad del perfil. Los mismos ip + country + os + seed devuelven el mismo perfil
Respuesta JSON
{
  "status": "ok",
  "score": 95,
  "profile": {
    "os": "windows",
    "browser": "Chrome 131",
    "geo": { "country_iso": "DE", "locale": "de-DE", "ip": "..." },
    "navigator": { "userAgent": "...", "platform": "Win32", "language": "de-DE", "accept_language": "de-DE,de;q=0.9,en;q=0.8", "hardwareConcurrency": 8, "deviceMemory": 8, ... },
    "screen": { "width": 1920, "height": 1080, "colorDepth": 24, "pixelRatio": 1, ... },
    "timezone": { "name": "Europe/Berlin", "offset": -60 },
    "webgl": { "vendor": "Google Inc.", "renderer": "ANGLE (Intel, ...)" },
    "canvas": { "noiseSeed": "..." },
    "audio": { "contextHash": "..." },
    "fonts": [ "Arial", "Calibri", ... ]
  }
}
Errores posibles
proxy_or_proxy_id_required — no se proporcionó ni proxy_id ni proxy
proxy_not_found — proxy_id no pertenece a la cuenta o el proxy no está activo
proxy_invalid — no se pudo analizar la cadena proxy
proxy_connect_failed — el servidor no pudo conectarse a través del proxy (ver details en la respuesta)

GET Compra de proxy

Solicitud Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=buyproxy&operator={operator}&geoid={geoid}&proxy_id={proxy_id}&period={period}&num={num}&type={type}&coupons_code={coupons_code}&id_country={id_country}&id_city={id_city}&auto_renewal={auto_renewal}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Parámetros de la solicitud
operator varchar — ID del operador (opcional), obtenido de get_operators_list
geoid int — ID de GEO (opcional), obtenido de get_geo_list
proxy_id int, int list — ID del proxy, para extender uno o varios separados por coma
period int — Periodo para comprar/extender (default 30). Valores: 1,7,30,90,365
num int — Cantidad de proxies para compra (default 1)
type int — Tipo de proxy: 0 — móvil, 1 — servidor, 2 — backconnect (por defecto 0): 0/1/2
coupons_code varchar — Cupón (si disponible)
id_country int — Identificador del país (obtenido con comando get_id_country)
id_city int — Identificador de la ciudad (obtenido con comando get_id_city)
amount_only bool — Si pasas este parámetro, te devolverá la suma que se debitará del balance al comprar, la compra en sí no se realizará
auto_renewal int — Auto-renovación. 1-activa, 0-desactiva. Default 1-activa: 1/0
Respuesta JSON
{
  "status": "ok",
  "proxy_id": [123, 124],
  "amount": 700.00,
  "message": "...",
  "proxy_data": [ ... ]
}

GET Obtener balance de cuenta

Solicitud Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=get_balance' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Respuesta JSON
{
  "status": "ok",
  "balance": 1500.00
}

GET Cambiar configuraciones de proxy existente

Solicitud Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=edit_proxy&proxy_id={proxy_id}&proxy_reboot_time={proxy_reboot_time}&proxy_ipauth={proxy_ipauth}&proxy_comment={proxy_comment}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Parámetros de la solicitud
proxy_id int, int list , *obligatorio — ID de proxy, para cambiar varios usa coma: 1,2,3,4
proxy_reboot_time int — Tiempo de cambio de IP por timer en minutos, 0 para desactivar
proxy_ipauth ip list — Lista de IP permitidos para autenticación sin login/contraseña, IPv4 separados por coma; -1 para desactivar
proxy_auto_renewal int — Auto-renovación. 1-activa, 0-desactiva. Default 1-activa: 1/0
proxy_auto_change_equipment int — Configuración de cambio automático de equipo: 0-desactivado, 1-sin restricción, 2-país, 3-región, 4-ciudad: 0,1,2,3,4
proxy_comment varchar(255) — Text proxy comment
Respuesta JSON
{
  "status": "ok",
  "proxy_id": [123, 124],
  "message": ""
}

GET Estadísticas IP móviles por GEO al 10 agosto 2026 01:52

Solicitud Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=get_ipstat' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Respuesta JSON
{
  "status": "ok",
  "ipstat": [ ... ]
}

POST Obtener contenido de página desde diferentes IP

Este comando permite ver el contenido de página usando diferentes GEO, el comando crea una tarea para verificar la página desde los países indicados. Si no se especifican identificadores de países, la página será solicitada desde todos los países disponibles. En respuesta recibirás el identificador de la tarea y después de finalizar la ejecución podrás obtener el contenido de la página por este identificador.

Solicitud Curl
curl --request POST \
  --url 'https://mpsapi.com/api.html?command=see_the_url_from_different_IPs' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}' \
  --data 'url={url}&id_country={id_country}'
Parámetros de la solicitud
url url , *obligatorio — Dirección de página para verificación: https://mobileproxy.space
id_country int, int list — Lista de identificadores de países separados por comas (obtenido con comando get_id_country): 1,2,3,4
Respuesta JSON
{
  "status": "ok",
  "message": "...",
  "tasks_id": 123,
  "task_check_url": "https://...",
  "approximate_end_time": "..."
}

GET Obtener resultado de ejecución de tarea

Solicitud Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=tasks&tasks_id={tasks_id}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Parámetros de la solicitud
tasks_id int — Identificador de la tarea creada, obtenido al crearla, si no se especifica devolverá todas las tareas del usuario
Respuesta JSON
{
  "status": "ok",
  "tasks": {
    "tasks_id": 123,
    "tasks_start_time": "...",
    "tasks_end_time": "...",
    "tasks_status": 1,
    "tasks_result": "..."
  }
}

GET Ver ocupación de equipo

Puedes saber si un equipo está disponible para renta

Solicitud Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=eid_avaliable&eid={eid}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Parámetros de la solicitud
eid int, int list , *obligatorio — ID de equipo, puedes listar varios separados por coma: 1,2,3,4
Respuesta JSON
{
  "status": "ok",
  "eid": {
    "123": 1, (1 = free, 0 = busy)
    "124": 0
  }
}

GET Obtener historial de movimientos de fondos

Solicitud Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=get_history&start=0&length=50' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Respuesta JSON
{
  "status": "ok",
  "history": [ ... ]
}

GET Planes de proxies residenciales

Solicitud Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=residential_plans' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Respuesta JSON
[
  {
    "price_id": "3",
    "traffic_gb": "10",
    "traffic_mb": "10240",
    "sum": "1800",
    "period_days": "30"
  },
  ...
]

GET Países residenciales

Solicitud Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=residential_countries' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Respuesta JSON
[
  { "code": "US", "title": "United States", "title_ru": "США" },
  ...
]

GET Ubicaciones: regiones, ciudades, ASN

Solicitud Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=residential_locations&type={regions|cities|asns}&country={country}{®ion={region}}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Parámetros de la solicitud
type string — tipo de lista: regions, cities o asns
country string — código de país ISO2, p. ej. US
region string — código de región, obligatorio para type=cities
Respuesta JSON
[
  { "id": 1455, "code": "georgia", "title_ru": "Джорджия" },
  ...
]

GET Consumo de tráfico por día

Solicitud Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=residential_traffic&proxy_id={proxy_id}{&days={days}}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Parámetros de la solicitud
proxy_id int
days int — periodo en días, 1-365 (por defecto 30)
Respuesta JSON
[
  { "date": "2026-07-30", "delta_mb": "125.40" },
  ...
]

GET Comprar proxies residenciales

Solicitud Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=residential_buy&price_id={price_id}{&num={num}}{&country={country}}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Parámetros de la solicitud
price_id int — ID del plan de residential_plans
num int — multiplicador del plan, 1-100
country string — código de país ISO2, p. ej. US
Respuesta JSON
{
  "status": "ok",
  "proxy_id": [ 526059 ],
  "amount": "270",
  "traffic_mb": "1024",
  "message": "Residential proxy purchased"
}

GET Añadir tráfico

Solicitud Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=residential_add_traffic&proxy_id={proxy_id}&price_id={price_id}{&num={num}}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Parámetros de la solicitud
proxy_id int
price_id int — ID del plan de residential_plans
num int — multiplicador del plan, 1-100
Respuesta JSON
{
  "status": "ok",
  "proxy_id": "525819",
  "amount": "270",
  "traffic_added_mb": "1024",
  "message": "Traffic added"
}

GET Ajustes de conexión (geo y sesión)

Solicitud Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=residential_settings&proxy_id={proxy_id}{&country={country}}{&state={state}}{&city={city}}{&asn={asn}}{&session_mode={rotating|sticky}}{&session_time={minutes}}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Parámetros de la solicitud
proxy_id int — sin parámetros — leer ajustes actuales, con parámetros — guardar
country, state, city, asn string — residential_locations
session_mode string — rotating / sticky
session_time int — 1-120
Respuesta JSON
{
  "status": "ok",
  "proxy_id": "525819",
  "country": "us",
  "state": "georgia",
  "session_mode": "rotating",
  "http": "http://login-zone-custom-region-us-st-georgia:pass@residential.mobileproxy.space:2333",
  "socks5": "socks5://login-zone-custom-region-us-st-georgia:pass@residential.mobileproxy.space:2333"
}