API de Proxies Residenciales

El producto Residential Proxies se configura por solicitud a través del nombre de usuario de la puerta de enlace (gateway username); no existe una API de “gestión” por cuenta para ello. Lo que ofrece esta API es una forma de enumerar los selectores geográficos que puedes incluir en el nombre de usuario (country, region, city, asn) para que tus herramientas se mantengan sincronizadas con lo que realmente está disponible.

Nota

Para el uso a nivel de protocolo, sesiones persistentes (sticky sessions), coincidencia estricta y la lista completa de flags, consulta Productos → Residential Proxies y Gateway y autenticación.

Autenticación

Todos los endpoints se autentican con un parámetro de consulta api_key. Genera una clave en el panel, en Account → API Keys.

?api_key=YOUR_API_KEY

Listar países

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

Devuelve todos los países disponibles para el segmentación (targeting) country-<iso2> en la puerta de enlace de Residential Proxies.

Parameter	In	Required	Description
api_key	query	yes	Your API key

Ejemplo:

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

Respuesta:

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

Listar regiones

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

Devuelve las regiones (estados / provincias) disponibles para la segmentación region-<slug> dentro de un país determinado.

Parameter	In	Required	Description
api_key	query	yes	Your API key
country	query	yes	ISO 3166-1 alpha-2 country code, e.g. us

Ejemplo:

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

Respuesta:

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

Listar ciudades

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

Devuelve las ciudades disponibles para la segmentación city-<slug> dentro de un país (y opcionalmente una región).

Parameter	In	Required	Description
api_key	query	yes	Your API key
country	query	yes	ISO 3166-1 alpha-2 country code
region	query	no	Region slug to narrow results

Ejemplo:

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

Respuesta:

[
  { "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

Devuelve los ASNs disponibles para la segmentación asn-<num> dentro de un país.

Parameter	In	Required	Description
api_key	query	yes	Your API key
country	query	yes	ISO 3166-1 alpha-2 country code

Ejemplo:

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

Respuesta:

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

Ver también

• Visión general de Residential Proxies
• Segmentación geográfica: cómo incluir estos selectores en el nombre de usuario
• Autenticación: autenticación de proxy frente a autenticación de la API de gestión