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

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

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

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

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

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

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

Шаг 2. Выполните первый request

Откройте терминал и выполните следующую команду (замените 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 request на example.com и вернет HTML страницы.

Шаг 3. Прочитайте response

{
  "status": 200,
  "headers": [["content-type", "text/html"]],
  "data": "<!doctype html><html>...</html>",
  "total_time": 0.45
}

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

  • status: HTTP-код состояния целевого сайта
  • data: тело response (HTML, JSON или обычный текст)
  • total_time: длительность request в секундах

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

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

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

Попробуйте выполнить browser request:

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

Попробуйте выполнить proxy request (автоматическая ротация 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": 3,
    "request": {
      "method": "GET",
      "url": "https://example.com",
      "unblocker": true
    }
  }'

Что дальше

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