Wybór odpowiedniego endpointu

FourA oferuje trzy endpointy API, z których każdy jest zoptymalizowany pod kątem innych scenariuszy. Wybór właściwego pozwala zaoszczędzić czas, obniżyć koszty i zwiększyć skuteczność.

Szybki przewodnik wyboru

Użyj endpointu single, gdy:

Strona docelowa jest renderowana po stronie serwera (nie wymaga JavaScriptu)
Potrzebujesz maksymalnej prędkości (zazwyczaj poniżej 1 sekundy)
Pobierasz dane z API lub statycznych stron HTML

Użyj endpointu browser, gdy:

Strona opiera się na JavaScripcie do renderowania zawartości
Zawartość ładuje się dynamicznie po początkowym załadowaniu strony
Potrzebujesz w pełni wyrenderowanego DOM

Użyj endpointu proxy, gdy:

Strona docelowa aktywnie blokuje żądania
Musisz rotować wiele adresów IP
Poprzednie próby zakończyły się błędem 403 lub stroną z CAPTCHA

Porównanie endpointów

Single (`POST /api/single/`)

Najszybsza opcja. Wysyła żądanie HTTP z realistyczną charakterystyką sieciową przypominającą przeglądarkę, bez uruchamiania procesu przeglądarki.

curl -X POST https://eu.api.foura.ai/api/single/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method": "GET", "url": "https://example.com/api/products", "unblocker": true}'

Typowy czas odpowiedzi: od 200 ms do 2 s Najlepsze dla: API, serwisów informacyjnych, blogów, statycznych stron produktów

Browser (`POST /api/browser/`)

Otwiera podany URL w instancji przeglądarki Chrome. Strona ładuje się w pełni, wykonuje się JavaScript, a Ty otrzymujesz ostateczny, wyrenderowany HTML.

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/spa-app",
    "timeout_ms": 15000,
    "checkText": "data-table"
  }'

Typowy czas odpowiedzi: od 2 s do 10 s Najlepsze dla: aplikacji jednostronicowych (SPA), stron z leniwym ładowaniem (lazy loading), zawartości renderowanej przez JavaScript

Proxy (`POST /api/proxy/`)

Łączy żądania HTTP z automatyczną rotacją proxy. Jeśli pierwsza próba nie powiedzie się lub zostanie zablokowana, FourA ponawia próbę przy użyciu innych 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,
    "request": {
      "method": "GET",
      "url": "https://example.com/pricing",
      "unblocker": true
    }
  }'

Typowy czas odpowiedzi: od 1 s do 5 s Najlepsze dla: monitorowania cen e-commerce, agregatorów ofert turystycznych, stron z systemami wykrywania botów

Kiedy łączyć różne podejścia

Niektóre procesy zyskują na korzystaniu z wielu endpointów:

Zacznij od single: sprawdź, czy strona zwraca przydatne dane bez użycia przeglądarki.
Użyj browser jako opcji zapasowej: jeśli odpowiedź jest pusta lub brakuje w niej zawartości, przełącz się na renderowanie w przeglądarce.
Dodaj proxy: jeśli napotkasz blokady (403/CAPTCHA), opakuj swoje żądanie w endpoint proxy, aby skorzystać z automatycznej rotacji IP.

Takie stopniowe podejście pozwala utrzymać niskie koszty przy jednoczesnym maksymalizowaniu skuteczności.

Wskazówki dotyczące wydajności

Domyślnie używaj endpointu single i przechodź na wyższe poziomy tylko wtedy, gdy jest to konieczne
Ustawiaj checkText w żądaniach browser, aby uniknąć czekania na niepotrzebną zawartość
Ustawiaj maxTries w żądaniach proxy, aby kontrolować liczbę prób (domyślnie 5, maksymalnie 90)
Utrzymuj rozsądne wartości timeout_ms: od 10 do 15 sekund dla większości stron

Kolejne kroki

Endpointy API: Pełna dokumentacja parametrów
Scrapowanie dynamicznej strony: Przewodnik krok po kroku po żądaniach browser
Szybki start: Twoje pierwsze żądanie w 30 sekund

Aktualizacja: 30 czerwca 2026