Tavily Map

Usage-based pricing
ae_tavily_map

从起始URL发现站内页面,支持深度、广度、数量、域名及路径的选择或排除。只返回页面链接,不抽取全部正文;按实际用量结算。

Productivity
Usage-based pricing

Pricing

The charge per call is (max(6 × Actual webpage mapping usage, 0)) AE credits. All applicable conditions are combined to calculate the total.

Actual usage depends on the number of pages successfully returned and whether natural-language instructions are provided. Mapping with instructions uses its own usage tier, which replaces the regular mapping tier. The page limit, exploration depth, links followed per page, and filters affect the mapping scope; the requested page limit does not represent the number of pages actually returned. Usage may be zero when pages are successfully returned but the billing group has not yet been reached. Failed mapping requests are not charged.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
urlstringYes起始网页URL。—
limitintegerNo最多处理或返回的页面数量;会影响预占及最终费用。50
timeoutnumberNo上游单次执行的最长等待秒数。150
max_depthintegerNo从起始URL向外探索的层数。1
max_breadthintegerNo每个页面最多继续访问的链接数。20
instructionsstringNo描述希望寻找的内容或页面类型;填写后可能增加供应商用量。—
select_pathsarrayNo仅选择匹配这些正则表达式的路径。—
exclude_pathsarrayNo排除匹配这些正则表达式的路径。—
allow_externalbooleanNo是否允许结果含站外链接。true
select_domainsarrayNo仅选择匹配这些表达式的域名。—
exclude_domainsarrayNo排除的域名列表。—

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_map' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "exclude_paths": [
      ".*not-a-real-page.*"
    ],
    "limit": 2,
    "max_depth": 1,
    "select_paths": [
      ".*endpoint/(search|extract).*"
    ],
    "url": "https://docs.tavily.com"
  }
}'
Response exampleresponse.json
JSON
{
  "base_url": "https://docs.tavily.com",
  "response_time": 0.08,
  "results": [
    "https://docs.tavily.com/documentation/api-reference/endpoint/search"
  ],
  "usage": {}
}