Tavily Search

Usage-based pricing
ae_tavily_search

搜索网页、新闻及财经信息,支持时间、语言、域名、相关片段数、正文格式和答案选项。返回标题、网址、相关片段和评分;所选类型可附带发布时间。费用按本次实际供应商积分计算。

SearchNews
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.

ParameterTypeRequiredDescriptionDefault
querystringYes搜索问题或关键词。—
topicenum (general | news | finance)No搜索类型:general、news或finance。general
countryenum (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_datestringNo结束日期,YYYY-MM-DD。—
languagestringNo结果偏好的语言。—
start_datestringNo起始日期,YYYY-MM-DD。—
time_rangeenum (day | week | month | year | d | w | m | y)No相对时间范围。—
exact_matchbooleanNo是否严格匹配查询中的引号短语。false
max_resultsintegerNo最多返回的搜索结果数。10
safe_searchbooleanNo是否启用安全搜索。false
search_depthenum (advanced | basic | fast | ultra-fast)No搜索深度,advanced通常消耗更多供应商积分。basic
max_age_hoursintegerNo允许使用的缓存内容最大时长,单位小时。—
include_answerboolean | stringNo是否附带答案,可选basic或advanced;答案由模型生成。false
include_imagesbooleanNo是否返回图片。false
auto_parametersbooleanNo是否自动选择检索参数;可能选择更高费用的深度。false
exclude_domainsarrayNo排除的域名列表。[]
include_domainsarrayNo优先或限定检索的域名列表,具体约束取决于include_domains_mode。[]
include_faviconbooleanNo是否返回站点图标。false
chunks_per_sourceintegerNo每个来源最多返回的相关片段数;不是严格的字符长度上限。3
filter_by_languagebooleanNo是否按指定语言筛选。false
include_raw_contentboolean | stringNo是否附带网页正文,也可指定markdown或text。false
include_domains_modeenum (restrict | prefer)No域名约束方式:restrict表示限制,其他模式按上游定义执行。—
include_published_datebooleanNo是否返回发布时间信息。false
filter_by_published_datebooleanNo是否依据发布时间过滤。false
include_image_descriptionsbooleanNo是否返回图片说明,需同时开启图片。false

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request 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
JSONPartial content
{
  "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