Shopee-Scraper-Indonesia

Shopee Indonesia Product Scraper API. Scrape real-time product data — prices, stock per variant, ratings, and seller info — by keyword, shop ID, or product URL .

原始信息汇总

数据集概述：Shopee-Scraper-Indonesia

这是一个专为抓取Shopee Indonesia（印尼）实时商品数据而设计的API，无需自行管理浏览器、代理或Cookie。

核心功能与工作模式

• 工作流程：采用异步任务模式。

  1. 提交任务：通过 POST /scrape/async 端点提交抓取任务，获取唯一的 task_id。
  2. 轮询结果：使用 GET /scrape/result/{task_id} 端点轮询任务状态，建议每3-5秒轮询一次，不超过每秒1次。
  3. 获取数据：当状态变为 done 时，从 data 数组中获取结构化的商品数据。

• 三种抓取模式：

  • keyword：通过关键词搜索商品（例如：“sepatu nike”）。
  • shop：通过商店ID抓取某店铺的全部商品列表。
  • url：通过特定商品页面的URL抓取单个商品。

返回的数据字段

API为每个商品返回以下结构化数据：

字段	描述
nama_produk	商品名称
harga / harga_min / harga_max	价格（以印尼盾IDR计）
harga_asli / diskon_pct	原价和折扣百分比
stok	总库存
rating / jumlah_rating	评分和评论总数
terjual / terjual_bulanan	总销量和月销量
seller_type	卖家类型（Mall / Star+ / Star / Regular）
lokasi	卖家所在城市/地区
variants	各变体的库存和价格
gambar / gambar_list	商品图片URL
url	商品的Shopee直接链接

典型响应时间

模式	预估时间
单个商品URL	约10-15秒
关键词搜索（20个商品）	约30-60秒
完整店铺抓取	1-5分钟

任务状态与错误码

• 任务状态：

  • pending：已排队，尚未开始。
  • running：抓取进行中。
  • done：完成，数据可用。
  • failed：失败，可查看 error 字段。

• 错误码：

  • 400：无效请求体
  • 401：缺少或无效的RapidAPI密钥
  • 404：任务ID未找到
  • 422：校验错误
  • 429：超出速率限制
  • 500：服务器错误，请稍后重试
  • 503：抓取服务暂时不可用

搜集汇总

背景与挑战

背景概述

该数据集是Shopee印尼站的产品抓取API，支持通过关键词、店铺ID或产品URL实时获取商品数据，包括价格、各变体库存、评分及卖家信息等核心字段。