Web Search
Search public web content with Tavily.
Tavily Search
वेब पर खोजें और शीर्षक, URL और कंटेंट स्निपेट के साथ रैंक किए गए परिणाम लौटाएँ। query आवश्यक है। परिणामों की संख्या नियंत्रित करने के लिए max_results और सर्च मोड चुनने के लिए search_depth का उपयोग करें। अतिरिक्त answer, images और raw content केवल अनुरोध किए जाने पर लौटाए जाते हैं। रिसोर्स उपयोग जानकारी पाने के लिए include_usage सेट करें; usage.credits Felo शुल्क नहीं है।
मूल्य संदर्भ
- मीटरिंग: मीटर की गई response यूनिट
- संदर्भ request अनुमान: USD 0.016
- यूनिट लागत आधार: USD 0.008
- रिसोर्स यूनिट:
tavily_credit - संदर्भ ग्राहक गुणक: 1.0। निपटाई गई ग्राहक राशि पर इसे दोबारा लागू न करें।
- लागत आधार अंतिम ग्राहक मूल्य तय नहीं करते, शून्य होने पर भी नहीं।
यह केवल संदर्भ मेटाडेटा है — खाते का कोटेशन, गारंटीशुदा मूल्य या खर्च सीमा नहीं। रिसोर्स क्रेडिट Felo क्रेडिट नहीं हैं। अंतिम शुल्क Felo बिलिंग रिकॉर्ड के अनुसार लगते हैं।
- टाइप: stringqueryआवश्यक
Tavily के साथ निष्पादित करने के लिए सर्च query।
- टाइप: booleanauto
_parameters query कंटेंट के आधार पर सर्च पैरामीटर स्वतः कॉन्फ़िगर करें।
- टाइप: integerchunks
_per _source न्यूनतम:1अधिकतम:3प्रति स्रोत लौटाए गए प्रासंगिक chunks की अधिकतम संख्या।
- टाइप: string enumcountry
किसी विशिष्ट देश के सर्च परिणामों को बूस्ट करें। केवल तब उपलब्ध जब topic general हो।
मान- afghanistan
- albania
- algeria
- andorra
- angola
- टाइप: string फ़ॉर्मेट: dateend
_date निर्दिष्ट end date से पहले के परिणाम लौटाएँ।
- टाइप: array string[] …150exclude
_domains सर्च परिणामों से विशेष रूप से बाहर रखने के लिए डोमेन की सूची।
- include
_answer LLM-जनरेटेड उत्तर शामिल करें। true डिफ़ॉल्ट उत्तर मोड उपयोग करता है; basic या advanced उत्तर जनरेशन मोड चुनता है।
- टाइप: boolean
LLM-जनरेटेड उत्तर शामिल करें। true डिफ़ॉल्ट उत्तर मोड उपयोग करता है; basic या advanced उत्तर जनरेशन मोड चुनता है।
- टाइप: array string[] …300include
_domains सर्च परिणामों में विशेष रूप से शामिल करने के लिए डोमेन की सूची।
- टाइप: booleaninclude
_favicon प्रत्येक परिणाम के लिए favicon URL शामिल करें।
- टाइप: booleaninclude
_image _descriptions जब include_images true हो तो प्रत्येक इमेज के लिए वर्णनात्मक टेक्स्ट जोड़ें।
- टाइप: booleaninclude
_images इमेज सर्च करें और परिणाम शामिल करें।
- include
_raw _content प्रत्येक सर्च परिणाम के लिए साफ़ और पार्स किया गया कंटेंट शामिल करें। true या markdown markdown लौटाता है; text सादा टेक्स्ट लौटाता है और विलंब बढ़ा सकता है।
- टाइप: boolean
प्रत्येक सर्च परिणाम के लिए साफ़ और पार्स किया गया कंटेंट शामिल करें। true या markdown markdown लौटाता है; text सादा टेक्स्ट लौटाता है और विलंब बढ़ा सकता है।
- टाइप: booleaninclude
_usage response में resource उपयोग जानकारी शामिल करें। यह Felo बिलिंग जानकारी नहीं है।
- टाइप: integermax
_results न्यूनतम:0अधिकतम:20लौटाने के लिए सर्च परिणामों की अधिकतम संख्या।
- टाइप: booleansafe
_search सर्च परिणामों से वयस्क या असुरक्षित कंटेंट फ़िल्टर करें। केवल Enterprise; जब search_depth fast या ultra-fast हो तो समर्थित नहीं।
- टाइप: string enumsearch
_depth लेटेंसी बनाम प्रासंगिकता के बीच संतुलन नियंत्रित करता है। advanced उच्च लेटेंसी और लागत के साथ सबसे अधिक प्रासंगिकता देता है; basic संतुलित है; fast और ultra-fast कम लेटेंसी के लिए अनुकूलित हैं।
मान- advanced
- basic
- fast
- ultra
-fast
- टाइप: string फ़ॉर्मेट: datestart
_date निर्दिष्ट start 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
जो सर्च query निष्पादित की गई।
- टाइप: stringrequest
_id अद्वितीय request पहचानकर्ता।
- टाइप: number फ़ॉर्मेट: floatresponse
_time request पूरा करने में लगा समय सेकंड में।
- टाइप: array object[]results
- contentटाइप: string
सर्च परिणाम का कंटेंट स्निपेट।
- faviconटाइप: string | null
सर्च परिणाम का favicon URL।
- rawटाइप: string | null
_content साफ़ और पार्स किया गया स्रोत कंटेंट। जब तक include_raw_content का अनुरोध न किया जाए या कच्चा कंटेंट उपलब्ध न हो, तब तक null।
- scoreटाइप: number फ़ॉर्मेट: float
सर्च परिणाम का प्रासंगिकता स्कोर।
- titleटाइप: string
सर्च परिणाम का शीर्षक।
- urlटाइप: string
सर्च परिणाम का URL।
- टाइप: objectusage
- creditsटाइप: integer
इस request द्वारा खपत resource इकाइयाँ, USD या Felo क्रेडिट नहीं।
application/json - 400
request संसाधित नहीं किया जा सका। request पैरामीटर जाँचें।
- 401
एक वैध Felo API key आवश्यक है।
- 402
request आगे नहीं बढ़ सकता क्योंकि बिलिंग आवश्यकता पूरी नहीं हुई है।
- 403
खाते को यह ऑपरेशन करने की अनुमति नहीं है।
- 429
request या खर्च की सीमा तक पहुँच गए हैं।
- 502
सेवा request पूरा नहीं कर सकी।
- 503
API या बिलिंग सेवा अस्थायी रूप से उपलब्ध नहीं है।
- 504
request संसाधित करते समय सेवा का समय समाप्त हो गया।
- default
त्रुटि response; upstream passthrough response प्रोवाइडर फ़ॉर्मेट का उपयोग कर सकते हैं।
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"
}