Документация › Начало работы › Быстрый старт

Быстрый старт

Пройдите путь от нуля до первого сбора данных менее чем за две минуты.

Предварительные требования

Шаг 1: Получите API-ключ

Войдите в панель управления и создайте API-ключ. Он выглядит так: pk_live_a1b2c3d4e5f6...

Скопируйте его. Он понадобится для каждого запроса.

Шаг 2: Выполните первый запрос

Откройте терминал и выполните эту команду (замените YOUR_API_KEY на ваш реальный ключ):

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

Это отправляет HTTP-запрос к example.com и возвращает HTML страницы.

Шаг 3: Прочитайте ответ

{
  "status": 200,
  "headers": [
    {
      "result": { "version": "HTTP/2", "code": 200, "reason": "" },
      "content-type": "text/html; charset=UTF-8",
      "content-length": "1256"
    }
  ],
  "data": "<!doctype html><html>...</html>",
  "total_time": 0.45
}

Поле headers является массивом объектов, по одному на каждый шаг редиректа. Каждая запись содержит поле result со строкой статуса и всеми заголовками ответа, которые целевой сайт вернул для этого шага.

Ключевые поля:

  • status: HTTP-статус от целевого сайта
  • data: тело ответа (HTML, JSON или простой текст)
  • total_time: длительность запроса в секундах

Шаг 4: Попробуйте разные endpoint

FourA предлагает четыре endpoint для различных ситуаций:

Endpoint Скорость Когда использовать
POST /api/auto/ Варьируется (быстро на прогретых хостах) Вы не знаете, какой движок нужен сайту. Передайте URL, и FourA выберет самый дешевый рабочий путь.
POST /api/single/ Самая высокая (200мс-2с) Статические страницы, API, сайты с серверным рендерингом
POST /api/browser/ Средняя (2с-10с) Страницы с тяжелым JavaScript, SPA, динамический контент
POST /api/proxy/ Высокая (1с-5с) Сайты с защитой от ботов, контент с гео-ограничениями

Выполните автоматический запрос (умный вариант по умолчанию):

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

Выполните браузерный запрос:

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", "timeout_ms": 15000}'

Выполните запрос через прокси (автоматическая ротация прокси):

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

Что дальше

Обновлено: 1 июля 2026 г.
Аутентификация →