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

Trích xuất nội dung web

Trích xuất nội dung web thô từ một URL hoặc một nhóm tối đa 20 URL. URL thành công nằm trong results và lỗi theo từng URL nằm trong failed_results; ngay cả khi HTTP 200 trả về mảng results rỗng, hãy kiểm tra cả hai mảng. Thứ tự đầu ra không được đảm bảo. Endpoint hỗ trợ xếp hạng lại bằng query, 1–5 chunk cho mỗi nguồn (chỉ khi có query), trích xuất basic hoặc advanced, hình ảnh, favicon, định dạng markdown hoặc text và timeout 1–60 giây. Các trường yêu cầu không xác định sẽ bị bỏ qua. Dùng Authorization: Bearer <key>, hoặc truyền api_key trong JSON body như phương án dự phòng tương thích Tavily. Cả hai base URL của BazaarLink đều được hỗ trợ: https://api.bazaarlink.ai/v1 và https://bazaarlink.ai/api/v1. Mỗi 5 URL trích xuất thành công tốn 1 credit với basic hoặc 2 credits với advanced; URL thất bại được miễn phí. Giá khách hàng bằng số credits nhân với giá mỗi credit do quản trị viên đặt; xem BazaarLink pricing page và dùng usage.cost trong response. Hạn mức miễn phí dùng chung credits hằng ngày với search; nếu đã hết mà không còn số dư, response là 432. cURL: `curl https://api.bazaarlink.ai/v1/extract -H "Authorization: Bearer $BAZAARLINK_API_KEY" -H "Content-Type: application/json" -d '{"urls":["https://example.com/article"]}'` Python: `TavilyClient(api_key=..., api_base_url="https://api.bazaarlink.ai/v1").extract(urls=[...])` JavaScript: `tavily({ apiKey, apiBaseURL })` LangChain: `TavilyExtract(api_base_url=...)`

POST/v1/extract

Xác thực

Authorizationbắt buộc

string · header

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

Body

urlsbắt buộc

string | string[]

Các URL cần trích xuất. Truyền một chuỗi hoặc mảng gồm 1–20 URL. Mảng rỗng hoặc không có URL hợp lệ sẽ trả về 400.

string or array of 1–20 URLs

Example: ["https://example.com/article"]

query

string

Ý định của người dùng để xếp hạng lại các chunk nội dung đã trích xuất.

Example: "key findings"

chunks_per_source

integer

Số chunk nội dung liên quan tối đa cho mỗi nguồn. Phải là 1–5 và chỉ dùng được khi có query.

1–5; only with query

Example: 3

extract_depth

string

Độ sâu trích xuất. advanced có thể lấy bảng và nội dung nhúng với độ trễ cao hơn; basic tốn 1 credit cho mỗi 5 URL thành công, advanced tốn 2 credits.

default: basic

basicadvanced

Example: "basic"

include_images

boolean

Có đưa các URL hình ảnh được trích xuất từ mỗi trang thành công vào kết quả hay không.

default: false

Example: true

include_favicon

boolean

Có đưa URL favicon vào mỗi kết quả thành công hay không.

default: false

Example: true

format

string

Định dạng nội dung trích xuất. markdown giữ cấu trúc Markdown; text trả về văn bản thuần.

default: markdown

markdowntext

Example: "markdown"

timeout

number

Số giây tối đa chờ trích xuất, từ 1–60. Khi bỏ qua, mặc định là 10 giây cho basic và 30 giây cho advanced.

1–60 seconds; default depends on extract_depth

Example: 30

include_usage

boolean

Có đưa credits và usage.cost vào response hay không.

default: false

Example: true

POST /v1/extract

1
2
3
4
5
6
7
8
9
10
11
12
13
14
curl https://api.bazaarlink.ai/v1/extract \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": ["https://example.com/article", "https://example.org/docs"],
    "query": "key findings",
    "chunks_per_source": 3,
    "extract_depth": "basic",
    "include_images": true,
    "include_favicon": true,
    "format": "markdown",
    "timeout": 30,
    "include_usage": true
  }'

Ví dụ phản hồi

Đã trích xuất xong. Hãy kiểm tra results cho các mục thành công và failed_results cho lỗi theo từng URL. HTTP 200 vẫn có thể có mảng results rỗng và thứ tự đầu ra không được đảm bảo. usage.credits là lượng credit; usage.cost là giá USD BazaarLink tính cho khách hàng, không phải chi phí upstream; request_id là ID yêu cầu 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
{
  "results": [
    {
      "url": "https://example.com/article",
      "raw_content": "Article content extracted as Markdown.",
      "images": [
        "https://example.com/image.jpg"
      ],
      "favicon": "https://example.com/favicon.ico"
    }
  ],
  "failed_results": [
    {
      "url": "https://example.org/unavailable",
      "error": "Failed to retrieve content"
    }
  ],
  "response_time": 0.42,
  "usage": {
    "credits": 1,
    "cost": 0
  },
  "request_id": "bl-extract-example-request"
}