# Бърз старт

> URL: https://foura.ai/bg/docs/getting-started/quick-start
> Updated: 2026-09-27
> Index: https://foura.ai/llms.txt

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

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

- Профил в FourA ([регистрирайте се тук](https://foura.ai))
- Вашият API key (създайте такъв в [Dashboard](https://foura.ai/dashboard))

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

Влезте в [Dashboard](https://foura.ai/dashboard) и създайте API key. Изглежда по следния начин: `pk_live_a1b2c3d4e5f6...`

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

## Стъпка 2: Направете първата си заявка

Отворете терминал и изпълнете това (заменете `YOUR_API_KEY` с вашия реален ключ):

```bash
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-а

```json
{
  "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 заявка (интелигентният избор по подразбиране):

```bash
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:

```bash
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 ротация):

```bash
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](https://foura.ai/docs/getting-started/authentication): Управление и сигурност на API key
- [API Endpoints](https://foura.ai/docs/api/endpoints): Пълна справка за параметрите на всички четири endpoint-а
- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch): Как auto endpoint-ът определя какво действие да предприеме
- [SDKs and Libraries](https://foura.ai/docs/getting-started/sdks-and-libraries): Примери на Python, Node.js, Go, Ruby
- [Choosing the Right Endpoint](https://foura.ai/docs/guides/choosing-task-type): Кога да изберете auto, single, browser или proxy
