Good-Proxies.ru
Startseite

API-Dokumentation zum Abrufen von Proxys

Beschreibung

Diese API bietet Zugriff auf eine Liste von Proxy-Servern mit anpassbaren Filtern. Die Nutzung setzt einen gültigen Zugangsschlüssel voraus, der auf Authentizität und Einhaltung der Nutzungsgrenzen geprüft wird. Je nach Parameter get liefert die API Text, JSON oder eine herunterladbare Datei. Die API ist unter https://api.good-proxies.ru/api erreichbar.

Hauptparameter der Anfrage

Parameter Beschreibung Erforderlich Beispielwert
key Zur Authentifizierung der Anfrage ist ein Zugriffsschluessel erforderlich. Ja abc123
type Typ der Proxy-Server (http, https, socks4, socks5). Mehrere Typen koennen komma-getrennt angegeben werden. Nein http,https
anon Anonymitätsstufe des Proxys (transparent, anonym, elit). Nein elite
ping Maximal zulaessige Proxy-Antwortzeit in Millisekunden. Nein 500
time Maximale Zeit (in Sekunden) seit der letzten Proxy-Prüfung. Standard: 600 (letzte 10 Minuten). Nein 600
works Prozentsatz erfolgreicher Proxy-Tests an allen Versuchen. Verfuegbare Werte: von 0 bis 100. Beispiel: works=50 bedeutet, dass Proxys mit mindestens 50% erfolgreichen Pruefungen an der Gesamtzahl der Tests zurueckgegeben werden. Der Wert wird angezeigt, wenn das json-Format gewaehlt ist. Nein 50
country Proxy-Laendercode (ISO Alpha-2). Mehrere Codes koennen durch Kommas getrennt angegeben werden. Nein us,ca
cm / country_mode Länderfiltermodus. Wert include (Standard) – gibt nur die angegebenen Länder zurück. Wert except – schließt die angegebenen Länder aus den Ergebnissen aus. Der Kurzparameter cm (z. B. cm=except) wird unterstützt und ist mit dem Legacy-Parameter country_mode kompatibel. Nein cm=except & country=us,ca
city Name der Proxy-Stadt. Mehrere Staedte koennen durch Kommas getrennt angegeben werden. Namen koennen auf Russisch oder Englisch sein. Nein Paris,Moscow
count Anzahl angeforderter Proxys. Nein 10
lang Sprache für Städtenamen in der Antwort und beim Filtern nach Stadt. ru (Standard) - russische Städtenamen. en - englische Städtenamen. Mit lang=en akzeptiert der Parameter city englische Städtenamen. Nein ru, en
get Datenausgabeformat. Standardmäßig wird txt verwendet, d. h. Textausgabe im Browser. Für JSON-Ausgabe verwenden Sie get=json. Zum Herunterladen einer Datei verwenden Sie get=txt.file oder get=json.file. Nein txt, json, txt.file, json.file
timecheck Zeitpunkt der letzten erfolgreichen Funktionspruefung des Proxys. Wird nur angezeigt, wenn das Format json gewaehlt ist. Die Zeit ist in der Zeitzone GMT+2 angegeben. Nein Kann nicht angegeben werden
ip_out Ausgehende resultierende Proxy-IP-Adresse. Kann von der Haupt-Proxy-IP-Adresse abweichen. Dieser Parameter wird nur im JSON-Format angezeigt. Nein Kann nicht angegeben werden

TXT-Format-Parameter

Der folgende Parameter steuert das Zeilenformat fuer get=txt und get=txt.file.

Parameter Beschreibung Erforderlich Beispielwert
type_prefix Fuegt jeder TXT-Ausgabezeile das Protokollpraefix hinzu: type://ip:port. Der Wert 1 aktiviert den Modus. Beispiel: http://127.0.0.1:3128. Nein 1

JSON-Format-Parameter

Die folgenden Parameter steuern die Antwortstruktur fuer get=json und get=json.file. Sie beeinflussen die TXT-Ausgabe nicht.

Parameter Beschreibung Erforderlich Beispielwert
ip Adresse des Proxy-Servers im Format ip:port (z. B. 192.168.1.1:8080). Um in separate Felder ip und port aufzuteilen, verwenden Sie den Parameter split_ip=1. Nein 192.168.1.1:8080
fields Durch Kommas getrennte Liste der Felder für die JSON-Antwort. Erlaubt: ip, port, ip_out, type, anon, ping, timecheck, country, city, works. Standardmäßig werden alle Felder zurückgegeben. Das Feld port erscheint nur mit split_ip=1. Nein ip,type,country
split_ip Teilt das Feld ip im Format ip:port in zwei separate Felder auf: ip und port. Der Wert 1 aktiviert die Aufteilung. Nein 1
format JSON-Antwortstruktur. array (Standard) - Array von Proxy-Objekten. object - Objekt, bei dem Schlüssel Proxy-Adressen (ip:port) und Werte Feldobjekte sind. Nein array, object
wrap Kapselt die Antwort in einen Metadaten-Umschlag: {status, count, timestamp, filters, data}. Der Wert 1 aktiviert diese Umhuellung. Nein 1
pretty JSON-Antwortformatierung. 1 (Standard) - lesbares Format mit Einrückung. 0 - kompaktes JSON ohne Einrückung (weniger Traffic). Nein 0, 1

Anfragebeispiele

Beispiel 1: 5 Proxys vom Typ HTTP mit "Elite"-Anonymität im JSON-Format

GET https://api.good-proxies.ru/api?key=abc123&type=http&anon=elite&count=5&get=json

Beispiel 2: 10 Proxys vom Typ HTTPS mit maximalem Ping von 500 ms im TXT-Format zum Download

GET https://api.good-proxies.ru/api?key=abc123&type=https&ping=500&count=10&get=txt.file

Beispiel 3: 2 Proxys aus den USA und Kanada im Listenformat (als Text im Browser angezeigt)

GET https://api.good-proxies.ru/api?key=abc123&country=us,ca&count=2

Beispiel 4: TXT mit Protokollpräfix type://ip:port

GET https://api.good-proxies.ru/api?key=abc123&type=http&count=5&type_prefix=1

Ausgabe:

http://192.168.1.1:8080
http://192.168.1.2:3128
http://192.168.1.3:8118

Beispiel 5: JSON - nur ausgewählte Felder, IP und Port getrennt

GET https://api.good-proxies.ru/api?key=abc123&type=socks5&count=2&get=json&fields=ip,port,type,country&split_ip=1

Ausgabe:

[
    {
        "ip": "192.168.1.1",
        "port": "1080",
        "type": "socks5",
        "country": "US"
    },
    {
        "ip": "192.168.1.2",
        "port": "1080",
        "type": "socks5",
        "country": "DE"
    }
]

Beispiel 6: JSON mit Metadaten-Umschlag (wrap=1)

GET https://api.good-proxies.ru/api?key=abc123&type=http&count=2&get=json&wrap=1

Ausgabe:

{
    "status": "ok",
    "count": 2,
    "timestamp": "2026-03-01T12:00:00+00:00",
    "filters": {
        "type": "http",
        "time": 600
    },
    "data": [
        {
            "ip": "192.168.1.1:8080",
            "type": "http",
            ...
        }
    ]
}

Beispiel 7: Nach Stadt auf Englisch filtern

GET https://api.good-proxies.ru/api?key=abc123&city=Paris,London&count=5&get=json&lang=en

Der Parameter lang=en erlaubt es, Staedte auf Englisch anzugeben und englische Staedtenamen in der Antwort zu erhalten.

Beispiel 8: Kompaktes JSON ohne Einrückung (für automatische Verarbeitung)

GET https://api.good-proxies.ru/api?key=abc123&type=http&count=10&get=json&pretty=0

Antwortformat

Erfolgreiche JSON-Antwort

Bei einer erfolgreichen Anfrage mit dem Parameter get=json gibt die API eine Liste von Proxy-Servern im strukturierten JSON-Format zurueck. Enthalten ist der Parameter timecheck, der die Zeit der letzten erfolgreichen Pruefung in der Zeitzone GMT+2 anzeigt. Der Parameter ip_out zeigt die resultierende Proxy-IP an, die von der Haupt-IP abweichen kann.

[
    {
        "ip": "15.162.126.1:919",
        "ip_out": "15.162.126.1",
        "type": "http",
        "anon": "transparent",
        "ping": 5.07786,
        "timecheck": "2024-11-25 20:09:25",
        "country": "CO",
        "city": "Медельин",
        "works": "66"
    }
]

Erfolgreiche TXT-Antwort

Wenn der Parameter get=txt (Standard) verwendet wird, werden die Daten als im Browser angezeigte Klartextdatei zurückgegeben:

192.168.1.1:8080
192.168.1.2:8080
192.168.1.3:8080

Erfolgreiche TXT-Antwort zum Download

Wenn der Parameter get=txt.file verwendet wird, werden die Daten im Textformat zum Download angeboten:

192.168.1.1:8080
192.168.1.2:8080
192.168.1.3:8080

Erfolgreiche JSON-Antwort zum Download

Wenn der Parameter get=json.file verwendet wird, werden die Daten im JSON-Format zum Download angeboten:

[
    {
        "ip": "112.63.11.8:180",
        "ip_out": "122.63.41.1",
        "type": "http",
        "anon": "elite",
        "ping": 3.83659,
        "timecheck": "2024-11-25 20:09:26",
        "country": "SN",
        "city": "",
        "works": "100"
    }
]

Fehler

Wenn die Anfrage fehlschlägt, gibt die API eine Textmeldung mit Fehlerbeschreibung zurück.

Fehler: Zugriffsschluessel wurde nicht angegeben

Grenzen

  • Anfragefrequenz: nicht mehr als zwei Anfragen alle 5 Sekunden.
  • Taegliches Anfrage-Limit: bis zu 34.560 Anfragen. Wenn das Limit ueberschritten wird, gibt die API eine Fehlermeldung zurueck.
  • Subnetzbeschränkung: nicht mehr als 10 IP-Subnetze im Format "a.b.0.0/16". Das Limit wird alle 24 Stunden zurueckgesetzt. Bei Ueberschreitung gibt die API einen Fehler zurueck.

Hinweise

  • Alle Parameter ausser key sind optional.
  • Wenn der Parameter count nicht angegeben ist, gibt die API die maximale Anzahl verfügbarer Proxys zurück.
  • Wenn der Parameter time nicht angegeben ist, wird der Standardwert 600 verwendet (Proxys, die in den letzten 10 Minuten geprüft wurden).
  • Bei Verwendung des Parameters get=txt.file oder get=json.file werden die Daten als Datei zum Download angeboten.
  • Die Zeit im Feld timecheck, die im JSON-Format zurueckgegeben wird, ist in der Zeitzone GMT+2 angegeben.
  • JSON-Parameter (fields, split_ip, format, wrap, pretty) wirken sich nur auf JSON-Antworten aus und werden bei TXT-Ausgabe ignoriert.
  • Der Parameter type_prefix wirkt sich nur auf die TXT-Ausgabe aus (get=txt und get=txt.file) und wird bei JSON-Ausgabe ignoriert.
  • Der Parameter lang=en erlaubt, Staedtenamen im Filter city auf Englisch anzugeben und gibt sie in der JSON-Antwort auf Englisch zurueck.

PHP-Nutzungsbeispiel

$key = 'abc123';
$type = 'http';
$anon = 'elite';
$count = 5;
$get = 'json';

$url = "https://api.good-proxies.ru/api?key=$key&type=$type&anon=$anon&count=$count&get=$get";

$response = file_get_contents($url);

if ($response) {
    $proxies = json_decode($response, true);
    print_r($proxies);
} else {
    echo "Fehler beim Abrufen der Proxys.";
}

Fazit

Die API bietet ein praktisches Werkzeug zum Abrufen von Proxy-Servern mit umfangreichen Filtermoeglichkeiten. Stellen Sie sicher, dass Sie einen gueltigen Zugriffsschluessel haben und die Limits fuer einen unterbrechungsfreien Betrieb einhalten.