Comment faire tourner une IP de proxy mobile 4G/5G

Que faut-il avant de faire une rotation ?

Vous avez besoin de trois éléments depuis l'espace client :

• L'ID du port, qui commence par mob_, par exemple mob_2v8k1q.
• Le point de terminaison du port et ses identifiants (hôte, port, nom d'utilisateur, mot de passe), pour envoyer du trafic et vérifier l'IP.
• Une clé API avec le scope proxies. La clé complète est affichée une seule fois ; nous ne stockons qu'un hash. Ajoutez read pour lister l'historique des IP.

La rotation s'applique aux ports dédiés 4G/5G](/mobile-proxies/), pas au trafic mobile rotatif facturé au GB.

Comment faire une rotation avec le lien de rotation ?

Envoyez une requête GET à https://namelessproxy.com/api/v1/mobile/{port}/rotate?key=API_KEY, avec votre ID de port et votre clé API renseignés. Cela fonctionne depuis un favori navigateur, curl ou tout outil HTTP. Ajoutez &format=text pour obtenir la nouvelle IP en texte brut au lieu de JSON. L'appel répond une fois que le modem s'est reconnecté, donc prévoyez jusqu'à une minute avant un timeout.

Le script ci-dessous construit le lien depuis le modèle et réessaie après 429.

#!/usr/bin/env bash
# Rotate a dedicated port with its rotation link, retrying after 429.
set -euo pipefail
PORT_ID="PORT_ID"      # e.g. mob_2v8k1q
API_KEY="API_KEY"      # API key with the "proxies" scope

TEMPLATE="https://namelessproxy.com/api/v1/mobile/{port}/rotate?key=API_KEY"
URL="${TEMPLATE/"{port}"/$PORT_ID}"
URL="${URL/API_KEY/$API_KEY}&format=text"   # format=text: the new IP as plain text

HDRS=$(mktemp); BODY=$(mktemp)
for attempt in 1 2 3; do
  STATUS=$(curl -sS --max-time 60 -D "$HDRS" -o "$BODY" -w '%{http_code}' "$URL")
  if [ "$STATUS" = "200" ]; then
    echo "New IP: $(cat "$BODY")"; exit 0
  fi
  if [ "$STATUS" = "429" ]; then
    WAIT=$(grep -i '^retry-after:' "$HDRS" | tr -dc '0-9'); WAIT=${WAIT:-30}
    echo "Too soon; retrying in ${WAIT}s"; sleep "$WAIT"; continue
  fi
  echo "Rotation failed (HTTP $STATUS):"; cat "$BODY"; exit 1
done
exit 1

Comment faire une rotation avec l'API ?

Envoyez POST au même chemin sans la chaîne de requête, avec la clé dans un header Authorization: Bearer. Cela évite de mettre la clé dans les URLs. Un appel réussi retourne la nouvelle IP, l'ancienne, l'heure du changement et l'heure la plus proche possible de la prochaine rotation.

{
  "ip": "203.0.113.57",
  "previousIp": "203.0.113.12",
  "rotatedAt": "2026-10-05T14:03:11Z",
  "nextRotationAvailableAt": "2026-10-05T14:03:41Z"
}

# pip install requests
import time
import requests

API_KEY = "API_KEY"     # API key with the "proxies" scope
PORT_ID = "PORT_ID"     # e.g. mob_2v8k1q
PROXY = "http://USERNAME:PASSWORD@HOST:PORT"   # the port's endpoint, from the client area

TEMPLATE = "https://namelessproxy.com/api/v1/mobile/{port}/rotate?key=API_KEY"
ROTATE_URL = TEMPLATE.replace("{port}", PORT_ID).split("?")[0]   # POST: key goes in the header
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

def exit_ip():
    return requests.get("https://api.ipify.org",
                        proxies={"http": PROXY, "https": PROXY}, timeout=30).text

def rotate(max_attempts=3):
    for _ in range(max_attempts):
        r = requests.post(ROTATE_URL, headers=HEADERS, timeout=60)   # takes ~5-15 s
        if r.status_code == 200:
            return r.json()   # ip, previousIp, rotatedAt, nextRotationAvailableAt
        if r.status_code == 429:   # rotation_too_soon or rate_limited
            wait = int(r.headers.get("Retry-After", "30"))
            print(f"{r.json()['error']['code']}: waiting {wait} s")
            time.sleep(wait)
            continue
        r.raise_for_status()      # 401, 403 (missing scope), 404, 409 port_not_active
    raise RuntimeError("Rotation did not succeed")

before = exit_ip()
result = rotate()
print(f"{before} -> {result['ip']}; next rotation from {result['nextRotationAvailableAt']}")
if result["ip"] == result["previousIp"]:
    print("Same IP: the carrier handed it back. Try again after the 30 s limit.")
print("Seen through the proxy:", exit_ip())

Que se passe-t-il si je fais trop souvent des rotations ?

L'API répond 429 avec le code d'erreur rotation_too_soon si la dernière rotation date de moins de 30 secondes. Le header Retry-After et le champ error.details.retryAfter indiquent le nombre de secondes à attendre. Le champ nextRotationAvailableAt de la dernière rotation réussie vous informe aussi à l'avance.

Comment faire une rotation automatique avec un timer ?

Réglez le mode de rotation du port sur interval avec un nombre de minutes entre 2 et 1 440, dans l'espace client ou via un appel PATCH. Remettez-le sur manual pour arrêter. Le même script lit l'historique IP du port, qui affiche chaque IP avec son heure de début et de fin ainsi que la cause du changement : manuel, lien, intervalle, relocalisation ou opérateur. Si un appel retourne 403, la clé manque de scope ; créez-en une avec read et proxies.

PORT_ID="PORT_ID"      # e.g. mob_2v8k1q
API_KEY="API_KEY"      # scopes: proxies (+ read for the history)
TEMPLATE="https://namelessproxy.com/api/v1/mobile/{port}/rotate?key=API_KEY"
API_BASE="${TEMPLATE%%/v1/*}/v1"     # the API root, taken from the rotation link

# Rotate automatically every 10 minutes (allowed: 2 to 1,440)
curl -sS -X PATCH "$API_BASE/mobile/$PORT_ID" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rotation": {"mode": "interval", "intervalMinutes": 10}}'

# Back to manual rotation
curl -sS -X PATCH "$API_BASE/mobile/$PORT_ID" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rotation": {"mode": "manual", "intervalMinutes": null}}'

# The last IPs of the port (history is kept 30 days)
curl -sS "$API_BASE/mobile/$PORT_ID/ip-history?perPage=10" \
  -H "Authorization: Bearer $API_KEY"

Pourquoi est-ce que je récupère parfois la même IP ?

Les opérateurs mobiles partagent des adresses IPv4 publiques entre plusieurs abonnés via un NAT opérateur, donc le modem peut recevoir la même adresse à nouveau. Cloudflare note qu'une adresse IPv4 peut représenter des centaines voire des milliers d'utilisateurs. Comparez ip avec previousIp dans la réponse ; si elles correspondent, faites une nouvelle rotation après 30 secondes.

Quelles sont les bonnes pratiques pour faire tourner les IP mobiles ?

• Mettez le trafic en pause pendant la rotation. Les connexions ouvertes via le port se coupent quand le modem se reconnecte, donc faites la rotation entre les tâches.
• Respectez la limite. Lisez Retry-After ou nextRotationAvailableAt au lieu de relancer en boucle.
• Vérifiez l'IP via le port, pas seulement dans la réponse API.
• Gérez 409 port_not_active : le port est expiré, suspendu ou en cours de configuration.
• Relisez le point de terminaison après une relocalisation : hôte, ports et identifiants peuvent changer.
• Besoin de plusieurs IP en même temps ? Louez plusieurs ports ; un port a une IP à la fois.

Utilisez la rotation pour des usages légitimes comme les tests d'app, vérifications publicitaires et gestion des comptes clients. L'évasion de bannissement et les faux comptes sont interdits par la Politique d'Utilisation Acceptable.