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

Bắt đầu

Luồng yêu cầu

  1. Gửi tác 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 thân 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 tác 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 thân phản hồi trực tiếp.
201Tác 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ố tác 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 đầy đủ

import { Scrapeless } from '@scrapeless-ai/sdk';
const client = new Scrapeless({
  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 tác 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. Kiểm tra với các URL đơn giản trước.