Segmentação geográfica

O geo-targeting é configurado por requisição adicionando flags ao nome de usuário. Sem alteração no painel, sem endpoint separado, cada requisição passa pelo mesmo gateway.

Sintaxe

As flags são anexadas ao seu nome de usuário com hífens:

customer-USERNAME-country-<code>-region-<name>-city-<name>-asn-<number>

Os valores são em letras minúsculas. Nomes de região e cidade usam underscores para espaços. Os códigos de país seguem o padrão ISO 3166-1 alpha-2.

Filtros disponíveis

Flag	Valor	Exemplo
country	Código de país ISO	country-us, country-gb, country-de
region	Slug de região/estado em minúsculas	region-california, region-new_south_wales
city	Slug de cidade em minúsculas	city-new_york, city-los_angeles
asn	Número do ASN	asn-7922 (Comcast), asn-701 (Verizon)
strict	true	strict-true (veja Comportamento de fallback)

Combine flags em qualquer ordem:

customer-USERNAME-country-us-region-california-city-los_angeles
customer-USERNAME-country-gb-asn-2856
customer-USERNAME-city-berlin

Exemplos

Apenas país

curl -x customer-USERNAME-country-de-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443 \
  https://ipinfo.io/json

País + região

curl -x customer-USERNAME-country-us-region-california-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443 \
  https://ipinfo.io/json

País + cidade

curl -x customer-USERNAME-country-us-city-new_york-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443 \
  https://ipinfo.io/json

País + ASN

curl -x customer-USERNAME-country-us-asn-7922-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443 \
  https://ipinfo.io/json

Comportamento de fallback

Por padrão, se nenhum IP corresponder ao seu filtro completo no momento da requisição (por exemplo, uma cidade obscura com um pool momentaneamente vazio), o gateway recorre a um pool mais amplo para que a requisição ainda seja concluída.

Adicione strict-true para desativar o fallback e receber HTTP 502 em vez disso. Use a correspondência estrita quando uma correspondência geográfica exata for mais importante do que o sucesso da requisição:

curl -x customer-USERNAME-country-us-city-new_york-strict-true-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443 \
  https://ipinfo.io/json

Sem filtro

Omita todas as flags para obter IPs do pool global completo:

USERNAME

Cada requisição ainda alterna para um IP diferente, apenas sem restrição geográfica.

Próximos passos

• Sessões, mantenha o IP direcionado ao longo de múltiplas requisições.
• Integrações, conecte as flags de geolocalização ao Scrapy, Puppeteer, Playwright.