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이 한 번의 호출로 둘 다 수행합니다.
가격 참고
- 과금 기준: 측정된 응답 단위.
- 참고 요청 추정치: USD 0.064.
- 단위 원가 기준: USD 0.008.
- 리소스 단위:
tavily_credit. - 참고 고객 배수: 1.0. 정산된 고객 금액에 다시 적용하지 마세요.
- 원가 기준은 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"
}