Documentação — API Mobile Proxy

Início rápido

Faça sua primeira requisição via proxy em menos de um minuto. Você precisa: um proxy ativo na sua conta e um token API do painel.

Registre-se em mobileproxy.space.
Compre um proxy — escolha país e operadora na página de compra.
Copie seu token API da página API estando logado.
Faça sua primeira requisição — escolha uma linguagem abaixo.

curl --request GET \
 --url 'https://mobileproxy.space/api.html?command=get_my_proxy' \
 --header 'Authorization: Bearer YOUR_API_TOKEN'

import requests
r = requests.get(
"https://mobileproxy.space/api.html",
params={"command": "get_my_proxy"},
headers={"Authorization": "Bearer YOUR_API_TOKEN"},
timeout=10,
)
print(r.json())

const res = await fetch(
"https://mobileproxy.space/api.html?command=get_my_proxy",
{ headers: { Authorization: "Bearer YOUR_API_TOKEN" } }
);
console.log(await res.json());

req, _ := http.NewRequest("GET",
"https://mobileproxy.space/api.html?command=get_my_proxy", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))

Limite de requisições: 3 req/seg × N proxies ativos. Cooldown da mesma requisição: 3 seg. HTTP 429 ao exceder.

Autenticação

Todas as chamadas API se autenticam com um Bearer token pessoal. O token está vinculado à sua conta, não a um proxy individual.

Onde obter seu token

Faça login no painel e abra API. O campo do token está no topo. Você pode rotacionar o token a qualquer momento — o antigo é revogado imediatamente.

Enviando o token

Authorization: Bearer YOUR_API_TOKEN

IP allowlist (opcional)

Para segurança extra, você pode restringir chamadas API a um único IP. Configure IP permitido na página API. Requisições de outros IPs são rejeitadas mesmo com token válido.

Autenticação do próprio proxy

Os proxies usam login/senha (padrão) ou autorização por IP. Configurado por proxy no painel. Com autorização por IP, não são enviadas credenciais na conexão.

Conceitos básicos

IPs de operadoras móveis

Cada proxy da rede é um modem 4G/5G real conectado a uma operadora móvel real (MTS, Beeline, T-Mobile, Vodafone, etc.). Os sites alvo veem o tráfego como vindo de um smartphone normal em rede celular — não de um datacenter.

CGNAT — por que IPs móveis são «compartilhados»

Operadoras móveis roteiam milhares de assinantes pelo mesmo IP público via Carrier-Grade NAT. Banir um único IP bloquearia clientes reais, então sistemas antifraude tratam IPs móveis com mais leniência que IPs residenciais ou de datacenter. Essa é a razão estrutural do alto nível de confiança dos proxies móveis.

Rotação

Você muda o IP externo sob demanda acionando uma reconexão do modem:

Por link — requisição GET para uma URL única (changeip.host/?proxy_key=…) dispara a rotação. Retorna o novo IP em JSON.
Por timer — rotação automática a cada N minutos (configurável por proxy).
Sem rotação (sticky) — IP mantido até você solicitar.

Sessões sticky

Uma sessão «sticky» é simplesmente um proxy com rotação desativada (ou timer longo). Todas as requisições por esse proxy compartilham um IP durante a sessão. Útil para fluxos multi-etapas (login → carrinho → pagamento, parsing de várias páginas de uma sessão).

Persistência de sessão entre rotações

Cookies, localStorage e sessões TLS vivem no cliente — não no proxy. Após uma rotação, sua sessão existente no navegador/biblioteca sobrevive; apenas o source IP muda.

Integrações

Snippets prontos para os stacks mais comuns. Substitua PROXY_HOST, PROXY_PORT, LOGIN, PASSWORD pelos valores de get_my_proxy.

import requests
proxy = "http://LOGIN:PASSWORD@PROXY_HOST:PROXY_PORT"
r = requests.get("https://httpbin.org/ip",
 proxies={"http": proxy, "https": proxy},
 timeout=15)
print(r.json())

import { HttpsProxyAgent } from "https-proxy-agent";
const agent = new HttpsProxyAgent("http://LOGIN:PASSWORD@PROXY_HOST:PROXY_PORT");
const res = await fetch("https://httpbin.org/ip", { agent });
console.log(await res.json());

proxyURL, _ := url.Parse("http://LOGIN:PASSWORD@PROXY_HOST:PROXY_PORT")
client := &http.Client{Transport: &http.Transport{Proxy: http.ProxyURL(proxyURL)}}
resp, _ := client.Get("https://httpbin.org/ip")
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))

curl -x http://LOGIN:PASSWORD@PROXY_HOST:PROXY_PORT https://httpbin.org/ip
# SOCKS5
curl --socks5 LOGIN:PASSWORD@PROXY_HOST:SOCKS_PORT https://httpbin.org/ip

import { chromium } from "playwright";
const browser = await chromium.launch({
proxy: {
server: "http://PROXY_HOST:PROXY_PORT",
username: "LOGIN",
password: "PASSWORD",
},
});
const page = await browser.newPage();
await page.goto("https://httpbin.org/ip");
console.log(await page.content());
await browser.close();

from seleniumwire import webdriver
opts = {"proxy": {
"http": "http://LOGIN:PASSWORD@PROXY_HOST:PROXY_PORT",
"https": "http://LOGIN:PASSWORD@PROXY_HOST:PROXY_PORT",
"no_proxy": "localhost,127.0.0.1",
}}
driver = webdriver.Chrome(seleniumwire_options=opts)
driver.get("https://httpbin.org/ip")
print(driver.page_source)
driver.quit()

SDKs oficiais e exemplos completos no GitHub: Python · Node · PHP · Especificação OpenAPI.

Casos de uso

O que desenvolvedores realmente constroem com proxies móveis. Cada cartão é um padrão típico.

Web scraping

Rotação de IP por requisição ou por sessão, combinada com ferramentas de fingerprinting do navegador.

Automação de navegador

Playwright / Selenium com um proxy por worker, sessões sticky para fluxos com estado.

Verificação e QA

Verificação de conteúdo geo-segmentado, preços, variantes A/B de redes de operadoras reais.

Verificação de SERP/anúncios

Scraping de SERP, verificação de posicionamento de anúncios, verificações de criativos móveis.

SMM e multi-conta

Um proxy móvel por conta — o perfil IP carrier-grade mais se parece com um usuário real.

Pipelines de dados

Workers em background atrás de um pool rotativo, retries em rotação, logging estruturado de erros.

Referência API

A referência REST completa — cada endpoint, parâmetro e formato de resposta — vive na página API dedicada. Personaliza-se automaticamente com seu token quando logado.

Documentação REST API completa

~15 endpoints: gerenciamento de proxies, rotação de IP, blacklists, busca geo/operadora, saldo.

Abrir Referência API

Endpoints mais usados

GET /api.html?command=get_my_proxy
GET CHANGEIP_HOST/?proxy_key=…
GET /api.html?command=proxy_ip&proxy_id=…
GET /api.html?command=change_equipment&…
GET /api.html?command=get_geo_operator_list

Solução de problemas

Top problemas que desenvolvedores enfrentam, com a solução padrão. FAQ completo na página FAQ.

Conexão expira / recusada

Verifique se o proxy está ativo no painel, se o IP allowlist corresponde ao IP de saída da sua máquina, e se você está usando a porta certa para HTTP vs SOCKS5.

Rotação retorna o mesmo IP

A operadora pode reatribuir o mesmo endereço — normal em pools pequenos. Acione a rotação novamente ou troque de operadora com change_equipment.

Site alvo mostra captcha

Captchas se correlacionam com o fingerprint, não apenas com o IP. Combine o IP móvel com User-Agent móvel, viewport móvel e perfil TLS consistente. Veja Gerador de fingerprint.

Sessão expira inesperadamente

Auto-rotação está disparando no meio da sua sessão. Desative a rotação por timer ou capture cookies/tokens antes de rotacionar.

Geo não corresponde / país errado

Operadoras móveis ocasionalmente roteiam por hops estrangeiros. Verifique com proxy_ip e reroteie via change_equipment se necessário.

HTTP 429 da API

Você atingiu o limite. Adicione exponential backoff, cacheie respostas de get_my_proxy, envie listas de proxy_id em lote onde suportado.

Melhores práticas

Estratégia de retry

Envolva cada requisição de proxy em retry-with-jitter (3 tentativas, 500ms–3s). Em 429, backoff exponencial. Em erros de conexão, rotação antes de tentar novamente.

Gerenciamento de sessões

Um proxy por sessão lógica. Persista cookies/localStorage por worker. Nunca compartilhe um pool HTTP keep-alive entre rotações.

Intervalos de rotação

Para scraping — rotacione por requisição ou a cada 30–120 seg. Para trabalho com contas — sessões sticky longas (horas), rotacione apenas em logout/erro explícito.

Consistência do navegador

Combine User-Agent com a operadora (4G → UA móvel). Defina timezone e locale para a região do proxy. Desative vazamento de IP por WebRTC.

Evitar bans

Mantenha a taxa de requisições em níveis humanos. Aleatorize o timing. Combine IP móvel com fingerprint móvel — não desktop.

Observabilidade

Logue proxy_id, IP atual, código de resposta e eventos de rotação juntos. Quando algo quebra, você saberá se foi o IP, o fingerprint ou o alvo.

Documentação para Desenvolvedores