문서 › 시작하기 › 빠른 시작 가이드

빠른 시작 가이드

2분 안에 첫 번째 데이터 수집을 완료해 보세요.

사전 준비 사항

1단계: API Key 가져오기

Dashboard에 로그인하고 API key를 생성합니다. 다음과 같은 형식입니다: pk_live_a1b2c3d4e5f6...

이 값을 복사해 두세요. 모든 request에 필요합니다.

2단계: 첫 번째 Request 보내기

터미널을 열고 다음 명령어를 실행합니다 (YOUR_API_KEY 부분을 실제 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": [["content-type", "text/html"]],
  "data": "<!doctype html><html>...</html>",
  "total_time": 0.45
}

주요 필드:

  • status: 대상 사이트의 HTTP status code
  • data: response body (HTML, JSON 또는 raw 텍스트)
  • total_time: 초 단위의 request 소요 시간

4단계: 다른 Endpoint 사용해 보기

FourA는 상황에 따라 사용할 수 있는 세 가지 endpoint를 제공합니다:

Endpoint 속도 추천 용도
POST /api/single/ 가장 빠름 (200ms-2s) 정적 페이지, API, 서버 렌더링 사이트
POST /api/browser/ 보통 (2s-10s) JavaScript가 많은 페이지, SPA, 동적 콘텐츠
POST /api/proxy/ 빠름 (1s-5s) 봇 감지가 적용된 사이트, 지역 제한 콘텐츠

브라우저 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년 7월 1일
인증 →