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

Бърз старт

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

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

Стъпка 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 status код от целевия сайт
  • data: тялото на response (HTML, JSON или чист текст)
  • total_time: продължителност на request в секунди

Стъпка 4: Изпробвайте различни endpoints

FourA има три endpoints за различни ситуации:

Endpoint Скорост Кога да се използва
POST /api/single/ Най-бърз (200ms-2s) Статични страници, APIs, server-rendered сайтове
POST /api/browser/ Среден (2s-10s) Страници с интензивен JavaScript, SPAs, динамично съдържание
POST /api/proxy/ Бърз (1s-5s) Сайтове с bot detection, гео-ограничено съдържание

Изпробвайте 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 г.
Автентикация →