Ciblage géographique

Le geo-targeting se configure par requête en ajoutant des flags au nom d’utilisateur. Aucun changement dans le tableau de bord, aucun endpoint séparé, chaque requête passe par la même passerelle.

Syntaxe

Les flags s’ajoutent à votre nom d’utilisateur avec des tirets :

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

Les valeurs sont en minuscules. Les noms de région et de ville utilisent des underscores pour les espaces. Les codes pays sont au format ISO 3166-1 alpha-2.

Filtres disponibles

Flag	Valeur	Exemple
`country`	Code pays ISO	`country-us`, `country-gb`, `country-de`
`region`	Slug de région/état en minuscules	`region-california`, `region-new_south_wales`
`city`	Slug de ville en minuscules	`city-new_york`, `city-los_angeles`
`asn`	Numéro ASN	`asn-7922` (Comcast), `asn-701` (Verizon)
`strict`	`true`	`strict-true` (voir Comportement de repli)

Combinez les flags dans n’importe quel ordre :

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

Prise en charge par pool

Les filtres disponibles dépendent du pool résidentiel sur lequel fonctionne votre offre.

Pool	`country`	`region`, `city`, `asn`
Full Geo	Oui	Oui
Country Geo	Oui	Non
Non-Geo	Non	Non

Non-Geo renvoie un mélange mondial d’IP et n’accepte aucun ciblage. Le générateur de proxys du panneau désactive les filtres que votre pool ne prend pas en charge, et vous pouvez changer de pool à tout moment depuis New Order → Residential Proxies.

Exemples

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

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

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

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

Comportement de repli

Par défaut, si aucune IP ne correspond à votre filtre complet au moment de la requête (par exemple, une ville peu courante dont le pool est momentanément vide), la passerelle se replie sur un pool plus large afin que la requête aboutisse tout de même.

Ajoutez strict-true pour désactiver ce repli et recevoir HTTP 502 à la place. Utilisez la correspondance stricte lorsqu’une correspondance géographique exacte est plus importante que la réussite de la requête :

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

Aucun filtre

Omettez tous les flags pour puiser dans le pool global complet :

USERNAME

Chaque requête effectue toujours une rotation vers une IP différente, simplement sans contrainte géographique.

Suite

Sessions, conserve l’IP ciblée sur plusieurs requêtes.
Intégrations, intègre les flags de géolocalisation dans Scrapy, Puppeteer, Playwright.

Commencer

Proxies

APIs

Ressources