# Proxy für mehrere Requests wiederverwenden

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

Erfahre, wie du denselben Proxy-Exit über Folge-Requests hinweg beibehältst, damit JavaScript-Renderings, API-Aufrufe und paginierte Abrufe alle von derselben IP ausgehen.

## Warum einen Proxy wiederverwenden

Wenn du ein Ziel zum ersten Mal anfragst, wählt FourA einen funktionierenden Proxy für dich aus. Eine Proxy- oder Auto-Response enthält die verwendete Proxy-ID. Übergib diese ID bei späteren Requests wieder und:

- Folgeseiten laufen über denselben Exit, sodass Session-Cookies und Rate Limits für das Ziel kohärent bleiben.
- Ein auf ein Land beschränkter Abruf bleibt ohne Neuauswahl innerhalb deiner Allowlist.
- Der günstige `POST /api/single/`-Endpoint sendet erneut über einen Proxy, für dessen Erkennung du bereits bezahlt hast, zu den Kosten von Single statt Proxy.

Die Proxy-ID ist ein opaker Base36-String (etwa `A1B2C3`). Niemals eine reine IP.

## Wo sich die ID in einer Response befindet

| Endpoint | Feld | Wann es vorhanden ist |
|----------|-------|-------------------|
| `POST /api/auto/` | `session.proxy` | Wenn `returnSession` den Wert `true` hat (Standard) |
| `POST /api/single/` | `proxy` (Top-Level) | Nur wenn der Request ein `proxy`-Feld übergeben hat |
| `POST /api/proxy/` | `proxy` (Top-Level) | Immer, bei Erfolg |
| `POST /api/browser/` | `proxy` (Top-Level) | Nur wenn der Request ein `proxy`-Feld übergeben hat |

Um einen neuen Exit ohne Pinning abzurufen, starte mit Auto oder Proxy. Beide ermitteln einen funktionierenden Exit und geben dessen ID für dich zurück.

## Muster 1: Auto erkennt, Single wiederholt

Optimal für Ziele, die du noch nicht kennst. Auto durchläuft die Kette einmal, danach verwendet Single die erfolgreiche Session für jede Folgeseite wieder.

```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"])
```

Lies die Session mit `.get()` aus. Eine durch einen einfachen Proxy-Fetch gewonnene Session hat `proxy` und kein `userAgent`, und manche Antworten enthalten überhaupt keine `session`.

Der Auto-Aufruf kostet genau das, was seine Ladder verbraucht. Jeder nachfolgende Single-Aufruf kostet 2 Credits (Single mit `unblocker`, Standard).

## Pattern 2: Proxy ermittelt, Browser rendert über denselben Exit

Nutze dies, wenn das Ziel ein bestimmtes Exit-Land sehen muss und der finale Inhalt JavaScript benötigt.

```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
  }'
```

Rufe `/api/proxy/` nicht erneut auf, um die Auswahl zu aktualisieren. Ein neuer Aufruf wählt möglicherweise einen anderen Exit und macht den Zweck des Pinnings zunichte. Wenn der gepinnte Exit nicht mehr funktioniert, führe einen neuen `/api/proxy/`-Aufruf aus, um einen neuen zu wählen, und fahre dann damit fort.

## Pattern 3: Einen verbrannten Exit überspringen

Wenn ein Exit, der zuvor funktioniert hat, Ablehnungen oder Verifizierungsseiten zurückgibt, weise FourA an, ihn bei der nächsten Auswahl zu meiden.

```json
{
  "maxTries": 5,
  "ignoreProxies": ["A1B2C3"],
  "request": { "method": "GET", "url": "https://example.com/data" }
}
```

`ignoreProxies` akzeptiert eine Liste von Proxy-IDs aus frueheren Responses. Es funktioniert auf `/api/proxy/` und `/api/auto/`. Die Liste wird bei jedem internen Retry beruecksichtigt, sodass ein einzelner Call mit `ignoreProxies` niemals die verbrannten Exits auswaehlt.

## Wie lange eine gepinnte Session aktiv bleibt

Der Exit selbst bleibt aktiv, solange der zugrunde liegende Proxy intakt ist, typischerweise Minuten bis Stunden. Wenn ein Replay anfaengt, Challenges, Blocks oder unerwartete Redirects zurueckzugeben, wurde der Exit wahrscheinlich rotiert oder das Ziel hat seine Clearance aktualisiert.

Zwei Optionen in diesem Fall:

1. Neuer `/api/auto/`-Call fuer dieselbe URL. Auto findet eine neue funktionierende Session; verwirf die vorherigen IDs.
2. Neuer `/api/proxy/`-Call mit `ignoreProxies: ["<burned-id>"]`, wenn du manuell weiter pinnen willst.

Session-Cookies aus einer Auto-Response laufen ebenfalls nach dem Zeitplan des Ziels ab. Manche Websites binden Clearance fuer Stunden, andere fuer Minuten. Behandle die Session wie einen Cache, nicht wie ein dauerhaftes Token.

## Wenn sich eine ID nicht pinnen laesst

Drei 400er-Fehler koennen bei einem `proxy`-Wert zurueckkommen, und sie bedeuten unterschiedliche Dinge:

| Error | Was passiert ist | Was zu tun ist |
|-------|---------------|------------|
| `Invalid proxy format` | Der Wert ist keine von FourA ausgestellte ID. Eine reine Proxy-Adresse landet hier. | Sende den opaken String aus einer Response unveraendert. |
| `Proxy not found` | Die ID wurde decodiert, loest sich aber nicht mehr zu einem aktiven Exit auf. | Verwende einen neuen Exit aus einem neuen Auto- oder Proxy-Call. |
| `Managed exit: this proxy id cannot be pinned to a request` | Die ID ist ein Premium-Exit und der Premium-Traffic deines Tarifs fuer diesen Zeitraum ist aufgebraucht, oder dein Tarif enthaelt keine Premium-Exits. | Fuehre den Call ueber `POST /api/proxy/` aus und nutze den Exit, den es auswaehlt, oder buche Premium-Traffic hinzu und pinne ihn erneut. |

Der dritte Fehler kann bei einer ID auftreten, die dir ein erfolgreicher Call geliefert hat. Du kannst ihn also erhalten, ohne etwas falsch gemacht zu haben. Behandle ihn wie eine abgelaufene Session: Weiche auf einen neuen Discovery-Call aus, statt dieselbe ID erneut zu versuchen.

## Haeufige Fehler

- **Wiederverwendung einer Proxy-ID über mehrere Accounts hinweg.** Teile IDs nicht zwischen Accounts: Eine ID, die ein Account anpinnen kann, wird für einen anderen möglicherweise abgelehnt, beispielsweise ein Premium-Exit bei einem Plan ohne Premium-Traffic.
- **Versuch, die ID zu decodieren.** Der Base36-String ist opak. Parst ihn nicht, entfernt keine Zeichen und wandelt ihn nicht in Kleinbuchstaben um. Übergebt ihn unverändert.
- **Pinning über einen Exit mit Rate Limit.** Wenn das Ziel ein Rate Limit pro IP anwendet, führt das Leiten vieler Requests über einen einzigen Exit schneller zu Sperren. Lasst Auto oder Proxy bei Workloads mit hohem Volumen über viele Exits rotieren und pinnt nur dort, wo das Ziel es zwingend erfordert.
- **Unbeabsichtigtes Pinnen eines Premium-Exits.** Eine ID aus einem Call, der über einen Premium-Exit bedient wurde (`exitClass: "premium"` bei Proxy oder Auto), pinnt einen Premium-Exit. Eine ID aus einem Premium-Auto-Call pinnt einen Premium-Exit bei Single oder Browser, aber nicht zwingend dieselbe Adresse, die Auto verwendet hat. Jeder Replay darüber wird auf deinen Premium-Traffic angerechnet und die Response enthält `X-FourA-Exit-Class: premium`.
- **Senden von `exitCountries` bei einem Plan ohne Geo-Targeting.** Länder-Scoping ist ab dem Startup-Plan enthalten. Bei einem Plan ohne dieses Feature wird ein Call mit `exitCountries` mit `403` und `X-FourA-Limit: plan_limit_feature` abgelehnt.
- **Ignorieren von `exitCountries` beim Folge-Call.** Wenn du einen Exit mit Scope pinnst und danach Proxy erneut ohne `exitCountries` aufrufst, erfolgt der Folge-Call möglicherweise über ein anderes Land. Behalte den Scope bei jedem Call bei, der ihn benötigt.

## Verwandte Themen

- [API Endpoints](https://foura.ai/docs/api/endpoints): Vollständige Referenz zu Parametern und Responses
- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch): Wie Auto die Session aufbaut, die du wiederholst
- [Geschützte Websites](https://foura.ai/docs/guides/protected-sites): Wann Pinning hilft und wann Rotation besser ist
- [Häufige Probleme](https://foura.ai/docs/troubleshooting/common-issues): `no_eligible_proxy` und andere Proxy-Fehler
- [Warum ein Proxy-Request keine Versuche mehr hatte](https://foura.ai/docs/troubleshooting/proxy-attempt-report): Interpretation von `attemptReport`, wenn ein Proxy-Call aufgibt
