# Smart Fetch (Auto)

> URL: https://foura.ai/pl/docs/guides/smart-fetch
> Updated: 2026-11-13
> Index: https://foura.ai/llms.txt

Przekazujesz do FourA adres URL oraz regułę `validate` określającą, co powinna zawierać właściwa strona. FourA zajmuje się resztą: przechodzi przez zoptymalizowaną pod kątem kosztów drabinkę, zatrzymuje się na pierwszym szczeblu zwracającym odpowiedź zgodną z Twoimi regułami i zapamiętuje skuteczną metodę dla danego hosta, aby kolejne wywołanie dla tej samej witryny było tanie.

Ten przewodnik wyjaśnia, jak tryb auto działa pod maską, kiedy go używać i jak interpretować zwracaną odpowiedź. Opis parametrów znajdziesz w dokumentacji [API Endpoints](https://foura.ai/docs/api/endpoints#smart-fetch-auto).

## Koncepcja

Większość konfiguracji scrapingu wymaga wcześniejszego wyboru silnika. Single jest najszybszy, Proxy dodaje rotację, Browser obsługuje JavaScript. Zły wybór oznacza stratę kredytów lub blokadę.

Tryb auto odwraca ten proces. Definiujesz warunek sukcesu (`validate`), a nie metodę. FourA sprawdza kolejne szczeble drabinki, aż któryś zadziała:

1. **Tani test** (single, bezpośrednio z sieci własnej FourA)
2. **Browser**, bezpośrednio z sieci własnej FourA, z obsługą JavaScript i modułem rozwiązującym wyzwania, jeśli witryna je wyświetli
3. **Single z rotowanym proxy**
4. **Browser przez proxy** dla najtrudniejszych celów

Tryb auto zatrzymuje się natychmiast, gdy dany szczebel zwróci odpowiedź akceptowaną przez regułę `validate`.

Jeden ze szczebli działa poza tą kolejnością. Gdy węzeł wyjściowy łączy się z witryną, ale witryna odrzuca żądany głęboki adres URL, tryb auto pobiera stronę główną witryny przez ten sam węzeł wyjściowy, zachowuje zwrócone pliki cookie i ponawia zapytanie pod Twój adres URL wraz z nimi. To jest szczebel `warmup`. Uruchamia się tylko dla adresów URL głębszych niż katalog główny witryny, wyłącznie po nieudanej próbie bezpośredniej, i może jedynie poprawić wynik, nigdy go pogorszyć.

`forceProxy` ma domyślnie wartość `true`, więc szczeble 1 i 2 są pomijane, a cel nigdy nie widzi własnego adresu FourA. Większość wywołań kończy się wtedy na szczeblu 3 lub na powtórzeniu wcześniej rozgrzanej sesji. Ustaw `forceProxy: false`, gdy wiesz, że cel traktuje czysty adres lepiej niż rotowany, a szczeble 1 i 2 zostaną przywrócone.

## Co wysyłasz

Wymagane minimum to adres URL oraz podciąg `validate`. Tryb auto samodzielnie rozpoznaje typowe strony z wyzwaniami, ale bez parametru `validate.data.accept` nie odróżni właściwej strony od nieznanej strony weryfikacyjnej ani od strony załadowanej bez Twojej zawartości i może zwrócić dowolną z nich jako sukces.

```bash
curl -X POST https://eu.api.foura.ai/api/auto/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/product/42",
    "validate": {"data": {"accept": ["Add to cart"]}}
  }'
```

Opcjonalne parametry (zobacz [dokumentację endpointu](https://foura.ai/docs/api/endpoints#smart-fetch-auto), aby poznać pełne szczegóły):

- `returnSession` (domyślnie `true`): zwraca zwycięski `{ proxy, cookies, userAgent }`, aby można go było odtworzyć.
- `forceProxy` (domyślnie `true`): pomija poziomy z bezpośrednim ruchem wychodzącym. Ustaw `false` tylko wtedy, gdy wiesz, że strona lepiej reaguje na czyste IP niż na rotowane węzły wyjściowe.
- `timeout_ms` (domyślnie `120000`): łączny limit czasu dla całego wywołania. Mechanizm drabinkowy dzieli go pomiędzy poszczególne poziomy.
- `ignoreProxies`: identyfikatory proxy do pominięcia przy każdej próbie cząstkowej.
- `followRedirects` (domyślnie `5`): maksymalna liczba przekierowań na tańszych poziomach.
- `headers`: nagłówki wysyłane do witryny w postaci par `[name, value]`. Są one wysyłane w żądaniach Single i Proxy, w tym podczas wyszukiwania działającego węzła wyjściowego; poziomy przeglądarkowe ich nie wysyłają. Twój własny `Cookie` trafia do witryny bez zmian, a pliki cookie z aktywnej sesji są dodawane obok niego wyłącznie pod nazwami, których nie przesłano. Gdy aktywna sesja zawiera `userAgent`, zastępuje on Twój `User-Agent`. Nagłówki warunkowe, takie jak `If-None-Match` i `If-Modified-Since`, są pomijane podczas wyszukiwania węzła wyjściowego, chyba że Twój `validate.status.accept` zawiera `304`.
- `exitClass`: `premium` pozwala trybowi Auto na eskalację do węzła premium, gdy standardowa pula nie może dotrzeć do strony; `standard` oznacza brak eskalacji. Wymaga planu obejmującego węzły wyjściowe premium. Zobacz [exitClass w Smart Fetch](https://foura.ai/docs/api/endpoints#exitclass-on-smart-fetch).

## Co otrzymujesz w odpowiedzi

```json
{
  "status": 200,
  "data": "<!doctype html>...",
  "headers": [{"content-type": "text/html"}],
  "meta": {
    "rung": "cache",
    "solved": false,
    "attempts": 1,
    "credits": 2,
    "attemptsByEngine": {"single": 1, "proxy": 0, "browser": 0},
    "browserRequests": 0
  },
  "session": {
    "proxy": "A1B2C3",
    "cookies": [{"name": "session", "value": "abc", "domain": "example.com"}],
    "userAgent": "Mozilla/5.0..."
  }
}
```

Trzy elementy do odczytania:

- **`status` i `data`**: odpowiedź celu. `data` jest tekstem niezależnie od tego, który szczebel obsłużył stronę, więc strona JSON przychodzi jako tekst JSON i przetwarzasz go samodzielnie. `status` to status HTTP celu, a nie status transportowy Twojego wywołania do FourA. Dla szczebli single i proxy `headers` jest tablicą per-hop. Dla szczebli browser `headers` jest płaskim obiektem.
- **`meta`**: ślad tego, co zrobiła drabina, obecny w każdej odpowiedzi po jej uruchomieniu. `meta.rung` wskazuje krok, który dostarczył odpowiedź, `meta.attempts` zlicza próby podwywołań, `meta.solved` oznacza, czy rozwiązano stronę z wyzwaniem, a `meta.credits` to całkowity koszt wywołania (ta sama liczba co w nagłówku `X-FourA-Credits`). `meta.attemptsByEngine` i `meta.browserRequests` określają, co wysłało wywołanie: zobacz [What a Call Spent](#what-a-call-spent). Gdy żądanie wskazywało `exitClass`, `meta.exitClass` informuje, która klasa wyjścia zrealizowała odpowiedź.
- **`session`**: trójka `{ proxy, cookies, userAgent }`, która poradziła sobie z celem. Użyj jej do powtórzenia żądań do tego samego hosta przez `/api/single/` lub `/api/browser/`. Pole może być pominięte: sesja uzyskana przez zwykłe pobranie proxy ma `proxy`, ale nie ma `userAgent`, a jej lista `cookies` zawiera wyłącznie pliki cookie ustawione przez stronę weryfikacyjną przed zaserwowaniem właściwej strony, więc często jest pusta. Odpowiedź z taniej bezpośredniej próby zawiera `session` tylko wtedy, gdy taka strona weryfikacyjna ustawiła pliki cookie, i wtedy zawiera wyłącznie `cookies`. Status zwrócony przez węzeł wyjściowy, który znajduje się na Twojej liście `validate.status.accept` (taki jak `404` dla usuniętej strony), nie ma żadnego `session`.

Auto odpowiada kodem HTTP 200 zawsze, gdy drabina została uruchomiona, nawet jeśli każdy szczebel zawiódł. Sprawdź `status` i `error` w treści, aby dowiedzieć się, co się stało, a nie transportowy kod statusu. Kod inny niż 200 z `/api/auto/` oznacza, że wywołanie nigdy nie dotarło do drabiny: 401 dla nieprawidłowego klucza, 400 dla treści niebędącej poprawnym JSON, celu w sieci prywatnej, celu na własnym hoście API FourA lub adresu URL z niezakodowaną spacją wewnątrz, 403 z `X-FourA-Limit: plan_limit_premium` dla `exitClass: premium` w planie bez wyjść premium oraz 502, 503 lub 504, gdy usługa nie mogła przyjąć wywołania lub upłynął limit czasu. Auto nie zajmuje slotu na bramie, więc współdzielone limity platformy nie odrzucają samego wywołania: gdy któryś z nich odrzuci wywołanie wykonane przez drabinę, odpowiedź to HTTP 200 z `status: 429` lub `503` oraz `retryAfter` w treści. Pole, które nie przejdzie walidacji, również wraca jako HTTP 200, z `status: 400`. Limit planu osiągnięty wewnątrz drabiny także wraca jako HTTP 200 z odmową w treści (zobacz [When Your Plan's Limits Meet the Ladder](#when-your-plans-limits-meet-the-ladder)).

## Ponowne użycie z sesją

Gdy auto zwróci sesję, możesz przejść bezpośrednio do Single lub Browser dla kolejnych stron na tym samym hoście. Bez ponownego przechodzenia drabiny, bez nowej próby.

```python
import requests

API = "https://eu.api.foura.ai"
KEY = "YOUR_API_KEY"
H = {"X-API-Key": KEY, "Content-Type": "application/json"}

# 1) First call: let auto figure it out.
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")

# 2) Follow-up pages: replay through single with the same proxy, UA 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
    r = requests.post(f"{API}/api/single/", headers=H, json=body).json()
    print(sku, r["status"])
```

Sesja jest trwała tylko tak długo, jak pozwala na to strona docelowa. Niektóre witryny wiążą autoryzację z plikami cookie na wiele godzin, inne odnawiają ją co kilka minut. Jeśli odtworzenie żądania ponownie zacznie zwracać challenge, wywołaj `/api/auto/` jeszcze raz, aby odświeżyć sesję.

## Kiedy używać trybu Auto

| Użyj auto | Użyj ręcznie single, proxy lub browser |
|----------|----------------------------------------|
| Odpytujesz nową stronę i nie wiesz, czego wymaga | Wiesz już, który silnik działa |
| Chcesz jednego wywołania, które automatycznie obsłuży proxy i fallback do przeglądarki | Chcesz pełnej kontroli nad ponowieniami i limitami czasu dla każdego wywołania |
| Możesz poświęcić kilka sekund na badanie strony przy pierwszym wywołaniu | Opóźnienie pierwszego wywołania ma większe znaczenie niż wykrywanie konfiguracji |
| Chcesz zapamiętanej sesji, którą można tanio odtwarzać | Optymalizujesz szybką pętlę dla znanego, działającego celu |

Auto nie zawsze jest najtańszym wyborem. Jeśli wiesz, że cel działa z `single` + `unblocker`, bezpośrednie wywołanie Single kosztuje 2 kredyty i zapewnia przewidywalne opóźnienie. Tryb Auto dla tego samego celu kosztuje tyle, ile zużyje jego sekwencja prób, co może być droższe, jeśli strona wymaga eskalacji.

## Parametr Validate definiuje sukces dla Auto

Najważniejszym parametrem jest `validate`. Bez niego tryb auto odrzuca tylko te strony challenge, które sam rozpoznaje, więc nietypowa strona weryfikacji lub pusty szablon zwrócony z kodem HTTP 200 zostanie uznany za poprawną treść.

Użyj `validate.data.accept` z fragmentem tekstu, który zawiera wyłącznie właściwa strona:

```json
{
  "validate": {
    "data": {
      "accept": ["sku-42-add-to-cart", "Customer reviews"]
    }
  }
}
```

W przypadku API JSON akceptuj oczekiwaną nazwę pola:

```json
{
  "validate": {
    "data": { "accept": ["\"products\":["] },
    "status": { "accept": [200] }
  }
}
```

W przypadku witryn, które prawidłowo zwracają status inny niż 200 (ograniczenie regionalne, które chcesz zignorować, `404` lub `410` usuniętej strony), zezwól na nie za pomocą `validate.status.accept`:

```json
{
  "validate": {
    "status": { "accept": [200, 451] }
  }
}
```

Tryb auto zwraca status wymieniony w `validate.status.accept`, gdy tylko węzeł wyjściowy go odeierze i spełni pozostałe warunki reguły. Wyjątkiem są cztery statusy: `202`, `403`, `429` oraz `503`. Tryb auto interpretuje je jako weryfikację tożsamości klienta przez witrynę, więc odebranie jednego z nich nie kończy wyszukiwania, a drabina kontynuuje eskalację.

Bez `validate` tryb auto stosuje domyślną zasadę "HTTP 200 = sukces" dla każdej strony, której nie rozpozna jako challenge, więc pominie nieznaną stronę weryfikacyjną zwróconą z kodem 200.

## Odczytywanie `meta.rung` w celu analizy przebiegu

`meta.rung` to najbardziej przydatny sygnał debugowania. Wartości:

- `probe`: obsłużone przez tanie bezpośrednie request. Najtańsza ścieżka.
- `proxy`: wymagało rotacji proxy, aby przejść.
- `browser`: wymagało pełnego renderowania w przeglądarce, prawdopodobnie z rozwiązaniem challenge.
- `cache`: odtworzyło aktywną sesję z wcześniejszego wywołania auto. Najtańsza ścieżka przy powtarzanych wywołaniach.
- `warmup`: witryna zwróciła stronę główną, ale zablokowała głęboki URL, więc tryb auto najpierw pobrał stronę główną, zachował otrzymane pliki cookie i ponowił request z ich użyciem. Sesja zapisana na tym szczeblu nie jest przypisana do jednego węzła wyjściowego, więc kolejne wywołania trafiają na tanie szczeble.
- `fail`: żaden szczebel nie zwrócił odpowiedzi zaakceptowanej przez Twoje reguły.

`meta.solved: true` oznacza, że podczas wywołania napotkano i ukończono stronę challenge. `meta.attempts` określa liczbę prób podwywołań przed osiągnięciem sukcesu. Szczegółowe informacje na ten temat zawiera pole `defense` zwracane przez szczeble direct i proxy: zobacz [Weryfikacje witryny](https://foura.ai/docs/api/site-checks).

Jeśli witryna stale kończy na `browser`, gdy oczekiwano `probe`, sprawdź, czy bardziej restrykcyjna (lub mniej restrykcyjna) reguła `validate` pozwoliłaby zaliczyć tańszy szczebel. Pamiętaj, że `forceProxy` ma domyślnie wartość `true`, więc próba bezpośredniego wyjścia jest pomijana, chyba że zostanie wyłączona.

## Koszt wywołania

`meta.attemptsByEngine` zlicza requesty wysłane przez wywołanie do każdego silnika. Są to te same requesty, które panel prób Auto wyświetla w sekcji [Przegląd](https://foura.ai/docs/dashboard/overview). `meta.browserRequests` zlicza te, które wykorzystały slot z Twojego dziennego limitu przeglądarki.

```json
"meta": {
  "rung": "browser",
  "solved": true,
  "attempts": 7,
  "credits": 47,
  "attemptsByEngine": {"single": 1, "proxy": 4, "browser": 3},
  "browserRequests": 2
}
```

| Pole | Typ | Opis |
|-------|------|-------------|
| `meta.attemptsByEngine` | object | Żądania wysłane do `single`, `proxy` i `browser`. Żądanie przeglądarki odrzucone przez Twój plan wlicza się tutaj, ponieważ zostało wysłane. |
| `meta.browserRequests` | number | Żądania przeglądarki, które zużyły slot z Twojego dziennego limitu. Żądanie przeglądarki odrzucone przez Twój plan niczego nie zużywa. |

`meta.attempts` zlicza kroki drabiny, więc nie zawsze równa się sumie `meta.attemptsByEngine`. Jeden krok może wysłać żądanie Single, a następnie żądanie Proxy, natomiast krok, którego przeglądarka jest już wyłączona na dany dzień, nie wysyła niczego.

Bieżący stan licznika dla danego dnia jest przekazywany w nagłówkach `X-FourA-Browser-Used-Today` i `X-FourA-Browser-Limit-Per-Day`: zobacz [Response Headers](https://foura.ai/docs/api/response-headers).

## Błędy i przypadki brzegowe

Gdy auto zawiedzie, odpowiedź zawiera `status` (zazwyczaj status ostatniego nieudanego szczebla) oraz ciąg znaków `error`:

```json
{
  "status": 502,
  "error": "could not find a working exit for the target",
  "attempts": 7,
  "attemptReport": {
    "total": 7,
    "noResponse": 5,
    "defense": 2,
    "contentRejected": 0,
    "statusRejected": 0,
    "other": 0,
    "vendors": ["datadome"],
    "summary": "7 attempt(s): 5 got no answer from the site; 2 refused by the site (datadome)"
  },
  "meta": {
    "rung": "fail",
    "solved": false,
    "attempts": 7,
    "credits": 47,
    "attemptsByEngine": {"single": 0, "proxy": 4, "browser": 3},
    "browserRequests": 3
  }
}
```

`status` to odpowiedź witryny z ostatniej próby odrzuconej przez Auto, na przykład `403`. Gdy żadna próba nie uzyskała żadnej odpowiedzi z witryny, jest to zwykle `502` lub `504`, a `error` wskazuje, czy nie znaleziono działającego węzła wyjściowego, czy wyczerpał się budżet `timeout_ms`. `status: 0` oznacza jedynie, że nazwa hosta celu nie została rozwiązana, a ta odpowiedź nie zawiera `meta`, ponieważ drabina w ogóle nie wystartowała.

Auto zatrzymuje się również wcześniej, gdy jego przeglądarka stale napotyka weryfikację, której nie może ukończyć. Po tym, jak dwa węzły wyjściowe odrzucą przeglądarkę w ten sposób, a wyszukiwanie węzła, którego zwykłe pobranie spełnia regułę `validate`, zakończy się niepowodzeniem, lub po trzech takich węzłach wyjściowych, wywołanie kończy się. `status` zawiera ostatnią odpowiedź witryny, a `error` zaczyna się od `the browser was refused by`, po którym następuje nazwa systemu weryfikacji.

Auto zatrzymuje się także wtedy, gdy sama witryna informuje, że strona nie istnieje. Gdy dwa węzły wyjściowe zwrócą ten sam `404` lub `410`, a Twoje reguły go nie akceptują, wywołanie kończy się z tym `status`, a `error` zaczyna się od `the site answered`. Jeśli usunięta strona jest odpowiedzią, której oczekujesz, wskaż `404` lub `410` w `validate.status.accept`: Auto zwróci ją wtedy jako dostarczoną, gdy tylko węzeł wyjściowy ją odeierze.

Gdy cztery kolejne wywołania Auto z użyciem Twojego klucza API zakończą się brakiem strony z powodu ciągłych odmów witryny, Auto wstrzymuje próby dla tej witryny dla Twojego klucza na 120 sekund. Wywołanie wykonane w tym czasie odpowiada natychmiast kodem `status: 503`, nagłówkiem `error: "target temporarily unservable, retry later"` oraz wartością `retryAfter` w sekundach i nic nie kosztuje. Jest to zliczane na klucz API: inne klucze wywołujące tę samą witrynę nie są dotknięte ograniczeniem, a każde wywołanie, które pobierze stronę, resetuje licznik. Wywołanie z `exitClass: premium` nie jest przez to blokowane.

Sprawdź `attemptReport`, `meta.attemptsByEngine` i `meta.credits`, aby zobaczyć, na co został zużyty budżet. Jeśli `meta.attempts` ma wysoką wartość, a `meta.rung` to `fail` po etapie przeglądarki, cel może wymagać dłuższego `timeout_ms`, bardziej rygorystycznej reguły `validate` lub po prostu nie jest obecnie osiągalny przez rotacyjne proxy.

### Dlaczego wywołanie Auto nie powiodło się

Każda nieudana odpowiedź z uruchomionej drabiny zawiera `attemptReport`. Zlicza ona żądania silnika, które powróciły bez strony, każde dokładnie raz, w kategorii tego, co napotkały.

| Pole | Typ | Opis |
|-------|------|-------------|
| `total` | integer | Liczba requestów, które wróciły bez strony. Maksymalnie suma `meta.attemptsByEngine`, ponieważ request browser odrzucony przez Twój plan nigdy nie próbował połączyć się z celem. |
| `noResponse` | integer | Brak odpowiedzi ze strony |
| `defense` | integer | Strona odrzuciła request: rozpoznano weryfikację botów, strona zawierała challenge lub strona zwróciła status 401, 403, 429 albo 503 |
| `contentRejected` | integer | Strona została pobrana i odrzuciła ją wyłącznie Twoja reguła `validate` |
| `statusRejected` | integer | Strona zwróciła status, którego Twój request nie akceptuje, na przykład 404 dla usuniętej strony |
| `other` | integer | Niepowodzenie z innego powodu, na przykład błędu serwera |
| `vendors` | string[] | Dostawcy weryfikacji botów rozpoznani przy odrzuceniach, na które napotkało wywołanie |
| `summary` | string | Jedno zdanie zbudowane na podstawie liczników, bezpieczne do logowania. Wskazuje status HTTP zwrócony przez stronę, gdy nie rozpoznano żadnego dostawcy, oraz informuje, kiedy wyczerpał się dzienny limit browser, uniemożliwiając uruchomienie przeglądarki. |

Pola są zgodne z raportem nieudanego wywołania [Proxy](https://foura.ai/docs/troubleshooting/proxy-attempt-report), z wyłączeniem `profilesTried`. Różnią się dwie rzeczy. Proxy zlicza każdy wypróbowany węzeł wyjściowy, maksymalnie do wartości `maxTries` ustawionej przez Ciebie, natomiast Auto zlicza własne requesty. Auto odczytuje również stronę i jej status, więc odmowa jest zliczana w `defense`, nawet jeśli nie rozpoznano żadnego dostawcy. Wartość w `contentRejected` możesz naprawić samodzielnie: strona została zwrócona, ale Twoja reguła do niej nie pasowała.

### Kiedy limity Twojego planu napotykają drabinkę

Podwywołania Auto to zwykłe requesty Single, Proxy i Browser w ramach Twojego klucza, więc mają do nich zastosowanie [limity Twojego planu](https://foura.ai/docs/api/rate-limits). Drabinka odczytuje kod `X-FourA-Limit` przy odmowie i traktuje oba rodzaje odmiennie.

**Zablokowany szczebel pozostawia resztę drabinki zdatną do użytku.** `plan_limit_browser_daily` (dzienne requesty Browser zostały wyczerpane) oraz `plan_limit_concurrency` (ten endpoint obsługuje już maksymalną liczbę Twoich requestów dozwoloną w planie) zamykają jeden szczebel. Auto nadal korzysta z pozostałych szczebli, więc nadal otrzymujesz stronę, gdy rotacyjny węzeł wyjściowy lub aktywna sesja zwrócą treść. Użyte węzły wyjściowe nie są obwiniane za odmowę wynikającą z Twojego własnego planu. Nic nie zostaje zablokowane i żadna sesja nie zostaje utracona.

**Konto, na którym wyczerpano zasoby, zatrzymuje drabinkę.** W przypadkach `plan_limit_credits`, `plan_limit_bandwidth`, `plan_limit_rate`, `plan_limit_feature` i `plan_limit_premium` żaden inny szczebel nie pomoże, więc Auto zwraca odpowiedź natychmiast, zamiast zużywać kolejne kredyty na potwierdzenie tego faktu. Informacja o odmowie wraca w body ze statusem podwywołania i tym samym polem `reason`, którego używają bezpośrednie endpointy:

```json
{
  "status": 429,
  "error": "Credit limit reached: 300,000 of 300,000 credits used this billing period. Upgrade your plan or wait for the reset.",
  "reason": "plan_limit_credits",
  "documentation": "https://foura.ai/prices",
  "used": 300000,
  "hard_stop": 300000,
  "retry_after_seconds": 86400,
  "resets_at": "2026-10-01T00:00:00.000Z",
  "meta": { "rung": "fail", "solved": false, "attempts": 1, "credits": 0 }
}
```

Przekazywana jest cala tresc odmowy z podwywolania, a takze `status`, `attemptReport` oraz `meta`. Odczytuj `status` z tresci odpowiedzi, a nie ze statusu warstwy transportowej: auto nadal zwraca tutaj HTTP 200, poniewaz drabina zostala wykonana. Odmowa typu `plan_limit_feature` lub `plan_limit_premium` trafia w ten sam sposob z kodem `status: 403`. Odrzucone podwywolanie nie zuzywa srodkow, wiec `meta.credits` zlicza tylko te szczeble, ktore dotarly do celu.

Jedno wywolanie auto moze zajmowac kilka slotow podczas przechodzenia po szczeblach drabiny, wiec rownolegla partia wywolan auto osiaga limit wspolbieznosci przy mniejszej liczbie wywolan, niz mozna by sie spodziewac. Rozdzial [Run Requests in Parallel](https://foura.ai/docs/how-to/run-requests-in-parallel) opisuje dobieranie wielkosci partii.

## Czego tryb auto nie robi

- Nie modyfikuje ograniczen prawnych. Jesli serwis odrzuca kazdy wezel wyjsciowy osiagalny dla FourA, tryb auto zwroci te odmowe.
- Nie buforuje zawartosci. Kazde wywolanie bezposrednio trafia do celu. Rozgrzana sesja dotyczy serwera proxy i plikow cookie, a nie tresci response.
- Stanowi jeden wiersz w [Activity Log](https://foura.ai/docs/dashboard/activity-log), pod otrzymanym identyfikatorem request, z suma kredytow jego podwywolan. Po jego otwarciu podwywolania Single / Proxy / Browser wykonane automatycznie w Twoim imieniu sa widoczne jako proby, kazda z wlasnym wynikiem. Wliczaja sie one do limitow Single, Proxy oraz Browser, ale nigdy do calkowitej liczby request ani wskaznika sukcesu.

## Powiazane materialy

- [API Endpoints](https://foura.ai/docs/api/endpoints#smart-fetch-auto): Pelna dokumentacja parametrow
- [Choosing the Right Endpoint](https://foura.ai/docs/guides/choosing-task-type): Kiedy wybierac auto, a kiedy single, proxy lub browser
- [Request Outcomes](https://foura.ai/docs/api/outcomes): Ktore wyniki podlegaja oplatom
- [Protected sites](https://foura.ai/docs/guides/protected-sites): Dzialanie FourA w serwisach weryfikujacych tozsamosc klienta
- [Site checks](https://foura.ai/docs/api/site-checks): Pole `defense` powiazane z `meta.solved`
- [MCP Recipes](https://foura.ai/docs/mcp/recipes): Te same wzorce w postaci wywolan narzedzi MCP
- [Rate Limits](https://foura.ai/docs/api/rate-limits): Limity planu, wedlug ktorych rozliczane sa podwywolania auto
