API Documentation

API

Sumário do artigo

Limites de uso da API

  • Requisições idênticas podem ser enviadas no máximo uma vez a cada 5 segundos. Ao exceder o limite, o servidor retorna o erro: "Too many lonely requests. Timeout 5 second"
  • Os métodos da API podem ser chamados, no máximo, 3 × (número de proxies ativos comprados) vezes por segundo. Ao exceder o limite, o servidor retorna: "Too many requests per second". (Com 10 proxies, o limite é 30 requisições por segundo; com 100 proxies, 300 por segundo...)

SDK

PHP SDK
Node SDK
Python SDK
OpenAPI Spec

Quick Start

Esta requisição permite saber qual endereço IP o seu proxy está entregando no 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 Obter o endereço IP do seu proxy

Esta requisição permite saber qual endereço IP o seu proxy está entregando no momento

Requisição 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 da requisição
proxy_id int, int list , *obrigatório — Identificador do proxy; para obter vários proxies, separe-os por vírgulas, por exemplo: 1,2,3,4
check_spam bool — Se o parâmetro check_spam=true for indicado, o endereço IP entregue pelo proxy será verificado na base de endereços de spam IPGuardian.net: true
Resposta JSON
{
  "status": "ok",
  "ip": "123.45.67.89",
  "ipguardian.net": { ... }
}

GET Trocar o endereço IP do proxy

Esta requisição não exige cabeçalho de autorização: basta acessar o link de troca de IP a partir do navegador; em caso de chamada por programa, é obrigatório indicar o User-agent do navegador. O link está disponível na tabela Meus proxies, na coluna "Trocar IP". Este comando não está sujeito ao limite da API de 3 requisições por segundo.

Requisição cURL
curl --request GET \
  --url 'https://changeip.mobileproxy.space/?proxy_key={proxy_key}&format={format}' \
  --header 'User-Agent: {user-Agent-Name-Here}'
Parâmetros da requisição
proxy_key varchar(32) , *obrigatório — Chave do proxy, contida no link de troca de IP na seção Meus proxies
User-Agent varchar(255) , *obrigatório — User-Agent que não seja de bot
format string — Formato da resposta: json ou 0
Resposta JSON
{
  "status": "ok",
  "code": 0,
  "new_ip": "1.2.3.4",
  "rt": 1234,
  "message": "...",
  "proxy_id": 123
}

GET Obter os preços

Requisição 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 da requisição
id_country int, int list — ID do país (obtido via comando get_id_country): 1,2,3,4
currency string — usd, rub (default rub)
Resposta JSON
{
  "status": "ok",
  "price": [
    {
      "id_country": 1,
      "iso": "RU",
      "amount": 700,
      "country_name": "..",
      "period": 30
    },
    ...
  ]
}

GET Obter a lista negra de equipamentos e operadoras

Requisição 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 da requisição
proxy_id int, int list — Identificador do proxy; para obter vários proxies, separe-os por vírgulas, por exemplo: 1,2,3,4
Resposta 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 Adicionar operadora à lista negra

Requisição 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 da requisição
proxy_id int — Identificador do proxy
operator_id int , *obrigatório — Identificador da operadora
Resposta JSON
{ "status": "ok" }

GET Remover operadora da lista negra

Requisição 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 da requisição
proxy_id int, int list — Identificador do proxy; para alterar vários proxies, separe-os por vírgulas, por exemplo: 1,2,3,4
operator_id int , *obrigatório — Identificador da operadora

Se nenhum parâmetro for indicado, toda a lista será limpa

Resposta JSON
{ "status": "ok" }

GET Remover entradas da lista negra de equipamentos

Requisição 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 da requisição
proxy_id int, int list — Identificador do proxy; para alterar vários proxies, separe-os por vírgulas, por exemplo: 1,2,3,4
black_list_id int — ID do registro
eid int — ID do equipamento

Se nenhum parâmetro for indicado, toda a lista será limpa

Resposta JSON
{ "status": "ok" }

GET Obter a lista dos seus proxies ativos

Requisição 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 da requisição
proxy_id int, int list — Identificador do proxy; para obter vários proxies, separe-os por vírgulas, por exemplo: 1,2,3,4
Resposta 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 Alterar login e senha do proxy

Requisição 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 da requisição
proxy_id int, int list , *obrigatório — Identificador do proxy
proxy_login text , *obrigatório — Login (apenas números e letras latinas), se não especificado, será gerado automaticamente
proxy_pass text , *obrigatório — Senha (apenas números e letras latinas), se não especificado, será gerado automaticamente
Resposta JSON
{
  "status": "ok",
  "proxy_id": 123,
  "proxy_login": "new",
  "proxy_pass": "pass"
}

GET Reiniciar o proxy

Requisição 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 da requisição
proxy_id int , *obrigatório — Identificador do proxy
Resposta JSON
{
  "status": "ok",
  "message": "..."
}

GET Obter apenas equipamento disponível, agrupado por GEO e operadora

Requisição 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 da requisição
equipments_back_list isset — Excluir da lista o conteúdo da lista negra de equipamentos
operators_back_list isset — Excluir da lista o conteúdo da lista negra de operadoras
proxy_id int — Identificador do proxy; quando indicado, a resposta listará os servidores para os quais é possível trocar o GEO
show_count_null bool — Show null count, default false
Resposta 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 Obter a lista de operadoras

Requisição 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 da requisição
geoid int, int list — Identificadores de GEO; quando indicados, exibem o número de portas disponíveis das operadoras para esses GEOs. Vários identificadores podem ser separados por vírgulas: 1,2,3,4
Resposta JSON
[
  {
    "operator": "MTS",
    "id_country": 1,
    "count_free": 15
  },
  ...
]

GET Obter a 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 da requisição
only_avaliable bool — Se este parâmetro for indicado, o comando retornará apenas os países com equipamento disponível para locação, indicando a quantidade , facultativo
Resposta JSON
{
  "status": "ok",
  "id_country": { ... }
}

GET Obter a lista de cidades

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'
Resposta JSON
{
  "status": "ok",
  "id_city": { ... }
}

GET Obter a lista de GEOs disponíveis

Requisição 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 da requisição
proxy_id int — Identificador do proxy; quando indicado, a resposta listará os servidores para os quais é possível trocar o GEO
geoid int, int list — Identificadores de GEO; quando indicados, exibem o número de portas disponíveis das operadoras para esses GEOs. Vários identificadores podem ser separados por vírgulas: 1,2,3,4
Resposta JSON
[
  {
    "geoid": 10,
    "geo_caption": "Moscow",
    "count_free": 15,
    "iso": "RU",
    "id_city": 1
  },
  ...
]

GET Trocar equipamento

Requisição 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 da requisição
proxy_id int, int list , *obrigatório — Identificador do proxy; para alterar vários proxies, separe-os por vírgulas, por exemplo: 1,2,3,4
operator varchar — Identificador da operadora (opcional), proveniente da função "Obter lista de operadoras" (get_operators_list)
geoid int — Identificador do GEO (opcional), proveniente da função "Obter lista de GEOs disponíveis" (get_geo_list)
id_country int — ID do país (obtido via comando get_id_country)
id_city int — ID da cidade (obtido via comando get_id_city)
eid int — ID do equipamento
add_to_black_list int — Adicionar o equipamento utilizado à lista negra; ele não será mais oferecido em trocas. Para que serve?: 1/0
check_after_change bool — Se este parâmetro estiver definido como true, após a troca de equipamento, a requisição solicitará um novo endereço IP ao novo equipamento e o retornará na resposta
check_spam bool — Se o parâmetro check_spam=true for indicado, o endereço IP entregue pelo proxy será verificado na base de endereços de spam IPGuardian.net: true
Resposta JSON
{
  "status": "ok",
  "message": { ... },
  "error": { ... },
  "checked": { ... },
  "ipguardian.net": { ... }
}

GET Gerar browser fingerprint

Requisição cURL
curl --request GET \
  --url 'https://mobileproxy.space/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 da requisição
proxy_id int — ID do seu proxy ativo (prioridade). A pertença à conta é verificada. Se especificado, o servidor detecta automaticamente o IP e o país através do seu proxy
proxy varchar — Proxy arbitrário se proxy_id não estiver especificado. Formatos: host:port:login:pass, login:pass:host:port, login:pass@host:port, host:port
os varchar — Sistema operacional do perfil: windows | macos | android | ios (padrão: windows)
seed varchar — Cadeia opcional para reprodutibilidade do perfil. Os mesmos ip + country + os + seed retornam o mesmo perfil
Resposta 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", ... ]
  }
}
Erros possíveis
proxy_or_proxy_id_required — nem proxy_id nem proxy foram fornecidos
proxy_not_found — proxy_id não pertence à conta ou o proxy não está ativo
proxy_invalid — não foi possível analisar a string proxy
proxy_connect_failed — o servidor não conseguiu conectar através do proxy (veja details na resposta)

GET Compra de proxy

Requisição 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 da requisição
operator varchar — Identificador da operadora (opcional), proveniente da função "Obter lista de operadoras" (get_operators_list)
geoid int — Identificador do GEO (opcional), proveniente da função "Obter lista de GEOs disponíveis" (get_geo_list)
proxy_id int, int list — Identificador do proxy, indicado apenas em caso de prolongação do proxy desejado; para prolongar vários proxies, separe-os por vírgulas, por exemplo: 1,2,3,4
period int — Período de compra/prolongação do proxy (padrão 30). Valores possíveis: 1, 7, 30, 90, 365
num int — Número de proxies necessários na compra (padrão 1)
coupons_code varchar — Código do cupom, se houver
id_country int — ID do país (obtido via comando get_id_country)
id_city int — ID da cidade (obtido via comando get_id_city)
amount_only bool — Se este parâmetro for transmitido, o valor que seria debitado do saldo na compra é retornado; a compra em si não é realizada
auto_renewal int — Renovação automática. 1 — ativada, 0 — desativada. Padrão: 1 — ativada: 1/0
Resposta JSON
{
  "status": "ok",
  "proxy_id": [123, 124],
  "amount": 700.00,
  "message": "...",
  "proxy_data": [ ... ]
}

GET Obter o saldo da conta

Requisição cURL
curl --request GET \
  --url 'https://mobileproxy.space/api.html?command=get_balance' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Resposta JSON
{
  "status": "ok",
  "balance": 1500.00
}

GET Alterar parâmetros de um proxy existente

Requisição 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 da requisição
proxy_id int, int list , *obrigatório — Identificador do proxy; para alterar vários proxies, separe-os por vírgulas, por exemplo: 1,2,3,4
proxy_reboot_time int — Tempo de troca do IP no temporizador, em minutos; para cancelar, envie 0
proxy_ipauth ip list — Lista de IPs autorizados sem login/senha (IPv4 separados por vírgulas); para cancelar, envie '-1'. Listas de IPs e indicação de sub-redes são suportadas. Por exemplo: 192.168.34.76, 123.123.212.0/24
proxy_auto_renewal int — Renovação automática. 1 — ativada, 0 — desativada. Padrão: 1 — ativada: 1/0
proxy_auto_change_equipment int — Configuração da troca automática de equipamento: 0 — desativada, 1 — sem restrição, 2 — país, 3 — região/estado, 4 — cidade: 0,1,2,3,4
proxy_comment varchar(255) — Text proxy comment
Resposta JSON
{
  "status": "ok",
  "proxy_id": [123, 124],
  "message": ""
}

GET Estatísticas dos endereços IP dos proxies móveis por GEO em 18 мая 2026 01:03

Requisição cURL
curl --request GET \
  --url 'https://mobileproxy.space/api.html?command=get_ipstat' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Resposta JSON
{
  "status": "ok",
  "ipstat": [ ... ]
}

POST Obter o conteúdo de uma página a partir de diferentes IPs

Este comando permite ver o conteúdo de uma página a partir de diferentes GEOs; ele cria uma tarefa de verificação a partir dos países indicados. Se nenhum identificador de país for informado, a página será solicitada a partir de todos os países disponíveis. Em resposta, você receberá o ID da tarefa e, após sua execução, poderá obter o conteúdo da página por esse ID.

Requisição 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 da requisição
url url , *obrigatório — Endereço da página a verificar: https://mobileproxy.space
id_country int, int list — Lista de IDs de país separados por vírgulas (obtida via comando get_id_country): 1,2,3,4
Resposta JSON
{
  "status": "ok",
  "message": "...",
  "tasks_id": 123,
  "task_check_url": "https://...",
  "approximate_end_time": "..."
}

GET Obter o resultado da execução da tarefa

Requisição 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 da requisição
tasks_id int — ID da tarefa obtido na criação; se não for informado, todas as tarefas do usuário serão retornadas
Resposta JSON
{
  "status": "ok",
  "tasks": {
    "tasks_id": 123,
    "tasks_start_time": "...",
    "tasks_end_time": "...",
    "tasks_status": 1,
    "tasks_result": "..."
  }
}

GET Verificar a disponibilidade de um equipamento

Você pode verificar se um equipamento específico está disponível para locação

Requisição 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 da requisição
eid int, int list , *obrigatório — Identificador do equipamento; você pode indicar vários separados por vírgulas, por exemplo: 1,2,3,4
Resposta JSON
{
  "status": "ok",
  "eid": {
    "123": 1, (1 = free, 0 = busy)
    "124": 0
  }
}

GET Obter o histórico de movimentações de fundos

Requisição 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}'
Resposta JSON
{
  "status": "ok",
  "history": [ ... ]
}