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

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

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

`POST /v1/search` ที่เข้ากันได้กับ Tavily ส่งคืนผลลัพธ์ที่จัดอันดับโดยไม่เรียกโมเดลภาษา ยืนยันตัวตนด้วย `Authorization: Bearer <BazaarLink key>` หรือใส่ `api_key` ใน JSON body ใช้ base URL `https://api.bazaarlink.ai/v1` หรือ URL เดิมที่รองรับเต็มรูปแบบ `https://bazaarlink.ai/api/v1` ฟิลด์ OpenAPI ที่กำหนดไว้ทั้งหมดจะถูกตรวจสอบ ส่วนฟิลด์ที่ไม่รู้จักจะถูกเพิกเฉย ตัวเลือกด้านความลึก วันที่ ภาษา โดเมน รูปภาพ คำตอบ และ raw content ทำงานตามสัญญาด้านล่าง free allowance ต้องยืนยัน email และรีเซ็ตทุกวันเวลา 00:00 UTC บัญชีที่ไม่มี balance และบัญชีที่มีเงินมี allowance ต่างกัน ค่า N/M ปัจจุบันมาจากฐานข้อมูลผ่าน `getPublicFreeSearchAllowance()` ดู allowance รายวันปัจจุบันที่ pricing page เมื่อใช้ free allowance หมดและไม่มี balance จะตอบ 432 ราคาลูกค้าคือจำนวน credit คูณราคาต่อ credit ที่ admin ตั้งค่า ไม่ hard-code ราคาดอลลาร์ ให้ดู pricing page และอ่าน `usage.cost` ในทุก response 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

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

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

จะรวม URL favicon สำหรับแต่ละผลลัพธ์หรือไม่ ค่าเริ่มต้น `false`

default: false

include_domains

string[]

จำกัดผลลัพธ์ไว้ที่โดเมนที่ระบุ สูงสุด 300 โดเมน ค่าเริ่มต้นเป็นอาร์เรย์ว่าง

default: []; maximum 300 items

exclude_domains

string[]

ไม่รวมผลลัพธ์จากโดเมนที่ระบุ สูงสุด 150 โดเมน ค่าเริ่มต้นเป็นอาร์เรย์ว่าง

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

เลือกพารามิเตอร์การค้นหาอัตโนมัติตามเจตนาของคำค้น ค่า explicit มีลำดับสูงกว่า ต้องตั้ง `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` ยอมรับเพื่อความเข้ากันได้ ตามแผนสามารถส่งต่อหรือเพิกเฉยในชั้น compatibility และไม่ใช่ส่วนหนึ่งของ frozen OpenAPI schema

max_hours

integer

ฟิลด์ความเข้ากันได้ของ SDK `max_hours` ยอมรับเพื่อความเข้ากันได้ ตามแผนสามารถส่งต่อหรือเพิกเฉยในชั้น compatibility และไม่ใช่ส่วนหนึ่งของ frozen OpenAPI schema

fetch_timeout

number

ฟิลด์ความเข้ากันได้ของ SDK `fetch_timeout` ยอมรับเพื่อความเข้ากันได้ ตามแผนสามารถส่งต่อหรือเพิกเฉยในชั้น compatibility และไม่ใช่ส่วนหนึ่งของ frozen OpenAPI schema

cache_fallback

boolean

ฟิลด์ความเข้ากันได้ของ SDK `cache_fallback` ยอมรับเพื่อความเข้ากันได้ ตามแผนสามารถส่งต่อหรือเพิกเฉยในชั้น compatibility และไม่ใช่ส่วนหนึ่งของ frozen OpenAPI schema

timeout

number

ฟิลด์ `timeout` ที่เข้ากันได้กับ SDK ยอมรับเพื่อความเข้ากันได้ การค้นหาใช้ 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"
  }'

ตัวอย่างการตอบกลับ

การตอบกลับสำเร็จมี `query`, `answer` ที่ไม่บังคับ, `images` ระดับบนสุด, `results` (แต่ละรายการมี `title`, `url`, `content`, `score` และอาจมี `raw_content`, `published_date`, `favicon`, `images`, `id`), `auto_parameters` ที่ไม่บังคับ, `response_time`, `usage` (`credits` และ `cost` ที่เราเพิ่ม) และ `request_id` `usage.cost` คือราคาดอลลาร์ที่เรียกเก็บจากลูกค้า ไม่ใช่ 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"
}