ISP-Proxies-API

Verwenden Sie diese API, um Ihren ISP-Proxy-IP-Pool aufzulisten und die Quell-IP-Whitelist zu verwalten. Für die protokollseitige Proxy-Nutzung (host:port, Anmeldedaten) siehe Produkte → ISP Proxies.

Authentifizierung

Alle Endpunkte authentifizieren sich mit einem api_token-Query-Parameter. Erstellen Sie ein Token im Panel unter Account → API Tokens.

?api_token=YOUR_API_TOKEN

Der Pfadparameter {membership} ist Ihre Plan-ID, die im Panel auf der Planseite angezeigt wird.

Proxys auflisten

GET https://shifter.io/api/v1/static-residential/{membership}/proxies

Gibt jede fest zugewiesene IP in Ihrem Plan mit dem gemeinsam genutzten Port und den Anmeldedaten zurück. Derselbe Port (1337) sowie derselbe Benutzername/dasselbe Passwort gelten für den gesamten Pool. Nur die IP ändert sich.

Parameter	In	Erforderlich	Beschreibung
`membership`	path	ja	Die Plan-ID
`api_token`	query	ja	Ihr Account-API-Token

Beispiel:

curl "https://shifter.io/api/v1/static-residential/MEMBERSHIP_ID/proxies?api_token=YOUR_API_TOKEN"

Antwort:

{
  "proxies": [
    {
      "ip": "185.199.108.153",
      "port": 1337,
      "username": "pool-xyz",
      "password": "...",
      "country": "us",
      "asn": 7922,
      "isp": "Comcast",
      "assigned_at": "2026-01-15T12:03:44Z"
    },
    {
      "ip": "185.199.108.154",
      "port": 1337,
      "username": "pool-xyz",
      "password": "...",
      "country": "gb",
      "asn": 5089,
      "isp": "Virgin Media",
      "assigned_at": "2026-01-15T12:03:44Z"
    }
  ]
}

Das Feld country enthält den ISO-3166-1-alpha-2-Code des Landes, in dem die IP bereitgestellt wurde. ISP-Proxys sind in us, gb, fr, de, es und it verfügbar. Die Länder, in denen sich Ihre IPs befinden, werden einmalig zum Kaufzeitpunkt festgelegt und sind danach fest, siehe Ländereinrichtung.

Autorisierte Quell-IPs

Setzen Sie Quell-IPs auf die Whitelist, damit Ihre Scraper die HTTP-Basic-Authentifizierung bei jeder Anfrage überspringen können. Die Whitelist gilt kontoweit. Jede auf der Whitelist stehende Quelle kann jede fest zugewiesene IP im Pool verwenden.

Autorisierte IPs auflisten

GET https://shifter.io/api/v1/static-residential/{membership}/authorized-ips

Parameter	In	Erforderlich	Beschreibung
`membership`	path	ja	Die Plan-ID
`api_token`	query	ja	Ihr Account-API-Token

Antwort:

{
  "ips": ["198.51.100.10", "203.0.113.42"]
}

Autorisierte IPs aktualisieren

PUT https://shifter.io/api/v1/static-residential/{membership}/authorized-ips

Ersetzt die Liste der autorisierten IPs durch die angegebenen Werte.

Parameter	In	Erforderlich	Beschreibung
`membership`	path	ja	Die Plan-ID
`api_token`	query	ja	Ihr Account-API-Token
`ips[]`	body	ja	Array von IPv4-Adressen für die Whitelist

Beispiel (formularkodiert, mit Method-Override):

curl -X POST "https://shifter.io/api/v1/static-residential/MEMBERSHIP_ID/authorized-ips?api_token=YOUR_API_TOKEN" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "_method=PUT&ips[]=198.51.100.10&ips[]=203.0.113.42"

Jetzt starten

Proxies

APIs

Ressourcen