نقشه‌های جامع سایت را با Tavily Map تولید کنید.
Web Content
Web crawling, URL discovery and page extraction.
نقشه‌های جامع سایت را با Tavily Map تولید کنید.
URLهای یک سایت را از url ریشه بدون واکشی محتوای هیچ صفحه‌ای فهرست می‌کند. آن را با instructions به زبان طبیعی و فیلترهای regex 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 الگوهای regex برای حذف دامنه‌ها یا زیردامنه‌های مشخص از نقشه‌برداری.
- نوع: array string[]exclude
_paths الگوهای regex برای حذف URLهایی با الگوهای مسیر مشخص.
- نوع: booleaninclude
_usage شامل‌کردن اطلاعات مصرف اعتبار در پاسخ.
- نوع: stringinstructions
دستورهای زبان طبیعی برای خزنده.
- نوع: integerlimitحداقل:1
تعداد کل پیوندهایی که خزنده پیش از توقف پردازش می‌کند.
- نوع: integermax
_breadth حداقل:1حداکثر:500حداکثر تعداد پیوندهای دنبال‌شده در هر سطح از درخت.
- نوع: integermax
_depth حداقل:1حداکثر:5حداکثر عمق نقشه‌برداری.
- نوع: array string[]select
_domains الگوهای regex برای انتخاب خزش به دامنه‌ها یا زیردامنه‌های مشخص.
- نوع: array string[]select
_paths الگوهای regex برای انتخاب فقط URLهایی با الگوهای مسیر مشخص.
- نوع: number قالب: floattimeoutحداقل:10حداکثر:150
حداکثر زمان به ثانیه برای انتظار عملیات نقشه‌برداری.
- نوع: object200
نتایج Map با موفقیت برگردانده شد.
- نوع: stringbase
_url URL پایه‌ای که نقشه‌برداری شده است.
- نوع: stringrequest
_id شناسه یکتای درخواست.
- نوع: number قالب: floatresponse
_time زمان به ثانیه که تکمیل درخواست طول کشید.
- نوع: array string[]results
- نوع: objectusage
- creditsنوع: integer
جزئیات مصرف اعتبار برای درخواست.
application/json - 400
درخواست پردازش نشد. پارامترهای درخواست را بررسی کنید.
- 401
یک کلید API معتبر Felo لازم است.
- 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"
}