# Reutiliza un proxy entre peticiones

> URL: https://foura.ai/es/docs/how-to/reuse-a-proxy
> Updated: 2026-11-05
> Index: https://foura.ai/llms.txt

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.

```python
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.

```bash
# 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.

```json
{
  "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.

## Relacionado

- [API Endpoints](https://foura.ai/docs/api/endpoints): Referencia completa de parámetros y respuestas
- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch): Cómo Auto construye la sesión que reproduces
- [Protected sites](https://foura.ai/docs/guides/protected-sites): Cuándo ayuda fijar y cuándo es mejor la rotación
- [Common Issues](https://foura.ai/docs/troubleshooting/common-issues): `no_eligible_proxy` y otros errores de proxy
- [Why a Proxy Request Ran Out of Tries](https://foura.ai/docs/troubleshooting/proxy-attempt-report): Cómo interpretar `attemptReport` cuando una llamada de Proxy se rinde
