Thunderbit Open API home page
지원API 콘솔
Search

검색 및 디스틸

POST
/search
검색 및 디스틸

제공된 쿼리에 대해 Google 웹 검색을 실행하고 요청된 formats로 각 결과를 디스틸합니다. 각 결과는 자체 success 플래그를 보고합니다.

인증

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.

query*string필수

검색 쿼리(최대 500자).

예:best web scraping tools 2026
limitinteger기본값:5

반환할 결과 수(1–10, 기본값 5).

허용 범위:1 <= x <= 10
예:
5
sitestring

검색을 단일 도메인으로 제한합니다.

예:techcrunch.com
formatsany[]

각 결과 페이지에 적용되는 출력 형식(Distill formats 배열과 동일한 구조).

예:
[
  "markdown",
  {
    "type": "summary"
  }
]
timeoutinteger기본값:30000

결과당 Distill 타임아웃(밀리초, 기본값 30000, 최대 60000).

허용 범위:5000 <= x <= 60000

응답

application/json

Search succeeded. Per-result Distill outcomes are reported individually in `data.results[].success`.

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

입력 쿼리의 에코.

totalinteger

반환된 결과 수.

successfulinteger

Distill 단계가 성공한 결과 수.

credits_usedinteger

이 요청에 청구된 총 크레딧.

resultsobject[]
하위 속성 표시
urlstring

결과 URL.

titlestring

검색 결과 제목.

snippetstring

Google의 검색 결과 스니펫.

positioninteger

검색 결과에서 1부터 시작하는 순위.

successboolean

결과별 Distill 성공 여부.

markdownstring

이 결과의 디스틸된 Markdown(요청된 경우).

summarystring

결과 요약(요청된 경우).

answerstring

question 형식에 대한 답변(요청된 경우).

highlightsstring[]

강조된 구절(요청된 경우).

linksobject[]

결과 페이지에서 추출된 링크(요청된 경우).

하위 속성 표시
textstring

Visible link text.

예:Read more
hrefstring

Resolved absolute URL.

예: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.

errorstring

이 결과의 Distill 오류 메시지(success=false인 경우에만).