Web Search
Search public web content with Tavily.
Tavily تلاش
ویب تلاش کریں اور عنوانات، URLs اور مواد کے اسنیپٹس کے ساتھ درجہ بند نتائج واپس کریں۔ query درکار ہے۔ نتائج کی تعداد کنٹرول کرنے کے لیے max_results اور تلاش کا موڈ منتخب کرنے کے لیے search_depth استعمال کریں۔ اضافی answer، images اور خام مواد صرف طلب کیے جانے پر واپس ہوتے ہیں۔ ریسورس استعمال کی معلومات حاصل کرنے کے لیے include_usage سیٹ کریں؛ usage.credits Felo کا چارج نہیں ہے۔
قیمت کا حوالہ
- میٹرنگ: میٹر شدہ جوابی یونٹس۔
- حوالہ جاتی درخواست کا تخمینہ: USD 0.016۔
- فی یونٹ لاگت کی بنیاد: USD 0.008۔
- ریسورس یونٹ:
tavily_credit۔ - حوالہ جاتی صارف ملٹی پلائر: 1.0۔ تصفیہ شدہ صارف رقم پر اسے دوبارہ لاگو نہیں کریں۔
- لاگت کی بنادیں حتمی صارف قیمت کا تعین نہیں کرتیں، بشمول اس کے کہ صفر ہوں۔
صرف حوالہ جاتی میٹا ڈیٹا، نہ کہ اکاؤنٹ کا کوٹ، ضمانت شدہ قیمت یا اخراجات کی حد۔ ریسورس کریڈٹس Felo کریڈٹس نہیں ہیں۔ حتمی چارجز Felo کے بلنگ ریکارڈز کے مطابق ہوں گے۔
- قسم: stringqueryلازمی
Tavily کے ساتھ چلائی جانے والی تلاش کی کوئری۔
- قسم: booleanauto
_parameters کوئری کے مواد کی بنیاد پر تلاش کے پیرامیٹرز خودکار طور پر ترتیب دیں۔
- قسم: integerchunks
_per _source کم از کم:1زیادہ سے زیادہ:3فی ماخذ واپس کیے جانے والے متعلقہ چنکس کی زیادہ سے زیادہ تعداد۔
- قسم: string enumcountry
کسی مخصوص ملک کے تلاش کے نتائج کو بوسٹ کریں۔ صرف اس وقت دستیاب جب topic general ہو۔
اقدار- afghanistan
- albania
- algeria
- andorra
- angola
- قسم: string فارمیٹ: dateend
_date متعین کردہ آخری تاریخ سے پہلے کے نتائج واپس کریں۔
- قسم: array string[] …150exclude
_domains تلاش کے نتائج سے خاص طور پر خارج کرنے کے لیے ڈومینز کی فہرست۔
- include
_answer LLM کے تیار کردہ جواب کو شامل کریں۔ true ڈیفالٹ جواب کا موڈ استعمال کرتا ہے؛ basic یا advanced جواب کی تیاری کا موڈ منتخب کرتا ہے۔
- قسم: boolean
LLM کے تیار کردہ جواب کو شامل کریں۔ true ڈیفالٹ جواب کا موڈ استعمال کرتا ہے؛ basic یا advanced جواب کی تیاری کا موڈ منتخب کرتا ہے۔
- قسم: array string[] …300include
_domains تلاش کے نتائج میں خاص طور پر شامل کرنے کے لیے ڈومینز کی فہرست۔
- قسم: booleaninclude
_favicon ہر نتیجے کے لیے فیویکون URL شامل کریں۔
- قسم: booleaninclude
_image _descriptions جب include_images true ہو تو ہر امیج کے لیے وضاحتی متن شامل کریں۔
- قسم: booleaninclude
_images امیج تلاش انجام دیں اور نتائج شامل کریں۔
- include
_raw _content ہر تلاش کے نتیجے کے لیے صاف شدہ اور پارس شدہ مواد شامل کریں۔ true یا markdown مارک ڈاؤن واپس کرتا ہے؛ text سادہ متن واپس کرتا ہے اور تاخیر بڑھا سکتا ہے۔
- قسم: boolean
ہر تلاش کے نتیجے کے لیے صاف شدہ اور پارس شدہ مواد شامل کریں۔ true یا markdown مارک ڈاؤن واپس کرتا ہے؛ text سادہ متن واپس کرتا ہے اور تاخیر بڑھا سکتا ہے۔
- قسم: booleaninclude
_usage جواب میں ریسورس استعمال کی معلومات شامل کریں۔ یہ Felo بلنگ کی معلومات نہیں ہے۔
- قسم: integermax
_results کم از کم:0زیادہ سے زیادہ:20واپس کیے جانے والے تلاش کے نتائج کی زیادہ سے زیادہ تعداد۔
- قسم: booleansafe
_search تلاش کے نتائج سے بالغ یا غیر محفوظ مواد فلٹر کریں۔ صرف انٹرپرائز کے لیے؛ جب search_depth fast یا ultra-fast ہو تو معاون نہیں۔
- قسم: string enumsearch
_depth تاخیر اور مطابقت کے درمیان توازن کو کنٹرول کرتا ہے۔ advanced سب سے زیادہ مطابقت دیتا ہے مگر تاخیر اور لاگت زیادہ ہوتی ہے؛ basic متوازن ہے؛ fast اور ultra-fast کم تاخیر کے لیے بہتر بنائے گئے ہیں۔
اقدار- advanced
- basic
- fast
- ultra
-fast
- قسم: string فارمیٹ: datestart
_date متعین کردہ آغاز کی تاریخ کے بعد کے نتائج واپس کریں۔
- قسم: string enumtime
_range اشاعت کی تاریخ کی بنیاد پر نتائج فلٹر کرنے کے لیے وقت کی حد۔
اقدار- day
- week
- month
- year
- d
- w
- m
- y
- قسم: string enumtopic
تلاش کی کیٹیگری۔
اقدار- general
- news
- finance
- قسم: object200
تلاش کے نتائج کامیابی سے واپس ہوئے۔
- قسم: string | nullanswer
ایک مختصر LLM تیار کردہ جواب۔ جب include_answer false ہو یا کوئی جواب تیار نہ ہو تو null کے طور پر موجود ہوتا ہے۔
- قسم: array object[]images
- descriptionقسم: string
امیج کی وضاحت۔
- urlقسم: string
امیج URL۔
- قسم: stringquery
وہ تلاش کی کوئری جو چلائی گئی۔
- قسم: stringrequest
_id درخواست کا منفرد شناخت کنندہ۔
- قسم: number فارمیٹ: floatresponse
_time درخواست مکمل ہونے میں لگا وقت سیکنڈز میں۔
- قسم: array object[]results
- contentقسم: string
تلاش کے نتیجے کے مواد کا اسنیپٹ۔
- faviconقسم: string | null
تلاش کے نتیجے کا فیویکون URL۔
- rawقسم: string | null
_content صاف شدہ اور پارس شدہ ماخذ مواد۔ null، جب تک include_raw_content کی درخواست نہ کی جائے یا کوئی خام مواد دستیاب نہ ہو۔
- scoreقسم: number فارمیٹ: float
تلاش کے نتیجے کا مطابقت اسکور۔
- titleقسم: string
تلاش کے نتیجے کا عنوان۔
- urlقسم: string
تلاش کے نتیجے کا URL۔
- قسم: objectusage
- creditsقسم: integer
اس درخواست میں استعمال شدہ ریسورس یونٹس، نہ USD اور نہ Felo کریڈٹس۔
application/json - 400
درخواست پر کارروائی نہیں ہو سکی۔ درخواست کے پیرامیٹرز چیک کریں۔
- 401
درست Felo API کلید درکار ہے۔
- 402
درخواست آگے نہیں بڑھ سکتی کیونکہ بلنگ کی شرط پوری نہیں ہوئی۔
- 403
اکاؤنٹ کو یہ آپریشن کرنے کی اجازت نہیں۔
- 429
درخواست یا اخراجات کی حد پوری ہو گئی ہے۔
- 502
سروس درخواست مکمل نہیں کر سکی۔
- 503
API یا بلنگ سروس عارضی طور پر دستیاب نہیں۔
- 504
درخواست پر کارروائی کے دوران سروس کا وقت ختم ہو گیا۔
- default
خرابی کا جواب؛ اپ اسٹریم پاس تھرو جوابات پرووائیڈر کی شکلیں استعمال کر سکتے ہیں
application/json
curl --request POST https://openapi.felo.ai/v1/beta/tavily/search \
--header "Authorization: Bearer ${FELO_API_KEY:?Set FELO_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{"query": "Python official documentation", "search_depth": "basic", "max_results": 2, "include_usage": true}'
{
"query": "Python official documentation",
"answer": null,
"images": [],
"results": [
{
"title": "Python Documentation",
"url": "https://docs.python.org/3/",
"content": "Documentation for the Python programming language.",
"score": 0.98,
"raw_content": null
}
],
"response_time": 1.2,
"usage": {
"credits": 1
},
"request_id": "example-search-request"
}