Tavily Search
Tavily · Research & Search
POST /v1/search크롤, 추출, URL 매핑을 통한 웹 검색을 통해 페이지와 도메인을 빠르게 구조화하여 하위 파이프라인을 검색할 수 있습니다.
한눈에
| 필드 | 가치 |
|---|---|
| 모델 ID | tavily-search |
| 모델 출시일 | - |
| 입력 양상 | 본문 |
| 출력 방식 | 본문 |
| 컨텍스트 윈도우 | - |
| 무게 정밀도 | - |
| 특징 | web_search, 크롤, 추출, 지도 |
| 원주민 추론 | 아니 |
| 신규 | 아니 |
| 지원되는 엔드포인트 | POST /v1/search |
가격
| 돌격 | 사양 | 요금 |
|---|---|---|
| 서치 (Basic/Fast/초고속) | 검색 결과 | $0.0096 |
| 검색 (고급) | 검색 결과 | $0.019 |
| 검색 (고급 + 답변) | 검색 결과 | $0.029 |
| 추출물 (기본) | 5개의 URL마다 | $0.0096 |
| 추출물 (고급) | 5개의 URL마다 | $0.019 |
| Crawl/Map (기본) | 10페이지당 | $0.0096 |
예시 요청
$ curl https://api.empiriolabs.ai/v1/search \ > -H 'Authorization: Bearer $EMPIRIOLABS_API_KEY' \ > -H 'Content-Type: application/json' \ > -d '{"model": "tavily-search", "query": "latest LLM benchmarks 2026"}'
매개변수
| 매개변수 | 유형 | 필수 | 기본 설정 | 설명 |
|---|---|---|---|---|
query | 스트링 | 네 | - | 자연어 검색 쿼리입니다. |
operation_mode | 열거 | 아니 | "Search" | 검색 | 추출 | 기어가기 | 지도. 어떤 Tavily 엔드포인트가 실행될지를 결정합니다. · 허용: Search, Crawl, Extract, Map |
search_depth | 열거 | 아니 | "basic" | Basic = 빠르고 저렴하고, advanced = 결과당 더 깊은 크롤링과 완전한 콘텐츠. · 허용: basic, advanced |
search_chunks_per_source | 번호 | 아니 | 3 | 출처별로 추출해야 할 관련 콘텐츠 청크의 수. · 사거리: 1 – 3 |
search_topic | 열거 | 아니 | "general" | 주제 프리셋(일반, 뉴스, 금융 등)을 검색하세요. 주제의 별명. · 허용: general, news, finance |
include_answer | 불리언 | 아니 | 맞아요 | 기본 | 고급 | 거짓이었다. 결과와 함께 종합된 답변을 반환합니다. |
include_raw_content | 불리언 | 아니 | 거짓 | 깨끗한 텍스트와 함께 원시 HTML 콘텐츠를 포함하세요. |
include_images | 불리언 | 아니 | 거짓 | 검색 결과에서 이미지 URL을 포함하세요. |
include_image_descriptions | 불리언 | 아니 | 거짓 | 반환된 이미지에 대한 AI가 생성한 설명을 포함하세요. |
include_favicon | 불리언 | 아니 | 거짓 | 각 소스의 파비콘 URL을 포함하세요. |
auto_parameters | 불리언 | 아니 | 거짓 | 쿼리에 따라 search_depth Tavily 다른 노브를 자동으로 선택하게 하세요. |
max_results | 번호 | 아니 | 5 | 최대 결과 수(1-50). · 사거리: 1 – 20 |
time_range | 열거 | 아니 | - | 하루요 | 한 주 | 월 | 1년. 결과를 이 최신 시기로 제한하세요. · 허용: day, week, month, year |
start_date | 스트링 | 아니 | - | 이 날짜 이후에 출판된 출처만 포함하세요 (YYYY-MM-DD). |
end_date | 스트링 | 아니 | - | 이 날짜 이전에 출판된 출처만 포함하세요 (YYYY-MM-DD). |
country | 스트링 | 아니 | - | 결과가 국가에 편향되는 두 글자 ISO 3166-1 코드(미국, 영국 등). |
include_domains | 스트링 | 아니 | - | 도메인의 쉼표 구분 허용 목록. 이 도메인들에서만 결과가 반환됩니다. |
exclude_domains | 스트링 | 아니 | - | 필터를 걸러낼 도메인의 쉼표 구분된 부정 목록. |
topic | 열거 | 아니 | "general" | 검색: 주제 프리셋. 일반(디폴트), 뉴스(최근 뉴스), 또는 금융(시장/비즈니스). search_topic로도 인정받았습니다. · 허용: general, news, finance |
days | 번호 | 아니 | - | 뉴스 주제의 최근 시기, 오늘로부터 며칠 전입니다. · 사거리: 1 – 365 |
crawl_limit | 번호 | 아니 | 10 | 시작 URL에서 크롤할 수 있는 최대 페이지 수. · 사거리: 1 – 500 |
crawl_max_depth | 번호 | 아니 | 1 | 시작 URL에서 최대 링크 깊이를 얻는 것. · 사거리: 1 – 5 |
crawl_max_breadth | 번호 | 아니 | 20 | 페이지당 팔로우할 수 있는 최대 링크 수. · 범위: 1 – 50 |
crawl_extract_depth | 열거 | 아니 | "basic" | 크롤된 각 페이지에서 얼마나 깊이 콘텐츠를 추출해야 할지. · 허용: basic, advanced |
crawl_format | 열거 | 아니 | "markdown" | 크롤 콘텐츠의 출력 형식(마크다운 | 텍스트 | html). · 허용: markdown, text |
crawl_instructions | 스트링 | 아니 | - | 기어갈 때 무엇을 주의해야 하는지에 대한 자연어 지침. |
crawl_chunks_per_source | 번호 | 아니 | - | 크롤된 각 페이지에서 추출할 수 있는 콘텐츠 조각의 수. · 사거리: 1 – 5 |
crawl_select_paths | 스트링 | 아니 | - | 크롤에 포함할 쉼표 구분된 URL 경로. |
crawl_exclude_paths | 스트링 | 아니 | - | 크롤에서 제외할 쉼표 구분된 URL 경로. |
crawl_select_domains | 스트링 | 아니 | - | 크롤이 제한되는 쉼표 구분 도메인. |
crawl_exclude_domains | 스트링 | 아니 | - | 쉼표로 구분된 도메인은 크롤이 건너뛸 것입니다. |
crawl_allow_external | 불리언 | 아니 | 거짓 | 크롤러가 외부 도메인으로 가는 링크를 따라갈 수 있도록 허용하세요. |
crawl_include_images | 불리언 | 아니 | 거짓 | 크롤 출력에 이미지 URL을 포함하세요. |
crawl_include_favicon | 불리언 | 아니 | 거짓 | 각 크롤 페이지의 파비콘 URL을 포함하세요. |
crawl_timeout | 번호 | 아니 | 60 | 몇 초 만에 기어가면 타임아웃이 가능해요. · 사거리: 5 – 300 |
extract_depth | 열거 | 아니 | "basic" | 기본 | 고급. 고급 추출은 자바스크립트로 렌더링된 콘텐츠를 읽습니다. · 허용: basic, advanced |
extract_format | 열거 | 아니 | "markdown" | 추출된 콘텐츠의 출력 형식(마크다운 | 텍스트 | html). · 허용: markdown, text |
extract_query | 스트링 | 아니 | - | 추출된 콘텐츠를 필터링/집중하기 위한 자연어 쿼리. |
extract_chunks_per_source | 번호 | 아니 | - | 각 URL에서 추출해야 할 콘텐츠 조각의 수. · 사거리: 1 – 5 |
extract_include_images | 불리언 | 아니 | 거짓 | 추출 출력에 이미지 URL을 포함하세요. |
extract_include_favicon | 불리언 | 아니 | 거짓 | 소스 페이지의 파비콘 URL을 포함하세요. |
extract_timeout | 번호 | 아니 | 10 | 몇 초 만에 타임아웃을 추출하세요. · 범위: 1 – 60 |
map_limit | 번호 | 아니 | 50 | 시작 사이트에서 매핑할 최대 URL 수. · 범위: 1 – 100 |
map_depth | 번호 | 아니 | 1 | 시작 URL에서 최대 링크 깊이를 얻는 것. · 사거리: 1 – 5 |
map_breadth | 번호 | 아니 | 20 | 매핑 중 페이지당 따라갈 수 있는 최대 링크 수. · 범위: 1 – 50 |
map_instructions | 스트링 | 아니 | - | 매핑 중에 어떤 URL을 찾아야 하는지에 대한 자연어 지침. |
map_select_paths | 스트링 | 아니 | - | 쉼표로 구분된 URL 경로가 맵에 제한됩니다. |
map_exclude_paths | 스트링 | 아니 | - | 쉼표로 구분된 URL 경로는 맵이 건너뛰는 것입니다. |
map_select_domains | 스트링 | 아니 | - | 이 맵이 제한되는 쉼표 분리 도메인입니다. |
map_exclude_domains | 스트링 | 아니 | - | 쉼표로 구분된 도메인은 지도가 건너뛸 것입니다. |
map_allow_external | 불리언 | 아니 | 거짓 | 매핑자가 외부 도메인으로 가는 링크를 따라갈 수 있도록 허용하세요. |
map_timeout | 번호 | 아니 | 60 | 맵 타임아웃은 몇 초 만에 완료됩니다. · 사거리: 5 – 300 |
disable_formatting | 불리언 | 아니 | 거짓 | EmpirioLabs 마크다운 포맷팅(렌더러가 추가한 소스 / 결과 / 코드 블록)은 건너뛰세요. 원시 업스트림 Tavily JSON은 파워 유저/에이전트에게 반환됩니다. |
주석
작전
- 검색, 크롤, 추출, 지도
수색 깊이
- 기본, 고급, 빠르게, 초고속
주제
- 일반, 뉴스, 금융
Machine-읽기 가능한 스키마: GET https://api.empiriolabs.ai/v1/models/tavily-search.