API de Proxies Residenciais

O produto Residential Proxies é configurado por requisição através do gateway username, não há uma API de “gerenciamento” por conta para ele. O que esta API oferece é uma forma de enumerar os seletores de geolocalização que você pode inserir no username (country, region, city, asn) para que suas ferramentas permaneçam sincronizadas com o que está realmente disponível.

Nota

Para uso em nível de protocolo, sessões sticky, correspondência estrita e a lista completa de flags, consulte Produtos → Residential Proxies e Gateway & auth.

Autenticação

Todos os endpoints autenticam com um parâmetro de query api_key. Gere uma chave no painel em Account → API Keys.

?api_key=YOUR_API_KEY

Listar países

GET https://shifter.io/api/v1/residential/geo/countries

Retorna todos os países disponíveis para o direcionamento country-<iso2> no gateway do Residential Proxies.

Parameter	In	Required	Description
api_key	query	yes	Sua chave de API

Exemplo:

curl "https://shifter.io/api/v1/residential/geo/countries?api_key=YOUR_API_KEY"

Resposta:

[
  { "code": "us", "name": "United States" },
  { "code": "de", "name": "Germany" },
  { "code": "gb", "name": "United Kingdom" },
  { "code": "fr", "name": "France" }
]

Listar regiões

GET https://shifter.io/api/v1/residential/geo/regions

Retorna as regiões (estados / províncias) disponíveis para o direcionamento region-<slug> dentro de um determinado país.

Parameter	In	Required	Description
api_key	query	yes	Sua chave de API
country	query	yes	Código de país ISO 3166-1 alpha-2, ex.: us

Exemplo:

curl "https://shifter.io/api/v1/residential/geo/regions?country=us&api_key=YOUR_API_KEY"

Resposta:

[
  { "slug": "california", "name": "California" },
  { "slug": "new_york",   "name": "New York" },
  { "slug": "texas",      "name": "Texas" }
]

Listar cidades

GET https://shifter.io/api/v1/residential/geo/cities

Retorna as cidades disponíveis para o direcionamento city-<slug> dentro de um país (e, opcionalmente, uma região).

Parameter	In	Required	Description
api_key	query	yes	Sua chave de API
country	query	yes	Código de país ISO 3166-1 alpha-2
region	query	no	Slug de região para restringir os resultados

Exemplo:

curl "https://shifter.io/api/v1/residential/geo/cities?country=us&region=california&api_key=YOUR_API_KEY"

Resposta:

[
  { "slug": "los_angeles",    "name": "Los Angeles" },
  { "slug": "san_francisco",  "name": "San Francisco" },
  { "slug": "san_diego",      "name": "San Diego" }
]

Listar ASNs

GET https://shifter.io/api/v1/residential/geo/asns

Retorna os ASNs disponíveis para o direcionamento asn-<num> dentro de um país.

Parameter	In	Required	Description
api_key	query	yes	Sua chave de API
country	query	yes	Código de país ISO 3166-1 alpha-2

Exemplo:

curl "https://shifter.io/api/v1/residential/geo/asns?country=us&api_key=YOUR_API_KEY"

Resposta:

[
  { "asn": 7922, "name": "Comcast" },
  { "asn": 701,  "name": "Verizon" },
  { "asn": 22773, "name": "Cox Communications" }
]

Veja também

• Visão geral do Residential Proxies
• Geo-targeting — como inserir esses seletores no username
• Autenticação — autenticação de proxy vs. autenticação da API de gerenciamento