Good-Proxies.ru

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
service Filtrer par compatibilite avec les services. Valeurs autorisees : smtp, google, telegram, avito, mail. Plusieurs valeurs separees par des virgules. smtp — port 25 ouvert (SMTP). google — pas de captcha sur Google. telegram — fonctionne avec l API Telegram. avito — fonctionne avec l API Avito. mail — acces HTTPS aux services Mail.ru. Non google,smtp
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, smtp, telegram, avito, google, mail. 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.