For the complete documentation index, see llms.txt. This page is also available as Markdown.

Configurações de localização

Saiba mais sobre as configurações de localização para Residential Proxies. Aqui você encontrará guias de segmentação por localização, de continentes a cidades específicas e coordenadas.

Oxylabs Residential Proxies abrangem mais de 195 locais no mundo todo, permitindo roteamento granular de tráfego até país, cidade, estado, continente, código ZIP, ASN, ou coordenada níveis. Os parâmetros de localização são adicionados diretamente à sua string de proxy username string ou passados via cabeçalhos personalizados.

Mapeamento de localização: Usamos o MaxMind GeoIP2 banco de dados para atribuir nossos nós de saída cc, st, e cidade valores. Este banco de dados é atualizado semanalmente.

Alguns outros bancos de dados públicos de IP podem mostrar locais diferentes. Nos casos em que não pode haver nenhuma discrepância de localização, verifique novamente se a localização do proxy atribuído é a mesma no banco de dados de IP usado pelo site de destino.

Segmentação
Parâmetro
Descrição

País

cc

Código ISO 3166-1 alpha-2. Suporta portas de entrada específicas por país. Ex. customer-USERNAME-cc-US

Cidade

cidade

Nome da cidade em inglês. Requer cc o parâmetro para máxima precisão. Ex. customer-USERNAME-cc-US-city-new_york

Estado

st

Apenas estados dos EUA. Requer us_ o prefixo. Ex. customer-USERNAME-st-us_california

Continente

cn

Código de continente de duas letras (AF, AN, AS, EU, NA, OC, SA). Ex. customer-USERNAME-cn-EU

CEP / código postal

postalcode

Apenas códigos ZIP de 5 dígitos dos EUA. Requer cc-US. Ex. customer-USERNAME-cc-US-postalcode-90210

Geo hash

geohash

Níveis das células da grade de 1 a 4 (9 a drq4). Mutuamente exclusivo com outros parâmetros geográficos. Ex. customer-USERNAME-geohash-u09

Segmentação por ASN

ASN

Direcione números de Sistema Autônomo específicos. Substituído se cc estiver presente. Ex. customer-USERNAME-ASN-21928

Coordenadas

X-Oxylabs-Geolocation

Transmitido como um cabeçalho de proxy HTTP. Raio mínimo de 10 milhas. Ex. Latitude:Longitude;Radius


País

Adicionar o cc parâmetro ao cabeçalho de autorização especifica o país de destino usando um ISO de 2 letras no formato 3166-1 alpha-2 código do país (por exemplo, DE para a Alemanha, GB para o Reino Unido, JP para o Japão):

customer-USERNAME-cc-DE:PASSWORD

Exemplos de código

curl -x pr.oxylabs.io:7777 -U "customer-USERNAME-cc-DE:PASSWORD" https://ip.oxylabs.io/location
import urllib.request

username = 'USERNAME'
password = 'PASSWORD'
country = 'DE'
entry = f'http://customer-{username}-cc-{country}:{password}@pr.oxylabs.io:7777'

query = urllib.request.ProxyHandler({'http': entry, 'https': entry})
execute = urllib.request.build_opener(query)
print(execute.open('https://ip.oxylabs.io/location').read().decode('utf-8'))
<?php
$username = 'USERNAME';
$password = 'PASSWORD';
$country = 'DE';
$proxy = 'pr.oxylabs.io:7777';
$query = curl_init('https://ip.oxylabs.io/location');
curl_setopt($query, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($query, CURLOPT_PROXY, "http://$proxy");
curl_setopt($query, CURLOPT_PROXYUSERPWD, "customer-$username-cc-$country:$password");
$output = curl_exec($query);
curl_close($query);
if ($output)
    echo $output;
?>

Nós de entrada específicos por país

Como alternativa, conecte-se diretamente aos pontos de entrada de domínio específicos por país sem modificar seus parâmetros de nome de usuário. A seguinte consulta de exemplo para ip.oxylabs.io/location é executada a partir de um IP turco aleatório:

Consulte o painel para informações sobre o ponto de entrada. Baixe uma lista completa de pontos de entrada aleatórios ou encontre-os na tabela abaixo.

Tabela de nós de entrada disponíveis

Aleatório pr.oxylabs.io:7777

EUA us-pr.oxylabs.io:10000

Canadá ca-pr.oxylabs.io:30000

Grã-Bretanha gb-pr.oxylabs.io:20000

Alemanha de-pr.oxylabs.io:30000

França fr-pr.oxylabs.io:40000

Espanha es-pr.oxylabs.io:10000

Itália it-pr.oxylabs.io:20000

Suécia se-pr.oxylabs.io:30000

Grécia gr-pr.oxylabs.io:40000

Portugal pt-pr.oxylabs.io:10000

Países Baixos nl-pr.oxylabs.io:20000

Bélgica be-pr.oxylabs.io:30000

Rússia ru-pr.oxylabs.io:40000

Ucrânia ua-pr.oxylabs.io:10000

Polônia pl-pr.oxylabs.io:20000

Israel il-pr.oxylabs.io:20000

Turquia tr-pr.oxylabs.io:30000

Austrália au-pr.oxylabs.io:40000

Malásia my-pr.oxylabs.io:10000

Tailândia th-pr.oxylabs.io:20000

Coreia do Sul kr-pr.oxylabs.io:30000

Japão jp-pr.oxylabs.io:40000

Filipinas ph-pr.oxylabs.io:10000

Singapura sg-pr.oxylabs.io:20000

China cn-pr.oxylabs.io:30000

Hong Kong hk-pr.oxylabs.io:40000

Taiwan tw-pr.oxylabs.io:10000

Índia in-pr.oxylabs.io:20000

Paquistão pk-pr.oxylabs.io:30000

Irã ir-pr.oxylabs.io:40000

Indonésia id-pr.oxylabs.io:10000

Azerbaijão az-pr.oxylabs.io:20000

Cazaquistão kz-pr.oxylabs.io:30000

EAU ae-pr.oxylabs.io:40000

México mx-pr.oxylabs.io:10000

Brasil br-pr.oxylabs.io:20000

Argentina ar-pr.oxylabs.io:30000

Chile cl-pr.oxylabs.io:40000

Peru pe-pr.oxylabs.io:10000

Equador ec-pr.oxylabs.io:20000

Colômbia co-pr.oxylabs.io:30000

​​África do Sul za-pr.oxylabs.io:40000

Egito eg-pr.oxylabs.io:10000

Angola ao-pr.oxylabs.io:40000

Camarões cm-pr.oxylabs.io:41000

República Centro-Africana cf-pr.oxylabs.io:42000

Chade td-pr.oxylabs.io:43000

Benim bj-pr.oxylabs.io:44000

Etiópia et-pr.oxylabs.io:45000

Djibuti dj-pr.oxylabs.io:46000

Gâmbia gm-pr.oxylabs.io:47000

Gana gh-pr.oxylabs.io:48000

Costa do Marfim ci-pr.oxylabs.io:49000

Quênia ke-pr.oxylabs.io:10000

Libéria lr-pr.oxylabs.io:11000

Madagascar mg-pr.oxylabs.io:12000

Mali ml-pr.oxylabs.io:13000

Mauritânia mr-pr.oxylabs.io:14000

Maurício mu-pr.oxylabs.io:15000

Marrocos ma-pr.oxylabs.io:16000

Moçambique mz-pr.oxylabs.io:17000

Nigéria ng-pr.oxylabs.io:18000

Senegal sn-pr.oxylabs.io:19000

Seicheles sc-pr.oxylabs.io:20000

Zimbábue zw-pr.oxylabs.io:21000

Sudão do Sul ss-pr.oxylabs.io:22000

Sudão sd-pr.oxylabs.io:23000

Togo tg-pr.oxylabs.io:24000

Tunísia tn-pr.oxylabs.io:25000

Uganda ug-pr.oxylabs.io:26000

Zâmbia zm-pr.oxylabs.io:27000

Afeganistão af-pr.oxylabs.io:28000

Bahrein bh-pr.oxylabs.io:29000

Bangladesh bd-pr.oxylabs.io:30000

Armênia am-pr.oxylabs.io:31000

Butão bt-pr.oxylabs.io:32000

Mianmar mm_pr.oxylabs.io:33000

Camboja kh-pr.oxylabs.io:34000

Geórgia ge-pr.oxylabs.io:36000

Iraque iq-pr.oxylabs.io:37000

Jordânia jo-pr.oxylabs.io:38000

Líbano lb-pr.oxylabs.io:39000

Maldivas mv-pr.oxylabs.io:40000

Mongólia mn-pr.oxylabs.io:41000

Omã om-pr.oxylabs.io:42000

Catar

qa-pr.oxylabs.io:43000

Arábia Saudita sa-pr.oxylabs.io:44000

Vietnã vn-pr.oxylabs.io:45000

Turcomenistão tm-pr.oxylabs.io:46000

Uzbequistão uz-pr.oxylabs.io:47000

Iêmen ye-pr.oxylabs.io:48000

Albânia

al-pr.oxylabs.io:49000

Andorra ad-pr.oxylabs.io:10000

Áustria at-pr.oxylabs.io:11000

Bósnia e Herzegovina ba-pr.oxylabs.io:13000

Bulgária bg-pr.oxylabs.io:14000

Belarus by-pr.oxylabs.io:15000

Croácia hr-pr.oxylabs.io:16000

Chipre cy-pr.oxylabs.io:35000

República Tcheca

cz-pr.oxylabs.io:18000

Dinamarca dk-pr.oxylabs.io:19000

Estônia ee-pr.oxylabs.io:20000

Finlândia fi-pr.oxylabs.io:21000

Hungria hu-pr.oxylabs.io:23000

Islândia is-pr.oxylabs.io:24000

Irlanda ie-pr.oxylabs.io:25000

Letônia lv-pr.oxylabs.io:26000

Liechtenstein li-pr.oxylabs.io:27000

Lituânia lt-pr.oxylabs.io:28000

Luxemburgo lu-pr.oxylabs.io:29000

Malta mt-pr.oxylabs.io:30000

Mônaco mc-pr.oxylabs.io:31000

Moldávia md-pr.oxylabs.io:32000

Montenegro me-pr.oxylabs.io:33000

Noruega no-pr.oxylabs.io:34000

Romênia ro-pr.oxylabs.io:35000

Sérvia rs-pr.oxylabs.io:36000

Eslováquia sk-pr.oxylabs.io:37000

Eslovênia si-pr.oxylabs.io:38000

Suíça ch-pr.oxylabs.io:39000

Macedônia

mk-pr.oxylabs.io:40000

Bahamas bs-pr.oxylabs.io:41000

Belize bz-pr.oxylabs.io:42000

Ilhas Virgens Britânicas vg-pr.oxylabs.io:43000

Costa Rica cr-pr.oxylabs.io:44000

Cuba cu-pr.oxylabs.io:45000

Dominica dm-pr.oxylabs.io:46000

Haiti ht-pr.oxylabs.io:47000

Honduras hn-pr.oxylabs.io:48000

Jamaica jm-pr.oxylabs.io:49000

Aruba aw-pr.oxylabs.io:10000

Panamá pa-pr.oxylabs.io:11000

Porto Rico pr-pr.oxylabs.io:12000

Trinidad e Tobago tt-pr.oxylabs.io:13000

Fiji fj-pr.oxylabs.io:14000

Nova Zelândia nz-pr.oxylabs.io:15000

Bolívia bo-pr.oxylabs.io:16000

Paraguai py-pr.oxylabs.io:17000

Uruguai uy-pr.oxylabs.io:18000

Venezuela ve-pr.oxylabs.io:19000

União Europeia eu-pr.oxylabs.io:10000

República Dominicana

do-pr.oxylabs.io:21000

Laos

la-pr.oxylabs.io:22000

Tanzânia

tz-pr.oxylabs.io:23000

Sri Lanka

lk-pr.oxylabs.io:24000

Brunei

bn-pr.oxylabs.io:25000

Nepal

np-pr.oxylabs.io:26000

Kuwait

kw-pr.oxylabs.io:20000

Guatemala

gt-pr.oxylabs.io:27000

Argélia dz-pr.oxylabs.io:29000

Namíbia na-pr.oxylabs.io:28000


Cidade

Direcione Proxies em cidades específicas combinando o cidade parâmetro com um código de país correspondente (cc). Nomes de cidades com várias palavras usam underscores em vez de espaços (por exemplo, new_york, rio_de_janeiro).

Exemplos de código

Baixe a lista de cidades suportadas clicando no arquivo abaixo:

Suportamos todas as cidades do mundo, mas, devido à natureza dinâmica de Residential Proxies, não garantimos que teremos Proxies lá em um momento específico. As cidades mais populares são bem cobertas.


Estado

Selecione Proxies de estados específicos dos EUA usando o st parâmetro. Os nomes dos estados devem incluir o us_ prefixo (por exemplo, us_california, us_illinois).

Exemplos de código

Neste exemplo, uma consulta para ip.oxylabs.io/location é realizada a partir de um endereço IP aleatório da Califórnia, EUA:

Veja abaixo a lista completa de estados suportados:


Continente

Encaminhe solicitações por qualquer um dos sete continentes usando o cn parâmetro seguido por um código de continente de duas letras:

cn-AF – África cn-AN – Antártica cn-AS – Ásia cn-EU – Europa cn-NA – América do Norte cn-OC – Oceania cn-SA – América do Sul

Exemplo de código


CEP / código postal

Direcione códigos ZIP de 5 dígitos específicos dos EUA usando o postalcode parâmetro. O parâmetro deve ser usado com o parâmetro de código de país cc e um código de país de 2 letras sem distinção de maiúsculas e minúsculas no formato 3166-1 alpha-2.

Atualmente, suportamos apenas códigos baseados nos EUA para direcionamento por código ZIP, o parâmetro deve ser acompanhado de cc-US.

Exemplos de código

A localização do Proxy usando código ZIP é correspondida usando MaxMind IP Geolocation banco de dados. Pode haver divergência entre códigos ZIP ao verificar endereços IP em relação a outros bancos de dados de geolocalização IP.


Geo hash

Direcione Proxies em células de grade geográficas específicas usando códigos Geohash que vão do Nível 1 (maior) ao Nível 4 (menor). O Geohash permite direcionamento preciso baseado em grade sem depender de limites administrativos tradicionais, como fronteiras de país ou cidade.

Comprimento
Tamanho aprox. da célula
Exemplos

1

≤ 5.000 km × 5.000 km

geohash-9 (grande parte dos EUA e México), geohash-c (norte dos EUA e Canadá)

2

≤ 1.250 km × 625 km

geohash-gc (Irlanda, Irlanda do Norte, Inglaterra e Escócia)

3

≤ 156 km × 156 km

geohash-u09 (Paris)

4

≤ 39,1 km × 19,5 km

geohash-drq4 (maior parte da ilha de Nantucket)

Exemplos de código


Direcionamento por ASN

Encaminhe o tráfego por redes específicas de provedores de internet (ISP) usando Números de Sistema Autônomo (ASN). Você pode encontrar números ASN aqui.

Se não houver Proxies ativos disponíveis para o ASN especificado, a solicitação retorna um 502 Bad Gateway erro.

Você pode usar o parâmetro Country ou ASN para cada solicitação. Se ambos os parâmetros de localização forem usados, apenas o parâmetro Country será aplicado.


Coordenadas

Direcione Proxies próximos a coordenadas geográficas específicas usando o X-Oxylabs-Geolocation cabeçalho do proxy HTTP. O formato do valor é Latitude:Longitude;Radius (raio em milhas, mínimo de 10 milhas).

Se nenhum IP for encontrado dentro das coordenadas e do raio fornecidos, você receberá 502 código de resposta. Veja a lista completa de códigos de resposta aqui.

Exemplo de código

Nós de entrada da China

Para solicitações iniciadas na China continental, nós de entrada regionais HTTPS dedicados fornecem conectividade otimizada.

  • Hong Kong: a81298871.com:8000

  • Beijing: cnt9t1is.com:8000

Atualizado

Isto foi útil?