문서 › 시작하기 › 빠른 시작

빠른 시작

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

사전 요구 사항

1단계: API Key 발급

Dashboard에 로그인하여 API key를 생성합니다. 형식은 다음과 같습니다: 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"}'

이 코드는 example.com에 HTTP request를 보내고 페이지 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 필드는 리디렉션 홉당 하나씩 포함된 객체 배열입니다. 각 항목에는 해당 홉에 대해 대상이 반환한 모든 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(스마트 기본값)를 사용해 보세요:

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를 시도해 보세요:

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

다음 단계

최근 업데이트: 2026년 9월 27일
인증 →