API ShadowProxy

L’API ShadowProxy permet de piloter vos proxys 4G depuis vos propres programmes : lister vos proxys et leurs accès, changer d’IP et récupérer la nouvelle adresse, consulter l’historique des IP. Elle répond en JSON, à l’adresse https://shadowproxy.fr/api/v1.

Elle complète le lien de rotation de chaque proxy : une seule clé suffit pour tous vos proxys, et vous obtenez aussi leur état et leur consommation. Elle ne donne accès ni aux commandes, ni au paiement, ni à vos données personnelles.

Une question ou un besoin particulier ? Écrivez-nous à contact@shadowproxy.fr.

1. Créer une clé

Dans votre espace client, ouvrez Mon compte, rubrique Clés API, puis Créer une clé. Donnez-lui un nom (par exemple « script de scraping »). La clé commence par sp_ et ne s’affiche qu’une seule fois : copiez-la tout de suite. Vous pouvez avoir jusqu’à 5 clés et en supprimer une à tout moment ; elle cesse alors immédiatement de fonctionner. Un e-mail vous prévient à chaque création de clé.

2. S’authentifier

Envoyez la clé dans l’en-tête Authorization (ou dans l’en-tête X-API-Key) :

curl https://shadowproxy.fr/api/v1/ping \
  -H "Authorization: Bearer sp_VOTRE_CLE"
# {"ok":true}

Les messages sont dans la langue de votre compte. Pour les forcer, ajoutez l’en-tête X-Lang: fr ou X-Lang: en.

3. Les actions disponibles

4. Lister vos proxys

curl https://shadowproxy.fr/api/v1/proxies -H "Authorization: Bearer sp_VOTRE_CLE"

{
  "proxies": [
    {
      "id": "sp123456",
      "name": "Proxy 4G 1",
      "status": "online",
      "online": true,
      "ip": "37.165.12.34",
      "network": "4G",
      "signal": 3,
      "http": "proxy.shadowproxy.fr:10001:sp123456:MotDePasse",
      "socks5": "proxy.shadowproxy.fr:20001:sp123456:MotDePasse",
      "lastIpChangeAt": "2026-11-10T09:12:44.000Z",
      "data": { "periodStart": "2026-11-01", "periodEnd": "2026-12-01", "usedBytes": 5120000000, "includedGb": 200 },
      "subscriptionEnd": "2026-12-01"
    }
  ]
}

Les champs d’un proxy :

• id : identifiant du proxy, à utiliser dans les adresses
• name : son nom, celui que vous lui avez donné dans l’espace client
• status : online, offline, rotating (changement en cours), rebooting ou disabled
• ip : IP publique actuelle
• http, socks5 : lignes d’accès, au format hôte:port:identifiant:mot de passe
• data : période en cours, data consommée (octets) et data incluse (Go)
• subscriptionEnd : date de fin de l’abonnement
• lastIpChangeAt : date du dernier changement d’IP

5. Changer d’IP

Sans paramètre, la réponse arrive tout de suite (code 202) et le changement se fait en moins de 20 secondes. Avec ?wait=1, la réponse arrive une fois la nouvelle IP active, avec l’adresse :

curl -X POST "https://shadowproxy.fr/api/v1/proxies/sp123456/rotate?wait=1" \
  -H "Authorization: Bearer sp_VOTRE_CLE"
# {"ok":true,"status":"done","ip":"78.240.12.34","message":"Nouvelle IP attribuée."}

6. Exemple complet en Python

import requests

API = "https://shadowproxy.fr/api/v1"
HEADERS = {"Authorization": "Bearer sp_VOTRE_CLE"}

# Vos proxys
proxies = requests.get(f"{API}/proxies", headers=HEADERS, timeout=30).json()["proxies"]
p = proxies[0]
print(p["name"], p["ip"], p["online"])

# Nouvelle IP, en attendant qu’elle soit active
r = requests.post(f"{API}/proxies/{p['id']}/rotate", params={"wait": 1}, headers=HEADERS, timeout=120)
print("Nouvelle IP :", r.json().get("ip"))

# Historique des IP (50 dernières)
ips = requests.get(f"{API}/proxies/{p['id']}/ips", headers=HEADERS, timeout=30).json()["ips"]

7. Erreurs

8. Limites

• 60 requêtes par minute et par clé.
• 30 changements d’IP par tranche de 10 minutes et par clé, et un seul à la fois par proxy.
• Chaque changement d’IP coupe pendant quelques secondes les connexions ouvertes sur ce proxy : espacez-les si vous gardez des connexions longues.

9. Sécurité

• Ne publiez jamais votre clé (dépôt de code, capture d’écran, forum) : elle donne accès à vos proxys.
• Nous n’enregistrons qu’une empreinte de la clé, jamais la clé elle-même.
• Une clé compromise se supprime en un clic dans Mon compte, Clés API.