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

वेब खोज

वेबसाइट URL मैप करें

रूट URL से वेबसाइट के लिंक ग्राफ़ का अन्वेषण करें और खोजे गए URL लौटाएँ। यह केवल discovery endpoint है और इसमें कंटेंट-एक्सट्रैक्शन फ़ील्ड नहीं हैं। Bearer API कुंजी या संगतता के लिए JSON body में api_key का उपयोग करें; दोनों base URL समर्थित हैं। अज्ञात फ़ील्ड अनदेखे किए जाते हैं। उत्तर में base_url, URL स्ट्रिंग का results array, response_time, व्यवस्थापक द्वारा तय प्रति-credit मूल्य पर आधारित अतिरिक्त usage.credits और usage.cost, तथा request_id शामिल हैं। Mapping की लागत हर 10 सफल पृष्ठों पर 1 credit, या instructions होने पर 2 credits है; विफल पृष्ठ निःशुल्क हैं। वास्तविक credits साझा दैनिक मुफ़्त सीमा से लिए जाते हैं। limit से अनुमान शेष सीमा से अधिक हो तो अतिरिक्त भाग शेष राशि से लिया जाता है, या शेष राशि न होने पर 432 लौटाकर limit कम करने का सुझाव दिया जाता है। SDK उदाहरण; कुंजी को पर्यावरण चर या किसी अन्य सुरक्षित सर्वर-साइड सेटिंग में रखें। Python: from tavily import TavilyClient client = TavilyClient(api_key="...", api_base_url="https://api.bazaarlink.ai/v1") response = client.map("docs.tavily.com") JavaScript: import { tavily } from "@tavily/core" const tvly = tavily({ apiKey: process.env.BAZAARLINK_API_KEY, apiBaseURL: "https://api.bazaarlink.ai/v1" }) const response = await tvly.map("docs.tavily.com")

POST/v1/map

प्राधिकरण

Authorizationआवश्यक

string · header

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

Body

urlआवश्यक

string

मैप शुरू करने का रूट URL; scheme वैकल्पिक है, जैसे docs.tavily.com।

required; scheme optional

Example: "docs.tavily.com"

instructions

string

प्राकृतिक भाषा discovery निर्देश; इससे हर 10 सफल पृष्ठों का mapping खर्च 1 के बजाय 2 credits हो जाता है।

Example: "Find Python SDK pages"

max_depth

integer

अधिकतम मैपिंग गहराई, 1–5, डिफ़ॉल्ट 1।

1-5; default: 1

Example: 1

max_breadth

integer

हर स्तर पर प्रति पृष्ठ फ़ॉलो किए जाने वाले अधिकतम लिंक, 1–500, डिफ़ॉल्ट 20।

1-500; default: 20

Example: 20

limit

integer

रुकने से पहले संसाधित किए जाने वाले कुल लिंक; न्यूनतम 1, डिफ़ॉल्ट 50।

minimum: 1; default: 50

Example: 50

select_paths

string[]

पथ चयन के लिए regex पैटर्न की सूची; अधिकतम 50 प्रविष्टियाँ और प्रत्येक पैटर्न 200 वर्ण तक।

max 50 entries; max 200 characters per regex

Example: ["^/docs/.*"]

select_domains

string[]

डोमेन चयन के लिए regex पैटर्न की सूची; अधिकतम 50 प्रविष्टियाँ और प्रत्येक पैटर्न 200 वर्ण तक।

max 50 entries; max 200 characters per regex

Example: ["^docs\.example\.com$"]

exclude_paths

string[]

पथ बहिष्करण के लिए regex पैटर्न की सूची; अधिकतम 50 प्रविष्टियाँ और प्रत्येक पैटर्न 200 वर्ण तक।

max 50 entries; max 200 characters per regex

Example: ["^/private/.*"]

exclude_domains

string[]

डोमेन बहिष्करण के लिए regex पैटर्न की सूची; अधिकतम 50 प्रविष्टियाँ और प्रत्येक पैटर्न 200 वर्ण तक।

max 50 entries; max 200 characters per regex

Example: ["^private\.example\.com$"]

allow_external

boolean

बाहरी डोमेन लिंक को अंतिम परिणाम में शामिल करना है या नहीं; डिफ़ॉल्ट true।

default: true

Example: true

timeout

number

मैप के लिए प्रतीक्षा सेकंड। Tavily सीमा 10–150 है, पर BazaarLink की प्रभावी अधिकतम 90 सेकंड है; 90 से अधिक मान 90 किया जाता है।

Tavily: 10-150; BazaarLink default/effective maximum: 90 seconds; values above 90 are lowered to 90

Example: 90

include_usage

boolean

उत्तर में usage शामिल करना है या नहीं; डिफ़ॉल्ट false, शामिल होने पर credits और usage.cost दिखते हैं।

default: false

Example: false

POST /v1/map

1
2
3
4
5
6
7
curl https://api.bazaarlink.ai/v1/map   -H "Authorization: Bearer $BAZAARLINK_API_KEY"   -H "Content-Type: application/json"   -d '{
    "url": "docs.tavily.com",
    "instructions": "Find Python SDK pages",
    "limit": 20,
    "timeout": 90,
    "include_usage": true
  }'

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

मैपिंग पूरी हुई। results में खोजे गए URL स्ट्रिंग हैं; हर 10 सफल पृष्ठों की लागत 1 credit, instructions होने पर 2 credits है।

1
2
3
4
5
6
7
8
9
10
11
12
13
{
  "base_url": "docs.tavily.com",
  "results": [
    "https://docs.tavily.com/welcome",
    "https://docs.tavily.com/documentation/api-credits"
  ],
  "response_time": 1.23,
  "usage": {
    "credits": 1,
    "cost": 0.01
  },
  "request_id": "map_123e4567-e89b-12d3-a456-426614174111"
}