메인 콘텐츠로 건너뛰기
POST
Web search: deepseek-search
오른쪽 Playground에서 사용해 보세요: Authorization에 Bearer sk-your-api-key(default 또는 svip 그룹의 키)를 입력합니다. 기본 예제가 미리 입력되어 있으므로 전송을 클릭하여 결과를 확인할 수 있습니다. 호출이 성공할 때마다 1회 과금됩니다. localization은 사용자의 IP 주소(예: 8.8.8.8)를 사용하며, en-US와 같은 로케일 코드는 400을 반환합니다.
가격 정보, 테스트 데이터 및 필수 안내 사항은 개요에서 확인할 수 있습니다.

파라미터 참조

요청 본문에는 model 필드가 필요하지 않으며, 알 수 없는 필드는 무시됩니다.

응답 하이라이트

  • 모델에는 summary을(를) 전달하고 사람에게는 snippet을(를) 보여주십시오. 전체 텍스트의 경우 need_content을(를) 활성화하거나 몇 가지 결과를 선택하여 Fetch를 사용하십시오.
  • rerank_score ≥ 1.5 및 authority ≥ 3은 고품질 결과를 나타내며 적절한 필터링 임계값으로 활용하기 좋습니다.
  • count=50을(를) 사용하면 응답 크기가 약 180 KB이며, need_content을(를) 사용하면 두 배 이상 늘어납니다. 이에 맞게 클라이언트 타임아웃을 설정하십시오.

오류 코드

오류 본문의 type은 항상 shell_api_error입니다. HTTP 상태 코드를 기준으로 분기하십시오.

인증

Authorization
string
header
필수

Add Authorization: Bearer YOUR_API_KEY to the request headers

본문

application/json
query
string
필수

Search query, 1–128 characters, not all whitespace. Supports site: / lang: / after: and other operators

예시:

"DeepSeek V4 release"

count
integer
기본값:10

Number of results, 1–50. Does not affect the price

필수 범위: 1 <= x <= 50
예시:

5

need_content
boolean
기본값:false

Whether to return the page body. When false, content is always an empty string

ori_question
string

The user's original question that triggered this search, 1–128 characters

localization
string

The user's IP address, used to prioritize localized results. Not a locale code: passing ja-JP returns 400

예시:

"8.8.8.8"

응답

Search succeeded (billed once)

results
object[]