Tavily Map
从起始URL发现站内页面,支持深度、广度、数量、域名及路径的选择或排除。只返回页面链接,不抽取全部正文;按实际用量结算。
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.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
url | string | Yes | 起始网页URL。 | — |
limit | integer | No | 最多处理或返回的页面数量;会影响预占及最终费用。 | 50 |
timeout | number | No | 上游单次执行的最长等待秒数。 | 150 |
max_depth | integer | No | 从起始URL向外探索的层数。 | 1 |
max_breadth | integer | No | 每个页面最多继续访问的链接数。 | 20 |
instructions | string | No | 描述希望寻找的内容或页面类型;填写后可能增加供应商用量。 | — |
select_paths | array | No | 仅选择匹配这些正则表达式的路径。 | — |
exclude_paths | array | No | 排除匹配这些正则表达式的路径。 | — |
allow_external | boolean | No | 是否允许结果含站外链接。 | true |
select_domains | array | No | 仅选择匹配这些表达式的域名。 | — |
exclude_domains | array | No | 排除的域名列表。 | — |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --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"
}
}'{
"base_url": "https://docs.tavily.com",
"response_time": 0.08,
"results": [
"https://docs.tavily.com/documentation/api-reference/endpoint/search"
],
"usage": {}
}




