Bắt đầu nhanh: Thực hiện yêu cầu Scrapeless đầu tiên của bạn

Thực hiện yêu cầu Scrapeless đầu tiên bằng cách truy xuất một trang với Web Unlocker. Ví dụ này sử dụng cURL và trả về kết quả trong cùng một phản hồi HTTP, vì vậy bạn có thể bắt đầu mà không cần cài đặt SDK hay theo dõi (poll) một tác vụ.

Trước khi bắt đầu

Bạn cần một tài khoản Scrapeless có quyền truy cập Web Unlocker, đủ số dư khả dụng cho yêu cầu, và cURL trong một terminal cục bộ. Các lệnh bên dưới sử dụng Bash hoặc Zsh trên macOS hoặc Linux.

Bạn đang tìm tự động hóa trình duyệt, câu trả lời AI, hay kết quả tìm kiếm? Bạn có thể chuyển thẳng đến Chọn sản phẩm phù hợp.

1. Lấy API key của bạn

Đăng nhập vào bảng điều khiển Scrapeless, mở phần cài đặt API key, và sao chép key của bạn. Để biết hướng dẫn về lưu trữ và bảo mật, xem Lấy và bảo vệ API key của bạn.

Trong terminal của bạn, chạy các lệnh sau. Dán key vào lời nhắc ẩn, sau đó nhấn Enter:

printf 'Scrapeless API key: '
read -rs SCRAPELESS_API_KEY
printf '\n'
export SCRAPELESS_API_KEY

Biến này sẽ khả dụng cho các lệnh được khởi chạy từ terminal này. Lặp lại bước này trong một phiên terminal mới.

2. Gửi yêu cầu

Sao chép và chạy:

curl --silent --show-error \
  --request POST 'https://api.scrapeless.com/api/v2/unlocker/request' \
  --header "x-api-token: ${SCRAPELESS_API_KEY:?Set SCRAPELESS_API_KEY first}" \
  --header 'Content-Type: application/json' \
  --data '{
    "actor": "unlocker.webunlocker",
    "input": {
      "url": "https://example.com/",
      "method": "GET",
      "redirect": false
    },
    "proxy": {
      "country": "ANY"
    }
  }' \
  --output scrapeless-response.json \
  --write-out 'HTTP status: %{http_code}\n'

Lệnh này lưu phần thân phản hồi vào scrapeless-response.json và in ra trạng thái HTTP. Lệnh không đi theo các chuyển hướng của API và cũng không tự động thử lại yêu cầu.

Trường	Chức năng
`x-api-token`	Xác thực yêu cầu bằng API key Scrapeless của bạn.
`actor`	Chọn Web Unlocker bằng mã định danh API của nó, `unlocker.webunlocker`.
`input.url`	Thiết lập trang cần truy xuất.
`input.method`	Thiết lập phương thức dùng cho trang đích. Yêu cầu tới chính Scrapeless sử dụng `POST`.
`input.redirect`	Kiểm soát việc có đi theo các chuyển hướng từ trang đích hay không.
`proxy.country`	Dùng `ANY` khi bạn không cần một quốc gia proxy cụ thể.

Xem tài liệu tham khảo API Web Unlocker để biết hợp đồng của endpoint.

3. Kiểm tra kết quả

cat scrapeless-response.json

Một phản hồi thành công sử dụng một cấu trúc JSON với code và data. Nội dung sau đây là minh họa rút gọn, không phải là phản hồi được ghi lại thực tế:

{
  "code": 200,
  "data": "<!doctype html><html>...Example Domain...</html>"
}

Đối với ví dụ này, hãy kiểm tra rằng trạng thái HTTP là 200, code của phản hồi là 200, và data chứa nội dung trang được yêu cầu. Chỉ riêng một tệp đã được lưu không đủ để chứng minh rằng yêu cầu đã thành công.

Yêu cầu đầu tiên của bạn hoàn tất khi bạn có thể nhận diện trang Example Domain trong nội dung được trả về.

4. Sử dụng URL của riêng bạn

Thay thế input.url bằng trang bạn muốn truy xuất và gửi lại yêu cầu. Nếu trang đích chuyển hướng, hãy đặt input.redirect thành true khi cần.

Ví dụ ở trên không bật kết xuất (rendering) JavaScript. Đối với nội dung được tải bởi các script, hãy làm theo hướng dẫn kết xuất JavaScript. Đối với một tác vụ thu thập dữ liệu website được quản lý hoặc một phiên trình duyệt tương tác, hãy sử dụng hướng dẫn sản phẩm liên quan thay thế.

Nếu yêu cầu thất bại

Triệu chứng	Cần kiểm tra gì
Shell yêu cầu bạn thiết lập `SCRAPELESS_API_KEY`	Chạy bước 1 trong cùng một terminal.
Lỗi xác thực	Kiểm tra rằng key còn hiệu lực và đầy đủ. Gửi giá trị thô của nó trong `x-api-token`, không có tiền tố `Bearer`.
Lỗi quyền truy cập hoặc số dư	Kiểm tra quyền truy cập Web Unlocker và số dư khả dụng trong bảng điều khiển.
Lỗi yêu cầu không hợp lệ	So sánh JSON và mã định danh actor với ví dụ. Đọc phần thân phản hồi để biết trường bị từ chối.
Một phản hồi thành công nhưng thiếu nội dung mong đợi	Kiểm tra URL đích, các chuyển hướng, và liệu có cần kết xuất JavaScript hay không.
Lỗi mạng hoặc hết thời gian chờ	Kiểm tra kết nối và URL đích trước khi thử lại. Tránh liên tục gửi lại một yêu cầu thất bại không thay đổi.

Khi yêu cầu trợ giúp, hãy chia sẻ endpoint, thời điểm, trạng thái HTTP, và một phản hồi lỗi đã được ẩn thông tin nhạy cảm. Xóa API key và dữ liệu đích nhạy cảm của bạn.

Các bước tiếp theo

Chọn sản phẩm và giao diện phù hợp với quy trình làm việc của bạn:

Chọn sản phẩm phù hợp cho quy trình làm việc thực tế của bạn.
Bảo vệ API key của bạn trước khi kết nối một ứng dụng đã triển khai.
Tiếp tục với hướng dẫn Web Unlocker.
Để lấy dữ liệu theo nguồn cụ thể, hãy dùng Google Search API, Amazon Scraper, hoặc TikTok Scraper.
Thích quy trình làm việc trên terminal hơn? Scrapeless CLI sắp ra mắt. Hướng dẫn của nó sẽ bao gồm cài đặt, cấu hình, và các lệnh.
Thích một SDK hơn? Bắt đầu với Node.js. Các SDK Python và Go sắp ra mắt.

Khi bạn hoàn tất thử nghiệm, hãy xóa key khỏi môi trường terminal này:

unset SCRAPELESS_API_KEY

Lệnh này xóa biến cục bộ; nó không thu hồi key.

Tổng quan Chọn sản phẩm phù hợp