Good-Proxies.ru
Accueil

Documentation API pour recuperer des proxys

Description

Cette API donne accès à une liste de serveurs proxy avec filtres personnalisables. L utilisation nécessite une clé d accès valide, vérifiée pour authenticité et respect des limites. Selon le paramètre get, la réponse est au format texte, JSON ou fichier téléchargeable. L API est disponible sur https://api.good-proxies.ru/api.

Parametres principaux de requete

Parametre Description Requis Valeur exemple
key Cle d'acces requise pour authentifier la requete. Oui abc123
type Type de serveurs proxy (http, https, socks4, socks5). Plusieurs types peuvent etre specifies, separes par des virgules. Non http,https
anon Niveau d anonymat du proxy (transparent, anonyme, elite). Non elite
ping Temps de reponse maximal du proxy en millisecondes. Non 500
time Temps maximal (en secondes) depuis la dernière vérification du proxy. Par défaut : 600 (10 dernières minutes). Non 600
works Pourcentage de tests de proxy reussis sur le total des tentatives. Valeurs disponibles : de 0 a 100. Exemple : works=50 signifie que seront retournes les proxys ayant au moins 50% de verifications reussies sur le nombre total de tests. La valeur est affichee si le format json est selectionne. Non 50
country Code pays du proxy (ISO Alpha-2). Plusieurs codes peuvent etre specifies, separes par des virgules. Non us,ca
cm / country_mode Mode de filtre par pays. Valeur include (par défaut) : renvoie uniquement les pays spécifiés. Valeur except : exclut les pays spécifiés des résultats. Le paramètre court cm (ex. cm=except) est pris en charge et compatible avec l'ancien country_mode. Non cm=except & country=us,ca
city Nom de la ville du proxy. Plusieurs villes peuvent etre specifiees, separees par des virgules. Les noms peuvent etre en russe ou en anglais. Non Paris,Moscow
count Nombre de proxys demandes. Non 10
lang Langue des noms de villes dans la réponse et pour le filtrage par ville. ru (par défaut) - noms russes. en - noms anglais. Avec lang=en, le paramètre city accepte les noms anglais. Non ru, en
get Format de sortie des données. Par défaut, txt est utilisé, ce qui signifie une sortie texte dans le navigateur. Pour le format JSON, utilisez get=json. Pour télécharger un fichier, utilisez get=txt.file ou get=json.file. Non txt, json, txt.file, json.file
timecheck Heure de la derniere verification reussie du fonctionnement du proxy. Affichee uniquement si le format json est selectionne. L heure est indiquee en fuseau GMT+2. Non Ne peut pas etre specifie
ip_out Adresse IP de sortie résultante du proxy. Elle peut différer de l'adresse IP principale du proxy. Ce paramètre est affiché uniquement au format JSON. Non Ne peut pas etre specifie

Parametres du format TXT

Le parametre suivant controle le format de ligne pour get=txt et get=txt.file.

Parametre Description Requis Valeur exemple
type_prefix Ajoute le prefixe de protocole a chaque ligne de sortie TXT : type://ip:port. La valeur 1 active ce mode. Exemple : http://127.0.0.1:3128. Non 1

Parametres du format JSON

Les parametres suivants controlent la structure de reponse pour get=json et get=json.file. Ils n affectent pas la sortie TXT.

Parametre Description Requis Valeur exemple
ip Adresse du serveur proxy au format ip:port (ex. 192.168.1.1:8080). Pour separer en champs ip et port, utilisez le parametre split_ip=1. Non 192.168.1.1:8080
fields Liste de champs séparés par des virgules à inclure dans la réponse JSON. Autorisés : ip, port, ip_out, type, anon, ping, timecheck, country, city, works. Par défaut, tous les champs sont renvoyés. Le champ port n'apparaît qu'avec split_ip=1. Non ip,type,country
split_ip Divise le champ ip au format ip:port en deux champs distincts : ip et port. La valeur 1 active la division. Non 1
format Structure de réponse JSON. array (par défaut) - tableau d'objets proxy. object - objet où les clés sont des adresses proxy (ip:port) et les valeurs sont des objets de champs. Non array, object
wrap Encapsule la reponse dans une enveloppe de metadonnees : {status, count, timestamp, filters, data}. La valeur 1 active ce mode. Non 1
pretty Formatage de la réponse JSON. 1 (par défaut) - format lisible avec indentation. 0 - JSON compact sans indentation (moins de trafic). Non 0, 1

Exemples de requetes

Exemple 1 : 5 proxys de type HTTP avec anonymat "elite" au format JSON

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

Exemple 2 : 10 proxys de type HTTPS avec un ping maximal de 500 ms au format TXT pour téléchargement

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

Exemple 3 : 2 proxys des États-Unis et du Canada au format liste (affiché en texte dans le navigateur)

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

Exemple 4 : TXT avec préfixe de protocole type://ip:port

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

Sortie :

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

Exemple 5 : JSON - champs sélectionnés uniquement, IP et port séparés

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

Sortie :

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

Exemple 6 : JSON avec enveloppe de métadonnées (wrap=1)

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

Sortie :

{
    "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",
            ...
        }
    ]
}

Exemple 7 : Filtrer par ville en anglais

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

Le parametre lang=en permet de specifier des villes en anglais et de recevoir les noms de villes en anglais dans la reponse.

Exemple 8 : JSON compact sans indentation (pour traitement automatisé)

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

Format de reponse

Reponse JSON reussie

Apres une requete reussie avec le parametre get=json, l API renvoie une liste de serveurs proxy au format JSON structure. Elle inclut le parametre timecheck, qui indique l heure de la derniere verification reussie en fuseau GMT+2. Le parametre ip_out indique l adresse IP de sortie du proxy, qui peut differer de la principale.

[
    {
        "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"
    }
]

Reponse TXT reussie

Si le paramètre get=txt (par défaut) est utilisé, les données sont renvoyées sous forme de fichier texte brut affiché dans le navigateur :

192.168.1.1:8080
192.168.1.2:8080
192.168.1.3:8080

Reponse TXT reussie pour telechargement

Si le paramètre get=txt.file est utilisé, les données seront proposées au téléchargement au format texte :

192.168.1.1:8080
192.168.1.2:8080
192.168.1.3:8080

Reponse JSON reussie pour telechargement

Si le paramètre get=json.file est utilisé, les données seront proposées au téléchargement au format JSON :

[
    {
        "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"
    }
]

Erreurs

Si la requête échoue, l'API renvoie un message texte décrivant l'erreur.

Erreur : cle d'acces non fournie

Limites

  • Frequence des requetes : pas plus de deux requetes toutes les 5 secondes.
  • Limite quotidienne de requetes : jusqu a 34 560 requetes. Lorsque la limite est depassee, l API renvoie un message d erreur.
  • Restriction de sous-réseau : pas plus de 10 sous-reseaux IP au format "a.b.0.0/16". La limite est reinitialisee toutes les 24 heures. Si la limite est depassee, l API renvoie une erreur.

Notes

  • Tous les parametres sauf key sont facultatifs.
  • Si le paramètre count n'est pas spécifié, l'API renvoie le nombre maximal de proxys disponibles.
  • Si le paramètre time n'est pas spécifié, la valeur par défaut 600 est utilisée (proxys vérifiés au cours des 10 dernières minutes).
  • Lors de l utilisation du parametre get=txt.file ou get=json.file, les donnees seront proposees en telechargement sous forme de fichier.
  • L heure dans le champ timecheck, renvoyee au format JSON, est indiquee dans le fuseau GMT+2.
  • Les parametres JSON (fields, split_ip, format, wrap, pretty) n affectent que les reponses JSON et sont ignores pour la sortie TXT.
  • Le parametre type_prefix n affecte que la sortie TXT (get=txt et get=txt.file) et est ignore pour la sortie JSON.
  • Le parametre lang=en permet de specifier des noms de ville en anglais dans le filtre city et les renvoie en anglais dans la reponse JSON.

Exemple d utilisation PHP

$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 "Erreur lors de la recuperation des proxys.";
}

Conclusion

L API fournit un outil pratique pour recuperer des serveurs proxy avec de nombreuses capacites de filtrage. Assurez-vous de disposer d une cle d acces valide et de respecter les limites pour un fonctionnement ininterrompu du service.