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 enum

    עומק תהליך החילוץ.

    ערכים
    • basic
    • advanced
  • format
    סוג: string enum

    הפורמט של תוכן עמוד האינטרנט שחולץ.

    ערכים
    • markdown
    • text
  • include_favicon
    סוג: boolean

    כלילת כתובת ה-URL של ה-favicon עבור כל תוצאה.

  • 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.