Tavily Search
Usage-based pricing
ae_tavily_search
搜索网页、新闻及财经信息,支持时间、语言、域名、相关片段数、正文格式和答案选项。返回标题、网址、相关片段和评分;所选类型可附带发布时间。费用按本次实际供应商积分计算。
Usage-based pricing
Pricing
The charge per call is (max(6 × Actual search usage, 0)) AE credits. All applicable conditions are combined to calculate the total.
Search depth affects actual usage. Enabling automatic parameters may select a search depth with a higher charge. Charges are not based on the number of results returned. Zero actual usage incurs no charge.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
query | string | Yes | 搜索问题或关键词。 | — |
topic | enum (general | news | finance) | No | 搜索类型:general、news或finance。 | general |
country | enum (afghanistan | albania | algeria | andorra | angola | argentina | armenia | australia | austria | azerbaijan | bahamas | bahrain | bangladesh | barbados | belarus | belgium | belize | benin | bhutan | bolivia | bosnia and herzegovina | botswana | brazil | brunei | bulgaria | burkina faso | burundi | cambodia | cameroon | canada | cape verde | central african republic | chad | chile | china | colombia | comoros | congo | costa rica | croatia | cuba | cyprus | czech republic | denmark | djibouti | dominican republic | ecuador | egypt | el salvador | equatorial guinea | eritrea | estonia | ethiopia | fiji | finland | france | gabon | gambia | georgia | germany | ghana | greece | guatemala | guinea | haiti | honduras | hungary | iceland | india | indonesia | iran | iraq | ireland | israel | italy | jamaica | japan | jordan | kazakhstan | kenya | kuwait | kyrgyzstan | latvia | lebanon | lesotho | liberia | libya | liechtenstein | lithuania | luxembourg | madagascar | malawi | malaysia | maldives | mali | malta | mauritania | mauritius | mexico | moldova | monaco | mongolia | montenegro | morocco | mozambique | myanmar | namibia | nepal | netherlands | new zealand | nicaragua | niger | nigeria | north korea | north macedonia | norway | oman | pakistan | panama | papua new guinea | paraguay | peru | philippines | poland | portugal | qatar | romania | russia | rwanda | saudi arabia | senegal | serbia | singapore | slovakia | slovenia | somalia | south africa | south korea | south sudan | spain | sri lanka | sudan | sweden | switzerland | syria | taiwan | tajikistan | tanzania | thailand | togo | trinidad and tobago | tunisia | turkey | turkmenistan | uganda | ukraine | united arab emirates | united kingdom | united states | uruguay | uzbekistan | venezuela | vietnam | yemen | zambia | zimbabwe) | No | 提高指定国家来源的优先级,仅适用于general。 | — |
end_date | string | No | 结束日期,YYYY-MM-DD。 | — |
language | string | No | 结果偏好的语言。 | — |
start_date | string | No | 起始日期,YYYY-MM-DD。 | — |
time_range | enum (day | week | month | year | d | w | m | y) | No | 相对时间范围。 | — |
exact_match | boolean | No | 是否严格匹配查询中的引号短语。 | false |
max_results | integer | No | 最多返回的搜索结果数。 | 10 |
safe_search | boolean | No | 是否启用安全搜索。 | false |
search_depth | enum (advanced | basic | fast | ultra-fast) | No | 搜索深度,advanced通常消耗更多供应商积分。 | basic |
max_age_hours | integer | No | 允许使用的缓存内容最大时长,单位小时。 | — |
include_answer | boolean | string | No | 是否附带答案,可选basic或advanced;答案由模型生成。 | false |
include_images | boolean | No | 是否返回图片。 | false |
auto_parameters | boolean | No | 是否自动选择检索参数;可能选择更高费用的深度。 | false |
exclude_domains | array | No | 排除的域名列表。 | [] |
include_domains | array | No | 优先或限定检索的域名列表,具体约束取决于include_domains_mode。 | [] |
include_favicon | boolean | No | 是否返回站点图标。 | false |
chunks_per_source | integer | No | 每个来源最多返回的相关片段数;不是严格的字符长度上限。 | 3 |
filter_by_language | boolean | No | 是否按指定语言筛选。 | false |
include_raw_content | boolean | string | No | 是否附带网页正文,也可指定markdown或text。 | false |
include_domains_mode | enum (restrict | prefer) | No | 域名约束方式:restrict表示限制,其他模式按上游定义执行。 | — |
include_published_date | boolean | No | 是否返回发布时间信息。 | false |
filter_by_published_date | boolean | No | 是否依据发布时间过滤。 | false |
include_image_descriptions | boolean | No | 是否返回图片说明,需同时开启图片。 | false |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest coderequest.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_tavily_search' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"max_results": 5,
"query": "corrugated mailer box ECT rating"
}
}'Response exampleresponse.json
{
"answer": null,
"follow_up_questions": null,
"images": [],
"query": "corrugated mailer box ECT rating",
"results": [
{
"content": "Title: Corrugated Boxes by ECT Rating | Packrift\n# Corrugated Boxes by ECT Rating. choose corrugated boxes by ECT rating only after you know the packed weight, carton size, stacking exposure, carrier path, and damage risk. ECT helps with edge-crush and sta",
"id": "7bf1c8-00",
"raw_content": null,
"score": 0.80162543,
"title": "Corrugated Boxes by ECT Rating | Packrift",
"url": "https://packrift.com/pages/corrugated-boxes-by-ect-rating"
}
]
}This example shows part of the response. Copied content is valid JSON.
Guides using this tool
See how this tool fits into real workflows
The AI Agent Tool Stack for Market ResearchUse one AI agent to pull market research from every source — community threads, social posts, product reviews and deep search — in a single prompt, then merge it all into one structured insight brief.Real-Time Web Search for AI Agents: Picking the Right EngineGive your AI agent real-time web search. Reach Serper, Tavily, Brave, Exa and Linkup from one platform, switch by freshness, semantics or source quality, and get sourced answers from a single prompt.AI Deep Research Workflow with Cited SourcesRun multi-step web research with an AI agent that searches across engines, extracts source text, and returns a report with citations you can trace — instead of an unsourced AI answer.What AI Agents Can Do With Tools: 15 Real Use CasesAn AI agent on its own can only talk. Connect it to tools and it can research, source products, generate images and video, pull live financial data, and more. Here are 15 real things agents do with tools.




