Docs › Първи стъпки › Бърз старт

Бърз старт

Преминете от нулата до първото си събиране на данни за по-малко от две минути.

Предварителни изисквания

Стъпка 1: Вземете своя API Key

Влезте в Dashboard и създайте API key. Изглежда по следния начин: pk_live_a1b2c3d4e5f6...

Копирайте го. Ще ви е необходим за всяка request.

Стъпка 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 request към example.com и връща HTML кода на страницата.

Стъпка 3: Прочетете response-а

{
  "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 е масив от обекти, по един за всяка стъпка на пренасочване (redirect hop). Всеки запис съдържа поле result със status line плюс всеки response header, върнат от целевия сайт за съответната стъпка.

Основни полета:

  • status: HTTP status code от целевия сайт
  • data: тялото на отговора (HTML, JSON или raw text)
  • total_time: продължителност на заявката в секунди

Стъпка 4: Опитайте различни endpoint-и

FourA предлага четири endpoint-а за различни ситуации:

Endpoint Скорост Използвайте, когато
POST /api/auto/ Варира (бързо при warm hosts) Не знаете кой engine изисква сайтът. Подайте URL и оставете FourA да избере най-евтиния работещ път.
POST /api/single/ Най-бърз (200ms-2s) Статични страници, APIs, сайтове със server-side rendering
POST /api/browser/ Средна (2s-10s) Страници с много JavaScript, SPAs, динамично съдържание
POST /api/proxy/ Бърз (1s-5s) Сайтове с проверки на заявителя, съдържание според държавата

Опитайте auto заявка (интелигентният избор по подразбиране):

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

Опитайте 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
    }
  }'

Какво следва

  • Authentication: Управление и сигурност на API key
  • API Endpoints: Пълна справка за параметрите на всички четири endpoint-а
  • Smart Fetch (Auto): Как auto endpoint-ът определя какво действие да предприеме
  • SDKs and Libraries: Примери на Python, Node.js, Go, Ruby
  • Choosing the Right Endpoint: Кога да изберете auto, single, browser или proxy
Обновено: 27 септември 2026 г.
Удостоверяване →