Zum Inhalt springen
Anmelden Registrieren

Geo-Targeting

Geo-Targeting wird pro Anfrage konfiguriert, indem Flags an den Benutzernamen angehängt werden. Keine Dashboard-Änderung, kein separater Endpunkt, jede Anfrage läuft über dasselbe Gateway.

Flags werden mit Bindestrichen an Ihren Benutzernamen angehängt:

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

Werte werden kleingeschrieben. Region- und Stadtnamen verwenden Unterstriche für Leerzeichen. Ländercodes sind ISO 3166-1 alpha-2.

FlagWertBeispiel
countryISO-Ländercodecountry-us, country-gb, country-de
regionKleingeschriebener Region/Bundesstaat-Slugregion-california, region-new_south_wales
cityKleingeschriebener Stadt-Slugcity-new_york, city-los_angeles
asnASN-Nummerasn-7922 (Comcast), asn-701 (Verizon)
stricttruestrict-true (siehe Fallback-Verhalten)

Kombinieren Sie Flags in beliebiger Reihenfolge:

customer-USERNAME-country-us-region-california-city-los_angeles
customer-USERNAME-country-gb-asn-2856
customer-USERNAME-city-berlin
Terminal-Fenster
curl -x customer-USERNAME-country-de-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443 \
https://ipinfo.io/json

Standardmäßig greift das Gateway auf einen breiteren Pool zurück, wenn zum Zeitpunkt der Anfrage keine IPs Ihrem vollständigen Filter entsprechen (zum Beispiel eine wenig bekannte Stadt mit einem momentan leeren Pool), damit die Anfrage trotzdem abgeschlossen wird.

Fügen Sie strict-true hinzu, um den Fallback zu deaktivieren und stattdessen HTTP 502 zu erhalten. Verwenden Sie strikte Zuordnung, wenn eine exakte geografische Übereinstimmung wichtiger ist als der Erfolg der Anfrage:

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

Lassen Sie alle Flags weg, um aus dem vollständigen globalen Pool zu ziehen:

USERNAME

Jede Anfrage rotiert weiterhin zu einer anderen IP, nur ohne geografische Einschränkung.

  • Sessions, behalten die anvisierte IP über mehrere Anfragen hinweg bei.
  • Integrationen, binden Sie Geo-Flags in Scrapy, Puppeteer, Playwright ein.