أنشئ خرائط مواقع شاملة باستخدام 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"
}