Выбор подходящего endpoint

FourA предлагает три API endpoints, каждый из которых оптимизирован для различных сценариев. Выбор подходящего варианта экономит время, снижает затраты и повышает вероятность успешного выполнения.

Краткое руководство по выбору

Используйте single endpoint, когда:

Целевая страница рендерится на сервере (JavaScript не требуется)
Вам нужна максимальная скорость (обычно менее 1 секунды)
Вы собираете данные из APIs или статических HTML страниц

Используйте browser endpoint, когда:

Страница использует JavaScript для рендеринга контента
Контент загружается динамически после первоначальной загрузки страницы
Вам нужен полностью отрендеренный DOM

Используйте proxy endpoint, когда:

Целевой сайт активно блокирует requests
Вам нужно ротировать несколько IP-адресов
Предыдущие попытки вернули 403 или страницы с CAPTCHA

Сравнение endpoints

Single (`POST /api/single/`)

Самый быстрый вариант. Отправляет HTTP request с реалистичными сетевыми характеристиками, имитирующими браузер, без запуска процесса браузера.

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

Типичное время response: от 200 мс до 2 с Лучше всего подходит для: APIs, новостных сайтов, блогов, статических страниц товаров

Browser (`POST /api/browser/`)

Открывает ваш URL в экземпляре браузера Chrome. Страница загружается полностью, выполняется JavaScript, и вы получаете финальный отрендеренный 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"
  }'

Типичное время response: от 2 до 10 с Лучше всего подходит для: одностраничных приложений (SPAs), сайтов с ленивой загрузкой (lazy loading), контента с рендерингом на JavaScript

Proxy (`POST /api/proxy/`)

Объединяет HTTP requests с автоматической ротацией proxy. Если первая попытка не удалась или была заблокирована, FourA выполняет повторные попытки через другие proxies.

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

Типичное время response: от 1 до 5 с Лучше всего подходит для: мониторинга цен в сфере электронной коммерции, агрегаторов туристических данных, сайтов с защитой от ботов

Когда объединять подходы

Для некоторых рабочих процессов полезно использовать несколько endpoints:

Начните с single: проверьте, возвращает ли страница полезные данные без использования браузера.
Переходите на browser: если response пустой или в нем отсутствует контент, переключитесь на рендеринг в браузере.
Добавьте proxy: если вас блокируют (403/captcha), оберните ваш request в proxy endpoint для автоматической ротации IP.

Такой прогрессивный подход позволяет снизить затраты и максимизировать показатели успешности.

Советы по производительности

Используйте single endpoint по умолчанию и переходите на другие варианты только при необходимости
Задайте checkText в browser requests, чтобы избежать ожидания ненужного контента
Задайте maxTries в proxy requests для контроля логики повторных попыток (по умолчанию 5, максимум 90)
Устанавливайте разумные значения timeout_ms: от 10 до 15 секунд для большинства страниц

Следующие шаги

API Endpoints: Полный справочник параметров
Scrape a Dynamic Website: Пошаговое руководство по browser request
Quick Start: Ваш первый request за 30 секунд

Обновлено: 30 июня 2026 г.