Capzy Data API. Chọn nguồn của bạn.
Tìm endpoint của một trang web được hỗ trợ, gửi tham số và nhận JSON. Khám phá tài liệu tham chiếu tại đây, sau đó chạy và kiểm tra request trong playground trên bảng điều khiển.
Tìm kiếm Amazon, tóm lược
GET /v1/amazon/searchVí dụ minh họa
Tìm nguồn bạn cần
Mỗi nguồn có endpoint, đầu vào bắt buộc và cấu trúc phản hồi riêng. Mở tài liệu tham chiếu của nguồn để kiểm tra phạm vi hỗ trợ trước khi xây dựng tích hợp.
Tất cả nguồn (83)
Request Data API đầu tiên của bạn
Ví dụ Amazon này dùng một endpoint GET riêng cho nguồn. HTTP 200 trả về dữ liệu nguồn; HTTP 202 trả về trạng thái đang chờ và jobId. Hãy kiểm tra các job đang chờ trong trang Lượt chạy của bảng điều khiển Data API trước khi gửi request khác.
Tạo Data API key
Mở bảng điều khiển Data API để sao chép Data API key chuyên dụng của bạn. Tín dụng của gói được dùng trước; mức sử dụng thêm được trừ vào số dư tài khoản Capzy dùng chung của bạn.
Mở Data APIChọn nguồn và hành động
Dùng tài liệu tham chiếu của trang web để tìm phương thức, đường dẫn và tham số bắt buộc. Ví dụ tìm kiếm Amazon gửi query và domain đến /v1/amazon/search.
Đọc tham số tìm kiếm AmazonKiểm tra JSON trong playground
Mở nguồn tương ứng trong bảng điều khiển, chọn hành động, điền đầu vào và chạy request. Kiểm tra giá endpoint hiện tại trước khi chạy.
Mở playground tìm kiếm Amazon
# Install: pip install requests
import os
import requests
response = requests.get(
"https://api.capzy.ai/v1/amazon/search",
headers={"X-API-Key": os.environ["CAPZY_DATA_API_KEY"]},
params={"query": "wireless earbuds", "domain": "com"},
timeout=120,
)
response.raise_for_status()
data = response.json()
if response.status_code == 202:
print("Pending:", data.get("status"), "Job:", data.get("jobId"))
print("Inspect this job in https://capzy.ai/dashboard/data-api/runs")
else:
for item in data.get("organic_results", []):
print(item["title"], item.get("price"))
print("Credits used:", response.headers.get("X-Credits-Used"))Nắm rõ quy ước trước khi gọi
Xác thực dùng chung cho mọi nguồn Data API. Phương thức, tham số và các trường trả về thuộc về từng endpoint.
X-API-KeyBắt buộc · header- Gửi Data API key chuyên dụng của bạn trong header này. Giữ nó ở máy chủ và đọc từ CAPZY_DATA_API_KEY trong các ví dụ này.
/v1/{source}/{path}Tùy endpoint · đường dẫn- Làm theo phương thức và đường dẫn trong tài liệu tham chiếu của nguồn. Ví dụ, GET /v1/amazon/search nhận query và domain làm tham số truy vấn.
X-Credits-UsedHeader phản hồi- Kiểm tra số tín dụng bị trừ cho request. Giá endpoint và chiết khấu theo gói được hiển thị trong bảng điều khiển và tài liệu tham chiếu của nguồn.
X-Next-CursorHeader phản hồi · khi có- Một số endpoint trả về cursor cho trang tiếp theo. Dùng tham số phân trang của từng endpoint; không phải nguồn nào cũng dùng cùng mô hình phân trang.
Dùng các trường phản hồi thực tế của nguồn
Phản hồi tìm kiếm Amazon HTTP 200 cung cấp organic_results ở cấp cao nhất. Ngược lại, HTTP 202 trả về một phong bì trạng thái kèm jobId; hãy kiểm tra trong trang Lượt chạy của bảng điều khiển. Phản hồi thành công rút gọn này dùng dữ liệu sản phẩm minh họa.
{
"search_information": {
"query": "wireless earbuds"
},
"organic_results": [
{
"title": "Example wireless earbuds",
"price": "$27.99",
"extracted_price": 27.99,
"asin": "EXAMPLE001"
}
]
}Bảng giá
Các gói Data API bao gồm hạn mức tín dụng hằng tháng. Mức sử dụng thêm được trừ vào số dư tài khoản Capzy dùng chung của bạn. Kiểm tra tài liệu tham chiếu của nguồn để biết giá tín dụng hiện tại của endpoint.
Đang tải giá hiện tại…
Một vài điều cần biết
Playground mở ở đâu?
Trong Bảng điều khiển → Data API → Scraper. Liên kết nguồn mở trình tạo của nguồn đó. Liên kết endpoint chọn sẵn hành động tương ứng, để bạn có thể kiểm tra các đầu vào bắt buộc trước khi chạy.
Tôi có thể dùng solver API key không?
Hãy dùng Data API key chuyên dụng hiển thị trong bảng điều khiển Data API. Data API có cơ chế kiểm soát gói và tín dụng đi kèm riêng, còn mức sử dụng thêm được chi trả bằng số dư tài khoản Capzy dùng chung của bạn.
Mọi nguồn có trả về cùng JSON không?
Không. Mỗi endpoint có cấu trúc phản hồi riêng theo nguồn. Hãy kiểm tra phản hồi được mô tả trong tài liệu và xử lý các trường bị thiếu hoặc không bắt buộc trong ứng dụng của bạn.
Nếu một endpoint đang ở trạng thái sắp ra mắt thì sao?
Bảng điều khiển đánh dấu các endpoint chưa được xác minh hoặc chưa thể chạy. Hãy dùng các hành động được hỗ trợ hiển thị tại đó; chỉ có mục trong tài liệu tham chiếu không đảm bảo endpoint đã sẵn sàng.
Tìm một nguồn. Thử một request thật.
Playground trên bảng điều khiển kết hợp đầu vào, phản hồi và giá hiện tại ở cùng một nơi.
