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://mobileproxy.space/api.html?command=get_my_proxy' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
$ch = curl_init('https://mobileproxy.space/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://mobileproxy.space/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.

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://mobileproxy.space/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}' \
  --header 'User-Agent: {user-Agent-Name-Here}'
Parámetros de la solicitud
proxy_key varchar(32) , *obligatorio — Clave proxy, está en link para cambiar IP en sección Mis proxies
User-Agent varchar(255) , *obligatorio — User-Agent no bot
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://mobileproxy.space/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://mobileproxy.space/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://mobileproxy.space/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://mobileproxy.space/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://mobileproxy.space/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://mobileproxy.space/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://mobileproxy.space/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://mobileproxy.space/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://mobileproxy.space/api.html?command=get_geo_operator_list{&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
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
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
show_count_null bool — Show null count, default false
Respuesta JSON
{
  "status": "ok",
  "geo_operator_list": {
    "10": {
      "geoid": 10,
      "geo_caption": "Moscow",
      "id_city": 1,
      "id_country": 1,
      "count_free": {
        "MTS": 15,
        "Beeline": 8
      }
    },
    ...
  }
}

GET Obtener lista de operadores

Solicitud Curl
curl --request GET \
  --url 'https://mobileproxy.space/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://mobileproxy.space/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://mobileproxy.space/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://mobileproxy.space/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://mobileproxy.space/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 Compra de proxy

Solicitud Curl
curl --request GET \
  --url 'https://mobileproxy.space/api.html?command=buyproxy&operator={operator}&geoid={geoid}&proxy_id={proxy_id}&period={period}&num={num}&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)
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://mobileproxy.space/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://mobileproxy.space/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 abril 2026 15:41

Solicitud Curl
curl --request GET \
  --url 'https://mobileproxy.space/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://mobileproxy.space/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://mobileproxy.space/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://mobileproxy.space/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://mobileproxy.space/api.html?command=get_history&start=0&length=50' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Respuesta JSON
{
  "status": "ok",
  "history": [ ... ]
}