Residential-Proxys API

Das Residential-Proxys-Produkt wird pro Anfrage über den Gateway-Benutzernamen konfiguriert. Es gibt dafür keine kontobezogene “Verwaltungs”-API. Was diese API bietet, ist eine Möglichkeit, die Geo-Selektoren aufzulisten, die Sie in den Benutzernamen einfügen können (country, region, city, asn), damit Ihre Tools mit dem tatsächlich Verfügbaren synchron bleiben.

Hinweis

Für die Nutzung auf Protokollebene, Sticky Sessions, strikte Zuordnung und die vollständige Liste der Flags siehe Produkte → Residential Proxies und Gateway & Auth.

Authentifizierung

Alle Endpunkte authentifizieren sich mit einem api_key-Query-Parameter. Erstellen Sie einen Schlüssel im Panel unter Account → API Keys.

?api_key=YOUR_API_KEY

Länder auflisten

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

Gibt jedes Land zurück, das für das Targeting mit country-<iso2> auf dem Residential-Proxys-Gateway verfügbar ist.

Parameter	In	Erforderlich	Beschreibung
api_key	query	ja	Ihr API-Schlüssel

Beispiel:

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

Antwort:

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

Regionen auflisten

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

Gibt die Regionen (Bundesstaaten / Provinzen) zurück, die für das Targeting mit region-<slug> innerhalb eines bestimmten Landes verfügbar sind.

Parameter	In	Erforderlich	Beschreibung
api_key	query	ja	Ihr API-Schlüssel
country	query	ja	ISO 3166-1 Alpha-2 Ländercode, z. B. us

Beispiel:

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

Antwort:

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

Städte auflisten

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

Gibt die Städte zurück, die für das Targeting mit city-<slug> innerhalb eines Landes (und optional einer Region) verfügbar sind.

Parameter	In	Erforderlich	Beschreibung
api_key	query	ja	Ihr API-Schlüssel
country	query	ja	ISO 3166-1 Alpha-2 Ländercode
region	query	nein	Regions-Slug zur Eingrenzung der Ergebnisse

Beispiel:

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

Antwort:

[
  { "slug": "los_angeles",    "name": "Los Angeles" },
  { "slug": "san_francisco",  "name": "San Francisco" },
  { "slug": "san_diego",      "name": "San Diego" }
]

ASNs auflisten

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

Gibt die ASNs zurück, die für das Targeting mit asn-<num> innerhalb eines Landes verfügbar sind.

Parameter	In	Erforderlich	Beschreibung
api_key	query	ja	Ihr API-Schlüssel
country	query	ja	ISO 3166-1 Alpha-2 Ländercode

Beispiel:

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

Antwort:

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

Siehe auch

• Residential Proxies Übersicht
• Geo-Targeting - wie Sie diese Selektoren in den Benutzernamen einfügen
• Authentifizierung - Proxy-Authentifizierung vs. Verwaltungs-API-Authentifizierung