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 が 1 回の呼び出しで両方をこなします。
料金の参考情報
- 計測方法：レスポンスユニット単位で計測。
- 参考リクエスト見積もり：0.064 USD。
- ユニットコスト基準：USD 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"
}