Felo API PlatformFelo API Platform
جميع endpoints الخاصة بـ Tavily
v0.2.0-beta
OpenAPI 3.1.0

أداة تجوّل في المواقع قائمة على الرسم البياني باستخدام Tavily Crawl.

الخادم:https://openapi.felo.ai
مكتبات العملاء

Web Content

​

Web crawling, URL discovery and page extraction.

Web Content العمليات

أداة تجوّل في المواقع قائمة على الرسم البياني باستخدام Tavily Crawl.

​

يجوب موقعًا انطلاقًا من url جذري ويعيد محتوى الصفحات التي يعثر عليها. وجّهه بـinstructions باللغة الطبيعية مع مرشّحات regex للمسارات والنطاقات، وحدّده بـmax_depth وmax_breadth وlimit. يعيد base_url وresults[] مع url وraw_content. استخدمه لتغطية واسعة لموقع واحد — التوثيق أو كتالوج أو مدونة منافس. يستجيب بشكل متزامن، بخلاف post_firecrawl_crawl: فذاك يعمل كمهمة في الخلفية ويناسب الزحف الأكبر من أن يُنتظر.

مرجع التسعير

  • القياس: وحدات الاستجابة المقيسة.
  • تقدير الطلب المرجعي: 0.024 دولار أمريكي.
  • أساس تكلفة الوحدة: 0.008 دولار أمريكي.
  • وحدة المورد: tavily_credit.
  • مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.
  • لا تحدد أسس التكلفة السعر النهائي للعميل، بما في ذلك عندما تكون صفرًا.

بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.

الجسم
مطلوب
application/json
  • url
    النوع: string
    مطلوب

    عنوان URL الجذري لبدء الزحف.

  • allow_external
    النوع: boolean

    تضمين روابط النطاقات الخارجية في قائمة النتائج النهائية.

  • chunks_per_source
    النوع: integer
    الحد الأدنى:  
    1
    الحد الأقصى:  
    5

    الحد الأقصى لعدد المقاطع ذات الصلة المعادة لكل مصدر.

  • exclude_domains
    النوع: array string[]

    أنماط regex لاستبعاد نطاقات أو نطاقات فرعية محددة من الزحف.

  • exclude_paths
    النوع: array string[]

    أنماط regex لاستبعاد عناوين URL ذات أنماط مسارات محددة.

  • extract_depth
    النوع: string تعداد

    عمق عملية الاستخراج.

    القيم
    • basic
    • advanced
  • format
    النوع: string تعداد

    تنسيق محتوى صفحة الويب المستخرج.

    القيم
    • markdown
    • text
  • include_favicon
    النوع: boolean

    تضمين عنوان URL لأيقونة الموقع لكل نتيجة.

  • include_images
    النوع: boolean

    تضمين الصور في نتائج الزحف.

  • include_usage
    النوع: boolean

    تضمين معلومات استخدام الأرصدة في الاستجابة.

  • instructions
    النوع: string

    تعليمات باللغة الطبيعية للزاحف.

  • limit
    النوع: integer
    الحد الأدنى:  
    1

    إجمالي عدد الروابط التي سيعالجها الزاحف قبل التوقف.

  • max_breadth
    النوع: integer
    الحد الأدنى:  
    1
    الحد الأقصى:  
    500

    الحد الأقصى لعدد الروابط المراد تتبعها لكل مستوى من الشجرة.

  • max_depth
    النوع: integer
    الحد الأدنى:  
    1
    الحد الأقصى:  
    5

    الحد الأقصى لعمق الزحف.

  • select_domains
    النوع: array string[]

    أنماط regex لتحديد الزحف إلى نطاقات أو نطاقات فرعية محددة.

  • select_paths
    النوع: array string[]

    أنماط regex لتحديد عناوين URL ذات أنماط مسارات محددة فقط.

  • timeout
    النوع: number التنسيق: float
    الحد الأدنى:  
    10
    الحد الأقصى:  
    150

    الحد الأقصى للوقت بالثواني لانتظار عملية الزحف.

الاستجابات
  • 200
    النوع: object

    أُعيدت نتائج الزحف بنجاح.

    • base_url
      النوع: string

      عنوان URL الأساسي الذي جرى زحفه.

    • request_id
      النوع: string

      معرّف فريد للطلب.

    • response_time
      النوع: number التنسيق: float

      الوقت بالثواني المستغرق لإكمال الطلب.

    • results
      النوع: array object[]
      • favicon
        النوع: string

        عنوان URL لأيقونة الموقع (favicon) للصفحة المزحوفة.

      • raw_content
        النوع: string

        المحتوى الخام المستخرج من الصفحة.

      • url
        النوع: string

        عنوان URL للصفحة المزحوفة.

    • usage
      النوع: object
      • credits
        النوع: integer

        تفاصيل استخدام الأرصدة للطلب.

    application/json
  • 400

    تعذّرت معالجة الطلب. تحقق من معاملات الطلب.

  • 401

    مطلوب مفتاح API صالح من Felo.

  • 402

    لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.

  • 403

    الحساب غير مصرّح له بهذه العملية.

  • 429

    تم بلوغ حد الطلبات أو حد الإنفاق.

  • 502

    تعذّر على الخدمة إكمال الطلب.

  • 503

    خدمة API أو الفوترة غير متاحة مؤقتًا.

  • 504

    انتهت مهلة الخدمة أثناء معالجة الطلب.

  • default

    استجابة خطأ؛ قد تستخدم استجابات المنبع الممرَّرة تنسيقات المزوّد

    application/json
Request Example for post/v1/beta/tavily/crawl
curl https://openapi.felo.ai/v1/beta/tavily/crawl \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "url": "docs.tavily.com",
  "instructions": "",
  "chunks_per_source": 3,
  "max_depth": 1,
  "max_breadth": 20,
  "limit": 50,
  "select_paths": [
    ""
  ],
  "select_domains": [
    ""
  ],
  "exclude_paths": [
    ""
  ],
  "exclude_domains": [
    ""
  ],
  "allow_external": true,
  "include_images": false,
  "extract_depth": "basic",
  "format": "markdown",
  "include_favicon": false,
  "timeout": 150,
  "include_usage": false
}'
{
  "base_url": "string",
  "results": [
    {
      "url": "string",
      "raw_content": "string",
      "favicon": "string"
    }
  ],
  "response_time": 1,
  "usage": {
    "credits": 1
  },
  "request_id": "string"
}
Graph-based website traversal tool using Tavily Crawl.