Web Content
Web crawling, URL discovery and page extraction.
Tavily Extract
חילוץ תוכן קריא מכתובת URL אחת או ממערך כתובות. בחרו טקסט או Markdown באמצעות format. בדקו גם את results וגם את failed_results: כתובת שנכשלה יכולה להיות מדווחת בתגובת HTTP מוצלחת. הגדירו include_usage כדי לקבל מידע על שימוש במשאבים; usage.credits אינו חיוב של Felo.
מראה תמחור
- מדידה: יחידות תגובה נמדדות.
- אומדן בקשת ייחוס: 0.024 דולר ארה״ב.
- בסיס עלות יחידה: 0.008 דולר ארה״ב.
- יחידת משאב:
tavily_credit. - מכפיל לקוח לייחוס: 1.0. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.
- בסיסי עלות אינם קובעים את מחיר הלקוח הסופי, גם כשהם אפס.
זהו מטא-נתון לעיון בלבד, לא הצעת מחיר לחשבון, לא מחיר מובטח ולא תקרת הוצאה. קרדיטי משאבים אינם קרדיטים של Felo. החיוב הסופי נעשה לפי רשומות החיוב של Felo.
- urlsחובה
כתובת URL או כתובות URL לחילוץ תוכן מהן. מתקבלים גם מחרוזת URL יחידה וגם מערך של מחרוזות URL.
- סוג: string
כתובת URL או כתובות URL לחילוץ תוכן מהן. מתקבלים גם מחרוזת URL יחידה וגם מערך של מחרוזות URL.
- סוג: integerchunks
_per _source מינימום:1מקסימום:5המספר המרבי של קטעים רלוונטיים המוחזרים לכל מקור. זמין רק כשמסופק query.
- סוג: string enumextract
_depth עומק תהליך החילוץ.
ערכים- basic
- advanced
- סוג: string enumformat
הפורמט של תוכן עמוד האינטרנט שחולץ.
ערכים- markdown
- text
- סוג: booleaninclude
_favicon כלילת כתובת ה-URL של ה-favicon עבור כל תוצאה.
- סוג: booleaninclude
_images כלילת רשימת תמונות שחולצו מכתובות ה-URL.
- סוג: booleaninclude
_usage כלילת מידע על שימוש במשאבים בתגובה. זה אינו מידע חיוב של Felo.
- סוג: stringquery
כוונת המשתמש לדירוג מחדש של קטעי התוכן שחולצו.
- סוג: number פורמט: floattimeoutמינימום:1מקסימום:60
הזמן המרבי בשניות להמתנה לחילוץ כתובות URL. אם יושמט, זמני החסימה המוגדרים כברירת מחדל תלויים ב-extract_depth: 10 שניות עבור basic ו-30 שניות עבור advanced.
- סוג: object200
תוצאות החילוץ הוחזרו בהצלחה.
- סוג: array string[]failed
_results רשימת כתובות URL שלא ניתן היה לעבד.
- סוג: stringrequest
_id מזהה בקשה ייחודי.
- סוג: number פורמט: floatresponse
_time הזמן בשניות שנדרש להשלמת הבקשה.
- סוג: array object[]results
- faviconסוג: string | null
כתובת URL של favicon עבור התוכן שחולץ.
- imagesסוג: array string[]
תמונות שחולצו מכתובת ה-URL כאשר include_images הוא true.
- rawסוג: string
_content תוכן גולמי שחולץ מכתובת ה-URL.
- titleסוג: string
כותרת העמוד שחולץ.
- urlסוג: string
כתובת ה-URL של התוכן שחולץ.
- סוג: objectusage
- creditsסוג: integer
יחידות משאב שנצרכו על ידי בקשה זו, לא דולרים אמריקאיים או קרדיטים של Felo.
application/json - 400
לא ניתן היה לעבד את הבקשה. בדקו את פרמטרי הבקשה.
- 401
נדרש מפתח API תקף של Felo.
- 402
לא ניתן להמשיך את הבקשה משום שדרישת חיוב אינה מתקיימת.
- 403
החשבון אינו מורשה לבצע את הפעולה הזו.
- 429
הגעתם למגבלת בקשות או לתקרת הוצאה.
- 502
השירות לא הצליח להשלים את הבקשה.
- 503
שירות ה-API או החיוב אינו זמין באופן זמני.
- 504
השירות פג בזמן הטיפול בבקשה.
- default
תגובת שגיאה; תגובות מעבר מהמעלה הזרם עשויות להשתמש בפורמטים של הספק
application/json
curl --request POST https://openapi.felo.ai/v1/beta/tavily/extract \
--header "Authorization: Bearer ${FELO_API_KEY:?Set FELO_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{"urls": ["https://example.com"], "extract_depth": "basic", "format": "text", "include_usage": true}'
{
"results": [
{
"url": "https://example.com",
"title": "Example Domain",
"raw_content": "This domain is for use in documentation examples.",
"images": []
}
],
"failed_results": [],
"response_time": 0.5,
"usage": {
"credits": 1
},
"request_id": "example-extract-request"
}