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

Exemples

Pays uniquement

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

Pays + région

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

Pays + ville

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

Pays + ASN

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.