데이터 API / Tavily / Map

Generate comprehensive site maps using Tavily Map.

List a site's URLs from a root url without fetching any page content. Steer it with natural-language instructions and regex select_paths / exclude_paths / select_domains filters. Returns base_url and results — a flat array of URL strings, not objects — with response_time and request_id. Use it to size a site before committing to a crawl, then fetch only the parts that matter with extractWebContent. When you want the content rather than the shape, post_tavily_crawl does both in one call.

파라미터

경로, 쿼리, 헤더 파라미터가 없습니다.

요청 본문

urlstring필수
The root URL to begin the mapping.
instructionsstring선택
Natural language instructions for the crawler.
max_depthinteger선택
Max depth of the mapping.
max_breadthinteger선택
Max number of links to follow per level of the tree.
limitinteger선택
Total number of links the crawler will process before stopping.
select_pathsstring[]선택
Regex patterns to select only URLs with specific path patterns.
select_domainsstring[]선택
Regex patterns to select crawling to specific domains or subdomains.
exclude_pathsstring[]선택
Regex patterns to exclude URLs with specific path patterns.
exclude_domainsstring[]선택
Regex patterns to exclude specific domains or subdomains from mapping.
allow_externalboolean선택
Include external domain links in the final results list.
timeoutnumber선택
Maximum time in seconds to wait for the map operation.
include_usageboolean선택
Include credit usage information in the response.

요청 예시

curl -X POST "https://openapi.felo.ai/v1/beta/tavily/map" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "<string>",
  "instructions": "<string>",
  "max_depth": 0,
  "max_breadth": 0,
  "limit": 0,
  "select_paths": [
    "<string>"
  ],
  "select_domains": [
    "<string>"
  ],
  "exclude_paths": [
    "<string>"
  ]
}'

응답

응답 필드

base_urlstring선택
The base URL that was mapped.
resultsstring[]선택
response_timenumber선택
Time in seconds it took to complete the request.
usageobject선택
creditsinteger선택
Credit usage details for the request.
request_idstring선택
Unique request identifier.