Geolocalización
La segmentación geográfica se configura por solicitud añadiendo indicadores al nombre de usuario. Sin cambios en el panel, sin endpoint independiente, todas las solicitudes pasan por la misma puerta de enlace.
Sintaxis
Sección titulada «Sintaxis»Los indicadores se añaden a tu nombre de usuario con guiones:
customer-USERNAME-country-<code>-region-<name>-city-<name>-asn-<number>Los valores van en minúsculas. Los nombres de región y ciudad usan guiones bajos para los espacios. Los códigos de país son ISO 3166-1 alpha-2.
Filtros disponibles
Sección titulada «Filtros disponibles»| Indicador | Valor | Ejemplo |
|---|---|---|
country | Código de país ISO | country-us, country-gb, country-de |
region | Slug de región/estado en minúsculas | region-california, region-new_south_wales |
city | Slug de ciudad en minúsculas | city-new_york, city-los_angeles |
asn | Número de ASN | asn-7922 (Comcast), asn-701 (Verizon) |
strict | true | strict-true (ver Comportamiento de reserva) |
Combina los indicadores en cualquier orden:
customer-USERNAME-country-us-region-california-city-los_angelescustomer-USERNAME-country-gb-asn-2856customer-USERNAME-city-berlinEjemplos
Sección titulada «Ejemplos»curl -x customer-USERNAME-country-de-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443 \ https://ipinfo.io/jsoncurl -x customer-USERNAME-country-us-region-california-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443 \ https://ipinfo.io/jsoncurl -x customer-USERNAME-country-us-city-new_york-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443 \ https://ipinfo.io/jsoncurl -x customer-USERNAME-country-us-asn-7922-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443 \ https://ipinfo.io/jsonComportamiento de reserva
Sección titulada «Comportamiento de reserva»De forma predeterminada, si ninguna IP coincide con tu filtro completo en el momento de la solicitud (por ejemplo, una ciudad poco común con un grupo momentáneamente vacío), la puerta de enlace recurre a un grupo más amplio para que la solicitud siga completándose.
Añade strict-true para renunciar a esta reserva y recibir HTTP 502 en su lugar. Usa la coincidencia estricta cuando una correspondencia geográfica exacta sea más importante que el éxito de la solicitud:
curl -x customer-USERNAME-country-us-city-new_york-strict-true-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443 \ https://ipinfo.io/jsonSin filtro
Sección titulada «Sin filtro»Omite todos los indicadores para extraer del grupo global completo:
USERNAMECada solicitud sigue rotando a una IP diferente, simplemente sin restricción geográfica.
Siguientes pasos
Sección titulada «Siguientes pasos»- Sesiones, mantiene la IP seleccionada a lo largo de varias solicitudes.
- Integraciones, conecta los indicadores geográficos con Scrapy, Puppeteer, Playwright.