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:

  1. Una nueva llamada /api/auto/ para la misma URL. Auto descubrirá una nueva sesión operativa; descarta los IDs anteriores.
  2. Una nueva llamada /api/proxy/ con ignoreProxies: ["<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 incluye X-FourA-Exit-Class: premium.
  • Enviar exitCountries en 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ía exitCountries se rechaza con un 403 y X-FourA-Limit: plan_limit_feature.
  • Ignorar exitCountries en la llamada de seguimiento. Si fijas una salida delimitada y luego vuelves a llamar a Proxy sin exitCountries, el seguimiento puede salir a través de un país diferente. Mantén el alcance en cada llamada que lo necesite.
Actualizado: 5 de noviembre de 2026