Web Content
Web crawling, URL discovery and page extraction.
使用 Tavily Map 產生完整的網站地圖。
從根 url 列出網站的 URL，不抓取任何頁面內容。以自然語言 instructions 與正規表示式 select_paths / exclude_paths / select_domains 篩選器引導。傳回 base_url 與 results——一個扁平的 URL 字串陣列，而非物件——並附有 response_time 與 request_id。用它先摸清網站規模，再決定是否爬取，接著以 extractWebContent 只取得真正重要的部分。若你要的是內容而非網站結構，post_tavily_crawl 可一次呼叫同時完成兩者。
計費參考
- 計量方式：依回應單位計量。
- 參考請求估算：0.064 美元。
- 單位成本基準：0.008 美元。
- 資源單位：
tavily_credit。 - 參考客戶乘數：1.0。不得再次套用於已結算的客戶金額。
- 成本基礎不構成最終客戶價格，即使為零亦同。
僅供參考的中繼資料，並非帳戶報價、保證價格或消費上限。資源額度並非 Felo 額度。最終費用依 Felo 計費記錄為準。
- 類型: stringurl必填
開始對應的根 URL。
- 類型: booleanallow
_external 在最終結果清單中包含外部網域連結。
- 類型: array string[]exclude
_domains 用於在對應時排除特定網域或子網域的正規表達式模式。
- 類型: array string[]exclude
_paths 用於排除具有特定路徑模式之 URL 的正規表達式模式。
- 類型: booleaninclude
_usage 在回應中包含額度用量資訊。
- 類型: stringinstructions
給爬蟲的自然語言指示。
- 類型: integerlimit最小值:1
爬蟲停止前會處理的連結總數。
- 類型: integermax
_breadth 最小值:1最大值:500樹的每一層最多跟隨的連結數。
- 類型: integermax
_depth 最小值:1最大值:5對應的最大深度。
- 類型: array string[]select
_domains 用於將爬取限定到特定網域或子網域的正規表達式模式。
- 類型: array string[]select
_paths 用於僅選取具有特定路徑模式之 URL 的正規表達式模式。
- 類型: number 格式: floattimeout最小值:10最大值:150
對應操作的最長等待時間（秒）。
- 類型: object200
已成功傳回網站地圖結果。
- 類型: stringbase
_url 被對應的基準 URL。
- 類型: stringrequest
_id 唯一的請求識別碼。
- 類型: number 格式: floatresponse
_time 完成該請求所用的時間（秒）。
- 類型: array string[]results
- 類型: objectusage
- credits類型: integer
此請求的額度用量詳情。
application/json - 400
無法處理該要求。請檢查請求參數。
- 401
需要有效的 Felo API 金鑰。
- 402
由於未符合計費要求，要求無法繼續。
- 403
該帳戶無權執行此操作。
- 429
已達到要求或支出上限。
- 502
服務無法完成該要求。
- 503
API 或計費服務暫時無法使用。
- 504
服務在處理要求時逾時。
- default
錯誤回應；上游透傳回應可能採用供應商格式
application/json
curl https://openapi.felo.ai/v1/beta/tavily/map \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"url": "docs.tavily.com",
"instructions": "",
"max_depth": 1,
"max_breadth": 20,
"limit": 50,
"select_paths": [
""
],
"select_domains": [
""
],
"exclude_paths": [
""
],
"exclude_domains": [
""
],
"allow_external": true,
"timeout": 150,
"include_usage": false
}'
{
"base_url": "string",
"results": [
"string"
],
"response_time": 1,
"usage": {
"credits": 1
},
"request_id": "string"
}