Thunderbit Open API home page
지원API 콘솔
Distill

단일 페이지 디스틸

POST
/distill
단일 페이지 디스틸

웹 페이지를 깔끔하고 LLM에 적합한 마크다운 형식으로 변환합니다.

사용 사례:

  • RAG(검색 증강 생성)를 위한 웹 콘텐츠 준비
  • AI 처리를 위한 기사 콘텐츠 추출
  • 문서 페이지를 마크다운으로 변환
  • 동적 웹 애플리케이션 처리

포함 기능:

  • 구조가 보존된 깔끔한 마크다운 콘텐츠
  • 광고, 내비게이션 및 보일러플레이트 자동 제거
  • 메타데이터 추출(제목, 설명, 언어)
  • 동적 콘텐츠를 위한 JavaScript 렌더링
  • 안티봇 조치 자동 처리

출력 형식: 최소한의 노이즈와 최대한의 정보로 LLM 활용에 최적화된 마크다운을 반환합니다.

인증

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.

url*string필수

디스틸할 웹 페이지의 URL

예:https://thunderbit.com/playground
timeoutnumber기본값:30000

요청 타임아웃(밀리초) (기본값: 30000, 최대: 60000)

허용 범위:5000 <= x <= 60000
예:
30000
waitFornumber기본값:0

콘텐츠 추출 전 동적 콘텐츠 렌더링을 위해 페이지 로드 후 대기할 시간(밀리초)

허용 범위:0 <= x <= 10000
예:
2000
includeTagsstring[]

이 HTML 태그의 콘텐츠만 포함 (예: ['article', 'main', 'div.content'])

예:
[
  "article",
  "main"
]
excludeTagsstring[]

이 HTML 태그의 콘텐츠 제외 (예: ['nav', 'footer', 'aside'])

예:
[
  "nav",
  "footer",
  "aside"
]
headersobject

요청과 함께 전송할 사용자 정의 HTTP 헤더

예:
{
  "Accept-Language": "en-US"
}
countryCodestring기본값:"US"

지오타겟팅을 위한 2자리 ISO 국가 코드 (기본값: US). 지정한 국가의 프록시 서버를 통해 트래픽이 라우팅됩니다.

예:US
renderModestring기본값:"none"

JavaScript 렌더링 모드. none = JS 렌더링 안 함 (가장 빠름, 기본값), basic = 표준 렌더링, full = 동적 콘텐츠 대기 시간을 늘린 표준 렌더링

허용 값"none" | "basic" | "full"
forceRefreshboolean기본값:false

캐시를 무시하고 페이지를 강제로 새로 가져옵니다 (기본값: false)

formatsany[]

출력 형식. 문자열은 간단한 형식을 선택하고, 객체는 LLM 형식(summary, question, highlights)을 매개변수화합니다.

예:
[
  "markdown",
  "links",
  "images"
]
includestring[]

응답에 포함할 선택 필드. 사용 가능한 값: metadata(제목, 설명, 언어 등), html(원본 HTML), links(추출된 링크). includeHtml 및 extractLinks를 대체합니다.

예:
[
  "metadata",
  "links"
]
includeHtmlboolean기본값:false

응답에 원본 HTML을 포함할지 여부 (기본값: false). include 매개변수 사용을 권장합니다.

extractLinksboolean기본값:false

페이지에서 링크를 추출할지 여부 (기본값: false). include 매개변수 사용을 권장합니다.

응답

application/json

성공 응답

successboolean
예:
true
dataobject
하위 속성 표시
urlstring

디스틸된 URL

예:https://thunderbit.com/playground
markdownstring

페이지에서 추출된 깔끔한 마크다운 콘텐츠

예:# Understanding Web Distillation Web distillation is the process of converting raw HTML into clean, structured content... ## Key Benefits - **LLM-Ready Format**: Optimized for AI consumption - **Noise Removal**: Automatic filtering of ads and boilerplate - **Structure Preservation**: Maintains semantic hierarchy
metadataobject

Page metadata (only returned when include contains metadata)

하위 속성 표시
titlestring
예:Understanding Web Distillation | Tech Blog
descriptionstring

메타 설명 또는 발췌문

languagestring

감지된 언어 코드 (ISO 639-1)

예:en
sourceUrlstring

Original URL (may differ from requested URL due to redirects)

statusCodeinteger

응답의 HTTP 상태 코드

예:
200
htmlstring

원본 HTML 콘텐츠 (선택 사항, 요청 시에만)

예:
null
linksobject[]

콘텐츠에서 발견된 링크

하위 속성 표시
textstring

Visible link text as rendered in the page

예:Read more
hrefstring

Resolved absolute URL of the link

예:https://example.com/article
imagesobject[]

페이지에서 추출된 이미지.

하위 속성 표시
srcstring

Image source URL.

예:https://example.com/hero.png
altstring

Image alt text.

예:Hero banner
widthinteger

Image width in pixels.

heightinteger

Image height in pixels.

summarystring

구조화된 Markdown 요약(LLM 형식).

answerstring

question 형식으로 제공된 질문에 대한 답변.

highlightsstring[]

highlights 형식으로 표시된 강조 구절.

errorobject
예:
null