Tìm kiếm web — BazaarLink API

Tài liệu Tham chiếu API Tham chiếu SDK Sử dụng Agent Kỹ năng AI

Tìm kiếm web

`POST /v1/search` tương thích Tavily trả về kết quả xếp hạng mà không gọi mô hình ngôn ngữ. Xác thực bằng `Authorization: Bearer <BazaarLink key>` hoặc đặt `api_key` trong JSON body. Dùng base URL `https://api.bazaarlink.ai/v1` hoặc URL cũ được hỗ trợ đầy đủ `https://bazaarlink.ai/api/v1`. Mọi trường OpenAPI đã đóng băng đều được xác thực; trường không biết sẽ bị bỏ qua. Các tùy chọn về độ sâu, ngày, ngôn ngữ, miền, ảnh, câu trả lời và raw content tuân theo hợp đồng bên dưới. Hạn mức miễn phí yêu cầu email đã xác minh và đặt lại hằng ngày lúc 00:00 UTC; tài khoản không có số dư và tài khoản có tiền có hạn mức khác nhau. Giá trị N/M hiện tại lấy từ cơ sở dữ liệu qua `getPublicFreeSearchAllowance()`; xem pricing page để biết hạn mức ngày hiện tại. Khi hết hạn mức miễn phí và không có số dư, trả về 432. Giá khách hàng bằng số credit nhân với giá mỗi credit do admin cấu hình. Không hard-code giá USD; xem pricing page và đọc `usage.cost` trong từng phản hồi. Python dùng `TavilyClient(api_key=..., api_base_url='https://api.bazaarlink.ai/v1')`; JS dùng `tavily({ apiKey, apiBaseURL })`; LangChain dùng `TavilySearch(api_base_url=...)`.

POST/v1/search

Xác thực

Authorizationbắt buộc

string · header

API key dưới dạng bearer token trong header Authorization.

Body

querybắt buộc

string

Truy vấn tìm kiếm cần thực hiện.

required; non-empty search query

Example: who is Leo Messi?

search_depth

string

Kiểm soát độ trễ, mức độ liên quan và cách tạo nội dung kết quả. Mặc định: `basic`; `basic`, `fast`, `ultra-fast` tốn 1 credit, còn `advanced` tốn 2 credits.

default: basic

advancedbasicfastultra-fast

chunks_per_source

integer

Số đoạn nội dung liên quan tối đa cho mỗi nguồn. Mặc định: 3; phạm vi 1–3. Dùng được với `advanced`, `basic` và `fast`.

default: 3; 1..3

max_results

integer

Số kết quả tìm kiếm tối đa trả về. Mặc định: 10; phạm vi 0–20.

default: 10; 0..20

Example: 1

topic

string

Chủ đề tìm kiếm. Mặc định: `general`; dùng `news` cho tin tức hiện tại và `finance` cho nội dung tài chính.

default: general

generalnewsfinance

time_range

string

Lọc theo ngày xuất bản hoặc cập nhật. Mặc định: không đặt. Giá trị cho phép: `day`, `week`, `month`, `year`, `d`, `w`, `m`, `y`.

default: null

dayweekmonthyeardwmy

start_date

string

Trả về kết quả được xuất bản hoặc cập nhật sau ngày này. Định dạng: YYYY-MM-DD.

default: null; format YYYY-MM-DD

Example: 2025-02-09

end_date

string

Trả về kết quả được xuất bản hoặc cập nhật trước ngày này. Định dạng: YYYY-MM-DD.

default: null; format YYYY-MM-DD

Example: 2025-12-29

include_published_date

boolean

Bao gồm ngày xuất bản hoặc cập nhật ước tính trong mỗi kết quả. Tự động bật cho chủ đề `news`. Mặc định: `false`.

default: false

filter_by_published_date

boolean

Loại bỏ kết quả ngoài khoảng `time_range`, `start_date` hoặc `end_date`, kể cả kết quả không có ngày nhận diện được. Mặc định: `false`; `true` cũng bật `include_published_date`.

default: false

include_answer

boolean | string

Bao gồm câu trả lời do LLM tạo. Mặc định: `false`; nhận boolean hoặc `basic`/`advanced`.

default: false

basicadvanced

include_raw_content

boolean | string

Bao gồm HTML đã làm sạch cho mỗi kết quả. Mặc định: `false`; nhận boolean hoặc `markdown`/`text`.

default: false

markdowntext

include_images

boolean

Bao gồm ảnh liên quan đến truy vấn ở cấp cao nhất và ảnh nguồn trong từng kết quả. Mặc định: `false`.

default: false

include_image_descriptions

boolean

Khi `include_images` là `true`, thêm mô tả cho mỗi ảnh. Mặc định: `false`.

default: false

include_favicon

boolean

Có bao gồm URL favicon cho mỗi kết quả hay không. Mặc định: `false`.

default: false

include_domains

string[]

Giới hạn kết quả vào các miền đã liệt kê; tối đa 300 miền. Mặc định: mảng rỗng.

default: []; maximum 300 items

exclude_domains

string[]

Loại trừ kết quả từ các miền đã liệt kê; tối đa 150 miền. Mặc định: mảng rỗng.

default: []; maximum 150 items

include_domains_mode

string

Kiểm soát cách áp dụng `include_domains`. `restrict` chỉ trả về các miền đó; `prefer` ưu tiên nhưng vẫn có thể trả về miền khác. Bắt buộc có `include_domains`, nếu không trả về 400. Mặc định: không đặt.

default: null; requires include_domains

restrictprefer

country

string

Ưu tiên kết quả từ quốc gia đã chọn. Chỉ dùng khi `topic` là `general`. Mặc định: không đặt.

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

Ưu tiên kết quả bằng ngôn ngữ đã chọn. Nhận mã ISO 639-1 hoặc tên ngôn ngữ tiếng Anh. Mặc định: không đặt.

default: null

Example: en

filter_by_language

boolean

Loại bỏ nghiêm ngặt kết quả không khớp `language`. Bắt buộc có `language`, nếu không trả về 400. Mặc định: `false`.

default: false; requires language

auto_parameters

boolean

Tự động chọn tham số tìm kiếm theo ý định truy vấn. Giá trị chỉ định rõ được ưu tiên; phải đặt thủ công `include_answer`, `include_raw_content` và `max_results`. Tốn thêm 2 credits mỗi yêu cầu. Mặc định: `false`.

default: false; costs 2 credits

exact_match

boolean

Chỉ trả về kết quả chứa cụm từ đặt trong dấu ngoặc kép của truy vấn, bỏ qua từ đồng nghĩa và biến thể ngữ nghĩa. Mặc định: `false`.

default: false

include_usage

boolean

Có bao gồm mức sử dụng credit trong phản hồi hay không. Mặc định: `false`.

default: false

safe_search

boolean

Lọc nội dung người lớn hoặc không an toàn. Mặc định: `false`; không hỗ trợ với `fast` và `ultra-fast`.

default: false; unsupported for fast and ultra-fast

api_key

string

Trường xác thực tùy chọn trong JSON body. Khi không có Bearer header, cung cấp BazaarLink API key ở đây; trường này được xóa trước khi xác thực và chuyển tiếp.

days

integer

Trường tương thích SDK `days`. Được chấp nhận để tương thích; theo kế hoạch có thể được chuyển tiếp hoặc bỏ qua và không thuộc schema OpenAPI đã đóng băng.

max_hours

integer

Trường tương thích SDK `max_hours`. Được chấp nhận để tương thích; theo kế hoạch có thể được chuyển tiếp hoặc bỏ qua và không thuộc schema OpenAPI đã đóng băng.

fetch_timeout

number

Trường tương thích SDK `fetch_timeout`. Được chấp nhận để tương thích; theo kế hoạch có thể được chuyển tiếp hoặc bỏ qua và không thuộc schema OpenAPI đã đóng băng.

cache_fallback

boolean

Trường tương thích SDK `cache_fallback`. Được chấp nhận để tương thích; theo kế hoạch có thể được chuyển tiếp hoặc bỏ qua và không thuộc schema OpenAPI đã đóng băng.

timeout

number

Trường `timeout` tương thích SDK. Được chấp nhận để tương thích; tìm kiếm dùng timeout phía dịch vụ và bỏ qua trường không biết hoặc không hỗ trợ.

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

Ví dụ phản hồi

Phản hồi thành công gồm `query`, `answer` tùy chọn, `images` cấp cao nhất, `results` (mỗi mục có `title`, `url`, `content`, `score` và tùy chọn `raw_content`, `published_date`, `favicon`, `images`, `id`), `auto_parameters` tùy chọn, `response_time`, `usage` (`credits` cộng `cost` bổ sung của chúng tôi) và `request_id`. `usage.cost` là giá USD tính cho khách hàng, không phải COGS; `request_id` do BazaarLink tạo.

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