เอกสาร API ข้อมูลอ้างอิง SDK ข้อมูลอ้างอิง การใช้งาน Agent AI ทักษะ

การค้นหาเว็บ

ทำแผนที่ URL ของเว็บไซต์

สำรวจกราฟลิงก์ของเว็บไซต์จาก URL รากและส่งคืน URL ที่ค้นพบ นี่เป็น endpoint สำหรับ discovery เท่านั้น ไม่มีฟิลด์ดึงเนื้อหา ใช้ Bearer API key หรือส่ง api_key ใน JSON body เป็นทางเลือกเพื่อความเข้ากันได้ รองรับทั้งสอง base URL และจะละเว้นฟิลด์ที่ไม่รู้จัก คำตอบมี base_url อาร์เรย์ URL results response_time usage.credits และ usage.cost ที่เราเพิ่มตามราคาต่อเครดิตของผู้ดูแล และ request_id การทำแผนที่คิด 1 credit ต่อ 10 หน้าที่สำเร็จ หรือ 2 credits เมื่อระบุ instructions หน้าที่ล้มเหลวไม่คิดค่าใช้จ่าย เครดิตจริงหักจากโควต้าฟรีรายวันที่ใช้ร่วมกัน หากค่าประเมินจาก 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

API key เป็น bearer token ใน header Authorization

Body

urlจำเป็น

string

URL รากที่จะเริ่มทำแผนที่ สามารถละ scheme ได้ เช่น docs.tavily.com

required; scheme optional

Example: "docs.tavily.com"

instructions

string

คำสั่ง discovery ภาษาธรรมชาติ เมื่อระบุแล้วค่า mapping จะเป็น 2 credits แทน 1 ต่อ 10 หน้าที่สำเร็จ

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 หรือ 2 credits เมื่อระบุ instructions

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"
}