वेब खोज — BazaarLink API

दस्तावेज़API संदर्भ SDK संदर्भ एजेंटिक उपयोग AI स्किल्स

वेब खोज

Tavily-संगत `POST /v1/search` भाषा मॉडल को कॉल किए बिना क्रमित परिणाम लौटाता है। `Authorization: Bearer <BazaarLink key>` या JSON body में `api_key` से प्रमाणीकरण करें। Base URL `https://api.bazaarlink.ai/v1` या पूर्ण रूप से समर्थित `https://bazaarlink.ai/api/v1` है। सभी frozen OpenAPI फ़ील्ड मान्य किए जाते हैं; अज्ञात फ़ील्ड अनदेखे किए जाते हैं। खोज गहराई, तारीख, भाषा, डोमेन, छवि, उत्तर और raw content विकल्प नीचे दिए अनुबंध का पालन करते हैं। मुफ़्त allowance के लिए सत्यापित email चाहिए और यह हर दिन 00:00 UTC पर रीसेट होता है; बिना balance वाले और funded accounts की allowances अलग हैं। वर्तमान N/M मान database के `getPublicFreeSearchAllowance()` से आते हैं; वर्तमान daily allowance के लिए pricing page देखें। मुफ़्त allowance समाप्त होने और balance न होने पर 432 लौटता है। ग्राहक मूल्य admin द्वारा कॉन्फ़िगर प्रति-credit मूल्य से गुणा किए गए credits के बराबर है। डॉलर मूल्य hard-code नहीं है; pricing page और हर response के `usage.cost` को देखें। Python: `TavilyClient(api_key=..., api_base_url='https://api.bazaarlink.ai/v1')`; JS: `tavily({ apiKey, apiBaseURL })`; LangChain: `TavilySearch(api_base_url=...)`।

POST/v1/search

प्राधिकरण

Authorizationआवश्यक

string · header

Authorization हेडर में bearer token के रूप में API कुंजी।

Body

queryआवश्यक

string

निष्पादित की जाने वाली खोज क्वेरी।

required; non-empty search query

Example: who is Leo Messi?

search_depth

string

विलंबता, प्रासंगिकता और परिणाम सामग्री का निर्माण नियंत्रित करता है। डिफ़ॉल्ट `basic` है; `basic`, `fast`, `ultra-fast` की लागत 1 credit और `advanced` की 2 credits है।

default: basic

advancedbasicfastultra-fast

chunks_per_source

integer

प्रति स्रोत संबंधित सामग्री खंडों की अधिकतम संख्या। डिफ़ॉल्ट 3; सीमा 1–3। `advanced`, `basic` और `fast` में उपलब्ध।

default: 3; 1..3

max_results

integer

लौटाए जाने वाले खोज परिणामों की अधिकतम संख्या। डिफ़ॉल्ट 10; सीमा 0–20।

default: 10; 0..20

Example: 1

topic

string

खोज विषय। डिफ़ॉल्ट `general`; वर्तमान समाचार के लिए `news` और वित्तीय सामग्री के लिए `finance` का उपयोग करें।

default: general

generalnewsfinance

time_range

string

प्रकाशन या अपडेट की तारीख के आधार पर फ़िल्टर करता है। डिफ़ॉल्ट सेट नहीं है। अनुमत मान: `day`, `week`, `month`, `year`, `d`, `w`, `m`, `y`।

default: null

dayweekmonthyeardwmy

start_date

string

इस तारीख के बाद प्रकाशित या अपडेट किए गए परिणाम लौटाता है। प्रारूप: YYYY-MM-DD।

default: null; format YYYY-MM-DD

Example: 2025-02-09

end_date

string

इस तारीख से पहले प्रकाशित या अपडेट किए गए परिणाम लौटाता है। प्रारूप: YYYY-MM-DD।

default: null; format YYYY-MM-DD

Example: 2025-12-29

include_published_date

boolean

प्रत्येक परिणाम में अनुमानित प्रकाशन या अपडेट तारीख शामिल करता है। `news` विषय के लिए अपने-आप सक्षम। डिफ़ॉल्ट `false`।

default: false

filter_by_published_date

boolean

`time_range`, `start_date` या `end_date` विंडो के बाहर के परिणाम हटाता है, जिनमें पहचान योग्य तारीख न होने वाले परिणाम भी शामिल हैं। डिफ़ॉल्ट `false`; `true` `include_published_date` भी सक्षम करता है।

default: false

include_answer

boolean | string

LLM द्वारा बनाया गया उत्तर शामिल करता है। डिफ़ॉल्ट `false`; boolean या `basic`/`advanced` स्वीकार करता है।

default: false

basicadvanced

include_raw_content

boolean | string

प्रत्येक परिणाम के लिए साफ़ किया गया HTML कंटेंट शामिल करता है। डिफ़ॉल्ट `false`; boolean या `markdown`/`text` स्वीकार करता है।

default: false

markdowntext

include_images

boolean

शीर्ष स्तर पर क्वेरी-संबंधी छवियां और प्रत्येक परिणाम के अंदर स्रोत छवियां शामिल करता है। डिफ़ॉल्ट `false`।

default: false

include_image_descriptions

boolean

जब `include_images` `true` हो, तो प्रत्येक छवि का विवरण भी जोड़ता है। डिफ़ॉल्ट `false`।

default: false

include_favicon

boolean

प्रत्येक परिणाम के लिए favicon URL शामिल करना है या नहीं। डिफ़ॉल्ट `false`।

default: false

include_domains

string[]

परिणामों को सूचीबद्ध डोमेन तक सीमित करता है; अधिकतम 300 डोमेन। डिफ़ॉल्ट खाली array।

default: []; maximum 300 items

exclude_domains

string[]

सूचीबद्ध डोमेन के परिणामों को बाहर करता है; अधिकतम 150 डोमेन। डिफ़ॉल्ट खाली array।

default: []; maximum 150 items

include_domains_mode

string

`include_domains` के लागू होने का तरीका नियंत्रित करता है। `restrict` केवल उन डोमेन तक सीमित करता है; `prefer` उन्हें प्राथमिकता देता है पर अन्य डोमेन भी लौटा सकता है। `include_domains` आवश्यक है, अन्यथा 400। डिफ़ॉल्ट सेट नहीं।

default: null; requires include_domains

restrictprefer

country

string

चयनित देश के परिणामों को प्राथमिकता देता है। केवल तब उपलब्ध जब `topic` `general` हो। डिफ़ॉल्ट सेट नहीं।

default: null; only when topic is general

afghanistanalbaniaalgeriaandorraangolaargentinaarmeniaaustraliaaustriaazerbaijanbahamasbahrainbangladeshbarbadosbelarusbelgiumbelizebeninbhutanboliviabosnia and herzegovinabotswanabrazilbruneibulgariaburkina fasoburundicambodiacamerooncanadacape verdecentral african republicchadchilechinacolombiacomoroscongocosta ricacroatiacubacyprusczech republicdenmarkdjiboutidominican republicecuadoregyptel salvadorequatorial guineaeritreaestoniaethiopiafijifinlandfrancegabongambiageorgiagermanyghanagreeceguatemalaguineahaitihondurashungaryicelandindiaindonesiairaniraqirelandisraelitalyjamaicajapanjordankazakhstankenyakuwaitkyrgyzstanlatvialebanonlesotholiberialibyaliechtensteinlithuanialuxembourgmadagascarmalawimalaysiamaldivesmalimaltamauritaniamauritiusmexicomoldovamonacomongoliamontenegromoroccomozambiquemyanmarnamibianepalnetherlandsnew zealandnicaraguanigernigerianorth koreanorth macedonianorwayomanpakistanpanamapapua new guineaparaguayperuphilippinespolandportugalqatarromaniarussiarwandasaudi arabiasenegalserbiasingaporeslovakiasloveniasomaliasouth africasouth koreasouth sudanspainsri lankasudanswedenswitzerlandsyriataiwantajikistantanzaniathailandtogotrinidad and tobagotunisiaturkeyturkmenistanugandaukraineunited arab emiratesunited kingdomunited statesuruguayuzbekistanvenezuelavietnamyemenzambiazimbabwe

language

string

चयनित भाषा के परिणामों को प्राथमिकता देता है। ISO 639-1 कोड या अंग्रेज़ी भाषा नाम स्वीकार करता है। डिफ़ॉल्ट सेट नहीं।

default: null

Example: en

filter_by_language

boolean

`language` से मेल न खाने वाले परिणामों को सख्ती से हटाता है। `language` आवश्यक है, अन्यथा 400। डिफ़ॉल्ट `false`।

default: false; requires language

auto_parameters

boolean

क्वेरी के आशय से खोज पैरामीटर अपने-आप चुनता है। स्पष्ट मान प्राथमिक हैं; `include_answer`, `include_raw_content` और `max_results` मैन्युअल रूप से सेट करने होंगे। प्रति अनुरोध 2 credits अतिरिक्त। डिफ़ॉल्ट `false`।

default: false; costs 2 credits

exact_match

boolean

केवल क्वेरी में उद्धृत वाक्यांश वाले परिणाम लौटाता है, समानार्थी और अर्थगत रूपों को छोड़कर। डिफ़ॉल्ट `false`।

default: false

include_usage

boolean

प्रतिक्रिया में credit उपयोग शामिल करना है या नहीं। डिफ़ॉल्ट `false`।

default: false

safe_search

boolean

वयस्क या असुरक्षित सामग्री को फ़िल्टर करता है। डिफ़ॉल्ट `false`; `fast` और `ultra-fast` में समर्थित नहीं।

default: false; unsupported for fast and ultra-fast

api_key

string

वैकल्पिक JSON body प्रमाणीकरण फ़ील्ड। Bearer header न होने पर BazaarLink API key यहां दें; सत्यापन और अग्रेषण से पहले इसे हटा दिया जाता है।

days

integer

SDK संगतता फ़ील्ड `days`। संगतता के लिए स्वीकार किया जाता है; योजना के अनुसार इसे संगतता परत आगे भेज सकती है या अनदेखा कर सकती है और यह frozen OpenAPI schema का भाग नहीं है।

max_hours

integer

SDK संगतता फ़ील्ड `max_hours`। संगतता के लिए स्वीकार किया जाता है; योजना के अनुसार इसे संगतता परत आगे भेज सकती है या अनदेखा कर सकती है और यह frozen OpenAPI schema का भाग नहीं है।

fetch_timeout

number

SDK संगतता फ़ील्ड `fetch_timeout`। संगतता के लिए स्वीकार किया जाता है; योजना के अनुसार इसे संगतता परत आगे भेज सकती है या अनदेखा कर सकती है और यह frozen OpenAPI schema का भाग नहीं है।

cache_fallback

boolean

SDK संगतता फ़ील्ड `cache_fallback`। संगतता के लिए स्वीकार किया जाता है; योजना के अनुसार इसे संगतता परत आगे भेज सकती है या अनदेखा कर सकती है और यह frozen OpenAPI schema का भाग नहीं है।

timeout

number

SDK-संगत `timeout` फ़ील्ड। संगतता के लिए स्वीकार; खोज सेवा-पक्ष timeout का उपयोग करती है और अज्ञात या असमर्थित फ़ील्ड अनदेखे किए जाते हैं।

POST /v1/search

1
2
3
4
5
6
7
8
9
10
curl https://api.bazaarlink.ai/v1/search \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "latest news on open-source language models",
    "search_depth": "basic",
    "max_results": 5,
    "topic": "news",
    "time_range": "week"
  }'

प्रतिक्रिया उदाहरण

सफल response में `query`, वैकल्पिक `answer`, शीर्ष-स्तरीय `images`, `results` (हर आइटम में `title`, `url`, `content`, `score` और वैकल्पिक `raw_content`, `published_date`, `favicon`, `images`, `id`), वैकल्पिक `auto_parameters`, `response_time`, `usage` (`credits` और हमारा additive `cost`) और `request_id` होते हैं। `usage.cost` ग्राहक से लिया गया USD मूल्य है, COGS नहीं; `request_id` BazaarLink बनाता है।

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
{
  "query": "Who is Leo Messi?",
  "answer": "Lionel Messi is an Argentine footballer.",
  "images": [
    {
      "url": "https://example.com/messi.jpg",
      "description": "Lionel Messi"
    }
  ],
  "results": [
    {
      "title": "Lionel Messi Facts | Britannica",
      "url": "https://www.britannica.com/facts/Lionel-Messi",
      "content": "Lionel Messi is an Argentine footballer.",
      "score": 0.81025416,
      "raw_content": null,
      "published_date": "Tue, 11 Mar 2025 17:00:00 GMT",
      "favicon": "https://britannica.com/favicon.png",
      "images": [
        {
          "url": "https://example.com/messi.jpg",
          "description": "Lionel Messi"
        }
      ],
      "id": "a3f9c2-04"
    }
  ],
  "auto_parameters": {
    "topic": "general",
    "search_depth": "basic"
  },
  "response_time": 1.67,
  "usage": {
    "credits": 1,
    "cost": "<customer_price_usd>"
  },
  "request_id": "123e4567-e89b-12d3-a456-426614174111"
}