Thunderbit Open API home page
지원API 콘솔
Extract

여러 페이지 배치 추출

POST
/batch/extract
여러 페이지 배치 추출

AI를 사용하여 여러 URL에서 동시에 구조화된 데이터를 추출합니다.

사용 사례:

  • 여러 페이지에서 상품 카탈로그 스크래핑
  • 검색 결과 페이지에서 데이터 추출
  • 목록 또는 디렉토리 페이지 일괄 처리
  • 대규모 경쟁 정보 수집

작동 방식:

  1. 단일 스키마로 최대 50개의 URL 제출
  2. 즉시 작업 ID 응답 수신
  3. 모든 URL에 동일한 스키마 적용
  4. 상태 폴링 또는 웹훅 알림 수신
  5. 모든 구조화된 결과 한 번에 조회

기능:

  • 모든 URL에 동일한 스키마 적용
  • 속도를 위한 병렬 처리
  • URL별 개별 오류 처리
  • 웹훅 알림 가능

인증

YOUR_API_KEY
인증Bearer <token>

Thunderbit Dashboard에서 API 키를 가져오세요. 헤더 형식: Authorization: Bearer YOUR_API_KEY

위치: header

본문

application/json

TypeScript Definitions

Use the request body type in TypeScript.

urls*string[]필수

데이터를 추출할 URL 목록, 최대 50개

예:
[
  "https://example.com/product/1",
  "https://example.com/product/2",
  "https://example.com/product/3"
]
schema*object필수

JSON 스키마 형식의 데이터 구조 정의

예:
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "price": {
      "type": "number"
    },
    "rating": {
      "type": "number"
    }
  }
}
timeoutnumber기본값:60000

요청당 타임아웃(밀리초), 기본값 30000

webhookobject

웹훅. 콜백 설정, 작업 완료 시 알림 콜백 페이로드 형식, 헤더 및 HMAC-SHA256 서명 검증은 Webhooks 가이드를 참조하세요.

하위 속성 표시
urlstring

Webhook callback URL, must be HTTPS

secretstring

HMAC-SHA256 secret for signature verification. When set, each webhook request includes an X-Webhook-Signature header

예:whsec_your_secret_key
headersobject

Custom headers (reserved for future use, not yet implemented by the server).

예:
{
  "X-Custom-Auth": "your-token"
}
renderModestring기본값:"none"

JavaScript rendering mode applied to every URL: none (default, fastest), basic, or full.

허용 값"none" | "basic" | "full"

응답

application/json

Success response

successboolean
예:
true
dataobject
하위 속성 표시
idstring
예:batch_ext_xyz789
statusstring
허용 값"PENDING" | "PROCESSING" | "COMPLETED" | "FAILED" | "CANCELLED" | "UNKNOWN"
예:PROCESSING
totalinteger
예:
3
completedinteger
예:
0
creditsUsedinteger
예:
0
createdAtstring

Timestamp when the job was created

completedAtstring

Timestamp when the job completed (null if still processing)