Reutiliza un proxy entre peticiones
Aprende a mantener la misma salida de proxy en las peticiones de seguimiento, de modo que los renders de JavaScript, las llamadas a la API y las extracciones paginadas salgan desde la misma IP.
Por qué reutilizar un proxy
La primera vez que consultas un objetivo, FourA elige un proxy funcional para ti. Una respuesta de Proxy o Auto incluye el ID del proxy utilizado. Pasa ese ID de vuelta en las siguientes peticiones y:
- Las páginas de seguimiento saldrán por la misma salida, manteniendo las cookies de sesión y los rate limits coherentes ante el objetivo.
- Una extracción limitada por país se mantiene dentro de tu allowlist sin necesidad de una nueva selección.
- El económico endpoint
POST /api/single/repite la petición a través de un proxy que ya pagaste por descubrir, al coste de Single en lugar del de Proxy.
El ID de proxy es una cadena base36 opaca (algo parecido a A1B2C3). Nunca una IP sin procesar.
Dónde reside el ID en una respuesta
| Endpoint | Campo | Cuándo está presente |
|---|---|---|
POST /api/auto/ |
session.proxy |
Cuando returnSession es true (el valor predeterminado) |
POST /api/single/ |
proxy (nivel superior) |
Solo cuando la petición suministró un campo proxy |
POST /api/proxy/ |
proxy (nivel superior) |
Siempre, en caso de éxito |
POST /api/browser/ |
proxy (nivel superior) |
Solo cuando la petición suministró un campo proxy |
Para obtener una nueva salida sin fijar una existente, empieza con Auto o Proxy. Ambos descubren una salida funcional y devuelven su ID para que lo uses.
Patrón 1: Auto descubre, Single reproduce
Ideal cuando tienes un objetivo que aún no conoces. Auto recorre la escala una vez y, a continuación, Single reutiliza la sesión ganadora para cada página de seguimiento.
import requests
API = "https://eu.api.foura.ai"
H = {"X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json"}
# Step 1: discover a working exit with Auto.
r = requests.post(f"{API}/api/auto/", headers=H, json={
"url": "https://example.com/product/42",
"validate": {"data": {"accept": ["Add to cart"]}}
}).json()
session = r.get("session") or {}
proxy = session.get("proxy")
user_agent = session.get("userAgent")
# Step 2: paginate with Single, reusing the same exit, User-Agent and cookies.
for sku in ("43", "44", "45"):
body = {"method": "GET", "url": f"https://example.com/product/{sku}"}
if proxy:
body["proxy"] = proxy
headers = []
if user_agent:
headers.append(["User-Agent", user_agent])
if session.get("cookies"):
headers.append(["Cookie", "; ".join(f"{c['name']}={c['value']}" for c in session["cookies"])])
if headers:
body["headers"] = headers
p = requests.post(f"{API}/api/single/", headers=H, json=body).json()
print(sku, p["status"])
Lee la sesión con .get(). Una sesión obtenida mediante una petición proxy básica tiene proxy y ningún userAgent, y algunas respuestas no incluyen ningún session.
La llamada Auto cuesta lo que gaste su escala. Cada llamada Single de seguimiento cuesta 2 créditos (Single con unblocker, el valor predeterminado).
Patrón 2: Proxy descubre, Browser renderiza a través de la misma salida
Usa esto cuando el destino deba ver un país de salida específico y el contenido final requiera JavaScript.
# Step 1: pick a country-scoped exit with Proxy.
curl -X POST https://eu.api.foura.ai/api/proxy/ \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"maxTries": 5,
"exitCountries": ["FR", "GB"],
"request": {"method": "GET", "url": "https://example.com/pricing"}
}'
# Response includes: "proxy": "A1B2C3", "exitCountry": "FR"
# Step 2: render the JS-heavy page through THAT exit.
curl -X POST https://eu.api.foura.ai/api/browser/ \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com/pricing",
"proxy": "A1B2C3",
"timeout_ms": 20000
}'
No llames a /api/proxy/ de nuevo para refrescar la selección. Una nueva llamada puede elegir una salida distinta y anular el propósito de la fijación. Si la salida fijada deja de funcionar, ejecuta una llamada /api/proxy/ nueva para elegir una diferente y continúa con ella.
Patrón 3: Omitir una salida quemada
Si una salida que solía funcionar empieza a devolver rechazos o páginas de verificación, indícale a FourA que la evite en la siguiente selección.
{
"maxTries": 5,
"ignoreProxies": ["A1B2C3"],
"request": { "method": "GET", "url": "https://example.com/data" }
}
ignoreProxies acepta una lista de proxy IDs de respuestas anteriores. Funciona en /api/proxy/ y /api/auto/. La lista se respeta en cada reintento interno, por lo que una sola llamada con ignoreProxies nunca elige los nodos de salida quemados.
Cuánto tiempo permanece activa una sesión fijada
El nodo de salida permanece activo mientras el proxy subyacente esté en buen estado, normalmente de minutos a horas. Si una repetición comienza a devolver desafíos, bloqueos o redirecciones inesperadas, es probable que el nodo de salida haya rotado o que el destino haya renovado su autorización.
Tienes dos opciones cuando eso sucede:
- Una nueva llamada
/api/auto/para la misma URL. Auto descubrirá una nueva sesión operativa; descarta los IDs anteriores. - Una nueva llamada
/api/proxy/conignoreProxies: ["<burned-id>"]si quieres seguir fijando manualmente.
Las cookies de sesión de una respuesta de Auto también caducan según el cronograma del propio destino. Algunos sitios vinculan la autorización durante horas; otros, durante minutos. Trata la sesión como una caché, no como un token duradero.
Cuando un ID no se puede fijar
Un valor de proxy puede devolver tres errores 400 distintos, y significan cosas diferentes:
| Error | Qué ocurrió | Qué hacer |
|---|---|---|
Invalid proxy format |
El valor no es un ID emitido por FourA. Una dirección de proxy sin procesar cae aquí. | Envía la cadena opaca de una respuesta, textualmente. |
Proxy not found |
El ID se decodificó, pero ya no resuelve a un nodo de salida activo. | Obtén un nuevo nodo de salida desde una nueva llamada a Auto o Proxy. |
Managed exit: this proxy id cannot be pinned to a request |
El ID es un nodo de salida premium y el tráfico premium de tu plan para este período se ha agotado, o tu plan no incluye nodos de salida premium. | Ejecuta la llamada a través de POST /api/proxy/ y toma cualquier nodo de salida que elija, o añade tráfico premium y fíjalo de nuevo. |
El tercero se produce a partir de un ID que te entregó una llamada exitosa, por lo que puedes recibirlo sin haber hecho nada mal. Trátalo como tratarías una sesión caducada: recurre a una nueva llamada de descubrimiento en lugar de reintentar el mismo ID.
Errores comunes
- Reutilizar un proxy ID entre cuentas. No compartas IDs entre cuentas: un ID que una cuenta puede fijar puede ser rechazado en otra, por ejemplo una salida premium en un plan sin tráfico premium.
- Intentar decodificar el ID. La cadena base36 es opaca. No la analices, no elimines caracteres y no la conviertas a minúsculas. Envíala de vuelta tal cual.
- Fijar a través de una salida con rate limit. Si el objetivo aplica rate limit por IP, canalizar muchas solicitudes a través de una sola salida provocará bloqueos más rápido. Para cargas de trabajo de alto volumen, permite que Auto o Proxy roten a través de muchas salidas y fija solo cuando el objetivo realmente lo requiera.
- Fijar una salida premium sin intención. Un ID proveniente de una llamada atendida por una salida premium (
exitClass: "premium"en Proxy o Auto) fija una salida premium. Un ID de una llamada premium de Auto fija una salida premium en Single o Browser, pero no necesariamente la dirección que usó Auto. Cada repetición a través de ella cuenta contra tu tráfico premium, y la respuesta incluyeX-FourA-Exit-Class: premium. - Enviar
exitCountriesen un plan sin geo targeting. La delimitación por país se incluye a partir del plan Startup. En un plan que no la incluye, una llamada que envíaexitCountriesse rechaza con un403yX-FourA-Limit: plan_limit_feature. - Ignorar
exitCountriesen la llamada de seguimiento. Si fijas una salida delimitada y luego vuelves a llamar a Proxy sinexitCountries, el seguimiento puede salir a través de un país diferente. Mantén el alcance en cada llamada que lo necesite.
Relacionado
- API Endpoints: Referencia completa de parámetros y respuestas
- Smart Fetch (Auto): Cómo Auto construye la sesión que reproduces
- Protected sites: Cuándo ayuda fijar y cuándo es mejor la rotación
- Common Issues:
no_eligible_proxyy otros errores de proxy - Why a Proxy Request Ran Out of Tries: Cómo interpretar
attemptReportcuando una llamada de Proxy se rinde