# 빠른 시작

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

2분 이내에 첫 번째 데이터 수집을 시작할 수 있습니다.

## 사전 요구 사항

- 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단계: 첫 번째 Request 전송

터미널을 열고 다음 명령어를 실행합니다 (`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"}'
```

이 코드는 `example.com`에 HTTP request를 보내고 페이지 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` 필드는 리디렉션 홉당 하나씩 포함된 객체 배열입니다. 각 항목에는 해당 홉에 대해 대상이 반환한 모든 response header 및 상태 라인이 포함된 `result` 필드가 있습니다.

주요 필드:
- `status`: 대상 사이트의 HTTP status code
- `data`: response body (HTML, JSON 또는 원시 텍스트)
- `total_time`: request 소요 시간(초)

## 4단계: 다른 엔드포인트 사용해 보기

FourA는 다양한 상황에 맞는 4개의 endpoint를 제공합니다:

| Endpoint | Speed | Use when |
|----------|-------|----------|
| `POST /api/auto/` | 다양함 (웜 호스트에서 빠름) | 사이트에 필요한 엔진을 알 수 없을 때. URL을 전달하여 FourA가 작동하는 가장 저렴한 경로를 선택하도록 합니다. |
| `POST /api/single/` | 가장 빠름 (200ms-2s) | 정적 페이지, API, 서버 렌더링 사이트 |
| `POST /api/browser/` | 중간 (2s-10s) | JavaScript 비중이 높은 페이지, SPA, 동적 콘텐츠 |
| `POST /api/proxy/` | 빠름 (1s-5s) | 요청자를 확인하는 사이트, 국가별로 다른 콘텐츠 |

auto request(스마트 기본값)를 사용해 보세요:

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

브라우저 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
    }
  }'
```

## 다음 단계

- [인증](https://foura.ai/docs/getting-started/authentication): API 키 관리 및 보안
- [API 엔드포인트](https://foura.ai/docs/api/endpoints): 4개 엔드포인트 전체에 대한 전체 매개변수 레퍼런스
- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch): auto 엔드포인트의 동작 결정 방식
- [SDK 및 라이브러리](https://foura.ai/docs/getting-started/sdks-and-libraries): Python, Node.js, Go, Ruby 예제
- [적절한 엔드포인트 선택하기](https://foura.ai/docs/guides/choosing-task-type): auto, single, browser, proxy 선택 기준
