LLM·에이전트를 위한 실시간 웹 검색입니다. 관련도 순 결과와 핵심 본문 스니펫, 선택적으로 LLM 생성 답변·페이지 전문·이미지를 반환하며 도메인·기간 필터를 지원합니다. basic 검색 19 크레딧, advanced 검색 38 크레딧입니다.
콘솔의 Playground에서 별도 코드 없이 이 모델을 즉시 테스트할 수 있어요
이 모델의 사용법을 Claude, ChatGPT 등에 복사
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "tavily/search",
"input": {
"query": "latest AI video generation models 2026",
"search_depth": "basic",
"max_results": 5,
"include_answer": "basic"
}
}'| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
query | string | Yes | - | 검색어입니다. 원하는 결과 언어로 작성하세요. |
search_depth | string | No | basic | basic은 균형 잡힌 일반 검색, advanced는 지연이 늘지만 가장 관련도 높은 청크를 반환합니다(2배 가격). fast·ultra-fast는 관련도 대신 속도를 택합니다. basicadvancedfastultra-fast |
topic | string | No | general | 검색 카테고리입니다. news는 게시일이 포함된 최신 기사를 반환합니다. generalnewsfinance |
max_results | integer | No | - | 최대 결과 수입니다 (0-20). 생략하면 Tavily 기본값을 씁니다. |
chunks_per_source | integer | No | - | 소스당 최대 관련 본문 청크 수입니다 (1-3, 기본 3). basic·advanced·fast에 적용됩니다. |
time_range | string | No | - | 이 기간 안에 게시·수정된 결과만 반환합니다. dayweekmonthyear |
start_date | string | No | - | 이 날짜 이후 게시·수정된 결과만 반환합니다 (YYYY-MM-DD). |
end_date | string | No | - | 이 날짜 이전 게시·수정된 결과만 반환합니다 (YYYY-MM-DD). |
include_answer | string | No | - | 검색어에 대한 LLM 생성 답변을 추가합니다. advanced가 더 자세합니다. 생략하면 답변이 없습니다. basicadvanced |
include_raw_content | string | No | - | 각 결과의 정제된 페이지 전문을 이 형식으로 추가합니다. 생략하면 스니펫만 반환합니다. markdowntext |
include_images | boolean | No | false | 검색어 관련 이미지와 결과별 이미지를 추가합니다. |
include_image_descriptions | boolean | No | false | 각 이미지에 설명 텍스트를 추가합니다 (include_images 필요). |
include_favicon | boolean | No | false | 각 결과의 파비콘 URL을 추가합니다. |
include_published_date | boolean | No | false | 각 결과에 published_date를 추가합니다 (topic=news에서는 항상 포함). |
include_domains | array | No | - | 이 도메인의 결과만 반환합니다 (예: ["core.today"]). 최대 300개. |
exclude_domains | array | No | - | 이 도메인의 결과는 제외합니다. 최대 150개. |
country | string | No | - | 특정 국가의 결과를 우선합니다. 소문자 영문 국가명으로 지정합니다 (예: south korea, united states). topic=general에서만 동작합니다. |
language | string | No | - | 특정 언어의 결과를 우선합니다 — ISO 639-1 코드 또는 영문 언어명 (예: ko, en). |
auto_parameters | boolean | No | false | 검색 의도에 맞춰 Tavily가 파라미터를 고릅니다 (명시한 값이 우선). advanced로 바뀔 수 있어 advanced 가격으로 예약하고 Tavily 실제 차감 크레딧으로 정산합니다. |
exact_match | boolean | No | false | 검색어의 따옴표 구문을 그대로 포함한 결과만 반환합니다. |
safe_search | boolean | No | false | 성인·유해 콘텐츠를 걸러냅니다. fast·ultra-fast에서는 지원되지 않습니다. |
POST /v1/predictions 요청 시 사용되는 공통 파라미터입니다.
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
model | string | Yes | - | 모델 식별자 |
input | object | Yes | - | 위 테이블의 모델별 파라미터를 포함하는 객체 |
output_folder | string | No | - | 결과물 저장 폴더 경로 (최대 256자, '..' 사용 불가) |
webhook_url | string | No | - | 완료 시 호출할 Webhook URL |
is_public | boolean | No | false | true 시 결과물을 영구 공개 URL로도 제공 |
결과 5개와 짧은 LLM 생성 답변을 반환합니다.
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "tavily/search",
"input": {
"query": "latest AI video generation models 2026",
"search_depth": "basic",
"max_results": 5,
"include_answer": "basic"
}
}'최근 1주일 뉴스를 한국·한국어 결과 위주로 반환합니다.
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "tavily/search",
"input": {
"query": "생성형 AI 규제",
"topic": "news",
"time_range": "week",
"language": "ko",
"max_results": 10
}
}'두 도메인으로 한정한 advanced 검색이며 페이지 전문을 markdown으로 받습니다.
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "tavily/search",
"input": {
"query": "Seedance 2.5 reference to video pricing",
"search_depth": "advanced",
"include_domains": [
"core.today",
"byteplus.com"
],
"include_raw_content": "markdown"
}
}'