Muitos desenvolvedores e especialistas técnicos, ao começar a automatizar o scraping de marketplaces ou multi-contas, compram proxies, obtêm login e senha — e param por aí. Após uma semana, descobrem que os IPs estão sendo banidos em massa, as sessões são interrompidas e a rotação acontece de forma imprevisível. O problema não está nos próprios proxies, mas no fato de que, sem os métodos corretos de API, os proxies se tornam uma caixa-preta que não pode ser gerenciada programaticamente.
Por que simplesmente "comprar proxies" não é suficiente
Quando a tarefa é acessar manualmente um site através de um proxy, basta ter o login e a senha nas configurações do navegador. Mas a automação é outra história. Se você está escrevendo um script para fazer scraping do Wildberries, Ozon ou Avito, executando multi-contas para uma agência de SMM através do Dolphin Anty ou AdsPower, ou testando anúncios no Facebook Ads e TikTok Ads de diferentes geos — você precisa que o código gerencie os proxies: mude o IP, escolha o país, mantenha a sessão pelo tempo necessário e monitore os limites de tráfego.
É aqui que entra em cena a API do provedor de proxies. Não é apenas um endpoint para obter uma lista de servidores — é um conjunto de métodos através dos quais seu script gerencia o comportamento do proxy em tempo real. Se o provedor oferece apenas uma lista estática de IPs sem API para gerenciar rotação, geotargeting e sessões, a automação se transforma em um ajuste manual constante. Vamos analisar 5 métodos sem os quais qualquer automação séria está condenada a bans e inatividade.
Método 1: Rotação de IP programática
A rotação é um mecanismo básico, mas é importante que ela seja gerenciada pelo código, e não "embutida" no painel do provedor. Uma boa API oferece pelo menos dois modos: rotação automática (o IP muda a cada nova solicitação ou a cada N minutos) e rotação sob demanda (solicitação de um novo IP através de uma chamada API separada).
Para fazer scraping do Ozon ou Wildberries, é necessária a rotação sob demanda — você envia 5-10 solicitações através de um IP, recebe um captcha ou bloqueio, e imediatamente aciona o método de rotação para obter uma nova saída sem recriar toda a sessão.
curl -x http://user-session-rotate:[email protected]:8000 https://api.ipify.org
# Mudança de IP através do parâmetro session no login
curl -x http://user-session-a1b2c3:[email protected]:8000 https://api.ipify.org
curl -x http://user-session-x9y8z7:[email protected]:8000 https://api.ipify.orgNeste exemplo, a mudança do identificador da sessão no login do proxy efetivamente substitui a chamada de um endpoint API separado — mas o provedor deve documentar esse mecanismo. Sem isso, a rotação ocorre "quando o servidor decide", e não quando seu script decide, o que é crítico para scraping com alta frequência de solicitações.
Método 2: Geotargeting por país e cidade
Para os arbitradores que testam anúncios no Facebook Ads e Google Ads de diferentes regiões, e para os profissionais de marketing que verificam a entrega local do Yandex.Direct, sem geotargeting preciso através da API, a automação não faz sentido. O método deve permitir especificar o país, e idealmente — a cidade ou até mesmo o operador de telecomunicações para proxies móveis, diretamente nos parâmetros da solicitação ou login.
import requests
proxy = {
"http": "http://user-country-de-city-berlin:[email protected]:8000",
"https": "http://user-country-de-city-berlin:[email protected]:8000"
}
response = requests.get("https://api.ipify.org?format=json", proxies=proxy)
print(response.json())Essa abordagem economiza horas na configuração — em vez de escolher manualmente o servidor no painel, o script insere automaticamente o país necessário para cada conta ou fluxo de scraping. Para tarefas que exigem precisão geográfica, geralmente são utilizados proxies residenciais — eles têm uma cobertura maior de cidades e provedores de telecomunicações do que os proxies de data center.
Método 3: Sessões fixas — gerenciamento de vinculação de IP
Para multi-contas no Instagram, TikTok e ao trabalhar com navegadores anti-detect (Dolphin Anty, GoLogin, Multilogin, Octo Browser), é crítico que a mesma conta sempre acesse através do mesmo IP durante a sessão — e às vezes até por vários dias. Isso é chamado de sessão fixa, e sem o gerenciamento de sua duração através da API, você obtém ou uma mudança de IP muito frequente (a plataforma vê "saltos" e bane) ou fica preso em um único endereço para sempre.
Uma boa API permite definir o tempo de vida da sessão — de 1 minuto a 24 horas ou mais — através de um parâmetro na string de conexão:
# A sessão dura 30 minutos
user-session-abc123-sessTime-30:[email protected]:8000
# A sessão dura 24 horas — adequada para aquecer uma conta por um longo período
user-session-abc123-sessTime-1440:[email protected]:8000Para uma agência de SMM que gerencia de 30 a 50 contas de clientes, essa é a única maneira de garantir que cada perfil no navegador anti-detect esteja vinculado ao seu IP sem sobreposições — o que é crítico para evitar bans em cadeia.
Método 4: Lista branca e autorização dinâmica
Se a automação é iniciada a partir de servidores com IPs dinâmicos (por exemplo, funções em nuvem AWS Lambda ou VPS dinâmicos), a autorização por login e senha nem sempre é conveniente — é necessário armazenar segredos no código. Parte dos provedores oferece um método de autorização por IP através da API de lista branca: você adiciona o IP atual do servidor à lista permitida com uma única chamada, sem precisar passar a senha em cada solicitação.
curl -X POST "https://api.proxycove.com/v1/whitelist" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"ip": "203.0.113.25"}'Isso é especialmente importante para automação de e-commerce, onde o script de monitoramento de preços no Wildberries ou Ozon é executado em um cronograma (cron) em um servidor com IP fixo ou rotativo — a lista branca elimina a necessidade de codificar credenciais e reduz o risco de vazamento de acesso em caso de comprometimento do código.
Método 5: Estatísticas, limites e monitoramento de tráfego
A automação sem controle do consumo de tráfego é um risco de, inesperadamente, atingir o limite no meio de um scraping ativo ou campanha publicitária. Uma API útil do provedor de proxies deve fornecer um método para obter estatísticas: quanto tráfego foi consumido, quanto resta, quantas solicitações foram feitas durante um período.
import requests
headers = {"Authorization": "Bearer YOUR_API_KEY"}
resp = requests.get("https://api.proxycove.com/v1/usage", headers=headers)
data = resp.json()
print(f"Usado: {data['used_gb']} GB")
print(f"Restante: {data['remaining_gb']} GB")Com base nesses dados, o script pode pausar automaticamente as tarefas de scraping ao se aproximar do limite ou alternar para um pool de IPs de reserva — isso evita a situação em que o monitoramento de preços de concorrentes em marketplaces para repentinamente para no meio do dia sem aviso.
Comparação de tipos de proxies para automação de API
| Tipo de proxy | Suporte a métodos de API | Melhor para |
|---|---|---|
| Proxies residenciais | Rotação, geo por cidade, sessões fixas | Scraping de marketplaces, multi-contas |
| Proxies móveis | Rotação, sessões fixas, geo por operador | Facebook Ads, TikTok Ads, Instagram |
| Proxies de data center | Lista branca, estatísticas, rotação rápida | Scraping em massa sem requisitos geográficos |
Exemplo prático de integração em Python
Abaixo está um exemplo simplificado de um script que combina vários métodos: rotação sob demanda, verificação de estatísticas de tráfego e tratamento de erro de bloqueio. Essa abordagem é frequentemente usada em scripts de monitoramento de preços no Ozon ou Wildberries.
import requests
import random
import string
def get_session_id():
return ''.join(random.choices(string.ascii_lowercase + string.digits, k=8))
def make_request(url, country="br"):
session_id = get_session_id()
proxy_url = f"http://user-country-{country}-session-{session_id}:[email protected]:8000"
proxies = {"http": proxy_url, "https": proxy_url}
try:
response = requests.get(url, proxies=proxies, timeout=10)
if response.status_code == 429 or "captcha" in response.text.lower():
print("Bloqueio detectado, mudando IP...")
return make_request(url, country)
return response
except requests.exceptions.RequestException as e:
print(f"Erro na solicitação: {e}")
return None
def check_traffic():
headers = {"Authorization": "Bearer YOUR_API_KEY"}
resp = requests.get("https://api.proxycove.com/v1/usage", headers=headers)
return resp.json()
if __name__ == "__main__":
usage = check_traffic()
if usage["remaining_gb"] < 1:
print("Tráfego quase esgotado, tarefa parada")
else:
result = make_request("https://www.wildberries.ru/catalog/some-item")
print(result.status_code if result else "Sem resposta")Neste código, três métodos dos cinco foram implementados: rotação sob demanda (geração de um novo session_id a cada chamada), geotargeting (parâmetro country) e verificação de limites de tráfego antes do início da tarefa. Adicionando sessões fixas e lista branca, obtemos uma automação totalmente gerenciável.
Erros comuns ao trabalhar com API proxy
- Ignorar timeout. Sem timeout, o script pode travar em um IP "morto" por minutos, em vez de rotacionar instantaneamente.
- Ausência de tratamento de código 407/429. Muitos esquecem de verificar códigos de erro específicos de autorização de proxy e bloqueio, tratando apenas 200 e 404.
- Rotação muito frequente para multi-contas. Se cada solicitação passa por um novo IP ao trabalhar com Instagram ou TikTok, a plataforma vê um comportamento anômalo e bane a conta mais rapidamente do que se estivesse usando um IP "caseiro".
- Hardcode de credenciais no código. Em vez de usar lista branca por IP, os desenvolvedores frequentemente embutem login e senha diretamente no repositório, o que cria um risco de vazamento em caso de comprometimento do código.
- Falta de monitoramento de limites. A tarefa de scraping para quando o tráfego se esgota no meio do dia, e só se descobre no dia seguinte pelos logs.
Conclusão
A API do provedor de proxies é útil na medida em que oferece controle sobre o comportamento do proxy no código: rotação de IP, geotargeting preciso, duração de sessões, autorização flexível através de lista branca e estatísticas transparentes de consumo de tráfego. Sem esses cinco métodos, até mesmo o maior pool de endereços IP se transforma em uma lista estática que precisará ser ajustada manualmente a cada mudança de tarefa.
Se você está automatizando o scraping de marketplaces, monitoramento de preços de concorrentes ou multi-contas para SMM e arbitragem, preste atenção se o provedor suporta esses métodos "prontos para uso". Para tarefas com altas exigências de precisão geográfica e naturalidade do tráfego, os proxies residenciais são uma boa escolha, enquanto para contas de anúncios do Facebook Ads e TikTok Ads, os proxies móveis com suporte a sessões fixas e rotação por operador são ideais.