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} akzeptiert beide Formen: die numerische Plan-ID (die Nummer auf der Planseite im Panel) oder die API-ID (der kurze Code am Ende der Plan-URL im Panel, zum Beispiel https://shifter.io/panel/membership/DeeJ). Beide führen zum selben Plan.

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 (numerisch oder API-ID)
`api_token`	query	ja	Ihr Account-API-Token

Beispiel:

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

Antwort:

{
  "error": null,
  "code": 200,
  "data": [
    "185.199.108.153:1337",
    "185.199.108.154:1337",
    "185.199.108.155:1337"
  ]
}

Jeder Eintrag hat die Form ip:port. Der Port (1337) sowie Benutzername und Passwort sind für alle IPs im Pool gleich, nur die IP ändert sich; die Zugangsdaten finden Sie im Panel unter My Plans → ISP Proxies. ISP-Proxys sind in den USA, Kanada, Großbritannien, Frankreich, Deutschland, Spanien und Italien verfügbar. Die Länder Ihrer IPs werden einmalig beim Kauf 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:

{
  "error": null,
  "code": 200,
  "data": [
    "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/YOUR_PLAN_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