Scraping APIBắt đầu nhanhBắt đầu

Bắt đầu

Luồng Yêu cầu

  1. Gửi một Nhiệm vụ Gửi yêu cầu POST đến /api/v1/scraper/request.
  2. Xử lý Phản hồi
    1. HTTP 200 (Thành công): Dữ liệu được trả về trực tiếp trong nội dung phản hồi.
    2. HTTP 201 (Đang xử lý): Sử dụng taskId được cung cấp để kiểm tra kết quả.
  3. Kiểm tra Kết quả Đối với các nhiệm vụ không đồng bộ, hãy liên tục gọi /api/v1/scraper/result/{taskId} cho đến khi dữ liệu sẵn sàng (HTTP 200).

Mã Trạng thái HTTP

CodeÝ nghĩaHành động
200Thành côngSử dụng dữ liệu nội dung phản hồi trực tiếp.
201Nhiệm vụ đang tiến hànhKiểm tra /result/{taskId} (khoảng thời gian khuyến nghị: 1-5 giây).
400Tham số không hợp lệVui lòng kiểm tra xem các tham số nhiệm vụ có hợp lệ không.
429Vượt quá giới hạn tốc độGiảm tần suất yêu cầu hoặc liên hệ hỗ trợ để điều chỉnh hạn ngạch.
500Lỗi máy chủ nội bộThử lại sau 1 phút; liên hệ hỗ trợ nếu vẫn còn lỗi.

Ví dụ Mã

Luồng Hoàn chỉnh

import { ScrapelessClient, log } from '@scrapeless-ai/sdk';
const client = new ScrapelessClient({
  apiKey: 'YOUR_API_KEY',
});
 
async function runTask() {
  const result = await client.scraping.scrape({
    {
      actor: 'scraper.shopee',
      input: {
        url: 'https://shopee.tw/a-i.10228173.24803858474'
      }
    },
  });
 
  return result;
}
 
runTask()
  .then(data => {
    console.log('Data:', data);
  })
  .catch(error => {
    console.error('Error:', error);
  });

cURL (Ví dụ Kiểm tra)

curl --location --request GET 'https://api.scrapeless.com/api/v1/scraper/result/30681c8b-bfd3-48eb-a7c9-006e40b00591' \
--header 'x-api-token: YOUR_API_KEY' \
--header 'Content-Type: application/json'
 

Tham số

Tham sốKiểuMô tả
actorstringDịch vụ scraping (ví dụ: scraper.shopee).
inputobjectCác tham số cụ thể của nhiệm vụ (ví dụ: action, url).
proxyobjectCấu hình proxy tùy chọn với trường quốc gia.

Ghi chú

  1. Khuyến nghị Kiểm tra
    1. Khoảng thời gian: 1-5 giây.
    2. Thời gian chờ: Đặt giới hạn thử lại tối đa (ví dụ: 10 lần thử).
  2. Mẹo gỡ lỗi
    1. Thử nghiệm với các URL đơn giản trước.