Shopee Item Sold API

# job.json holds 300 to 1,000 distinct pairs:
# {"region":"vn","shop_item_ids":[{"shop_id":88201679,"item_id":27041370670}, ...]}

# 1. submit the job: the answer carries job_id and estimated_wait_s
curl -s -X POST "https://shopee-multi-region.fastscraping.com/v1/get_list/jobs" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d @job.json

# 2. poll until "status" is "completed"; the items are then in the answer.
#    --compressed: about 1 MB on the wire instead of about 6 MB for 1,000 items
curl -s --compressed "https://shopee-multi-region.fastscraping.com/v1/get_list/jobs/JOB_ID" \
  -H "X-API-Key: YOUR_API_KEY" -o result.json

import csv
import time
import requests

BASE = "https://shopee-multi-region.fastscraping.com"
HEAD = {"X-API-Key": "YOUR_API_KEY"}

# items.csv: one "shop_id,item_id" per line, 300 to 1,000 lines, e.g. 88201679,27041370670
with open("items.csv", newline="") as f:
    pairs = [{"shop_id": int(s), "item_id": int(i)} for s, i in csv.reader(f)]

r = requests.post(f"{BASE}/v1/get_list/jobs", headers=HEAD,
                  json={"region": "vn", "shop_item_ids": pairs}, timeout=30)
r.raise_for_status()
job_id = r.json()["job_id"]
time.sleep(r.json()["estimated_wait_s"])

while True:
    # requests asks for gzip and decompresses it for you
    r = requests.get(f"{BASE}/v1/get_list/jobs/{job_id}", headers=HEAD, timeout=60)
    r.raise_for_status()
    job = r.json()
    if job["status"] == "completed":
        break
    time.sleep(20)

for it in job["items"]:
    print(it["itemid"], it["historical_sold"], it["global_sold_count"], it["sold"])
print("billed items:", job["items_billed"], "missing:", job["missing_item_ids"])

// Node.js 18+ (built-in fetch). Save as get_list.mjs and run: node get_list.mjs
import { readFileSync } from "node:fs";

const BASE = "https://shopee-multi-region.fastscraping.com";
const HEAD = { "X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json" };
const sleep = (sec) => new Promise((r) => setTimeout(r, sec * 1000));

// items.csv: one "shop_id,item_id" per line, 300 to 1,000 lines
const shop_item_ids = readFileSync("items.csv", "utf8").trim().split(/\r?\n/).map((line) => {
  const [shop_id, item_id] = line.split(",").map(Number);
  return { shop_id, item_id };
});

let res = await fetch(`${BASE}/v1/get_list/jobs`, {
  method: "POST",
  headers: HEAD,
  body: JSON.stringify({ region: "vn", shop_item_ids }),
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const { job_id, estimated_wait_s } = await res.json();
await sleep(estimated_wait_s);

let job;
for (;;) {
  // fetch asks for gzip and decompresses it for you
  res = await fetch(`${BASE}/v1/get_list/jobs/${job_id}`, { headers: HEAD, signal: AbortSignal.timeout(60000) });
  if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
  job = await res.json();
  if (job.status === "completed") break;
  await sleep(20);
}

for (const it of job.items) console.log(it.itemid, it.historical_sold, it.global_sold_count, it.sold);
console.log("billed items:", job.items_billed, "missing:", job.missing_item_ids);

X-API-Key: YOUR_API_KEY

POST /v1/get_list/jobs
Content-Type: application/json
X-API-Key: YOUR_API_KEY

{
  "bff_meta": null,
  "shop_item_ids": [
    { "item_id": 27041370670, "shop_id": 88201679 },
    { "item_id": 42568221380, "shop_id": 308461157 },
    … 300 to 1,000 distinct pairs in total …
  ],
  "source": "microsite_individual_product"
}

HTTP/1.1 202 Accepted
Content-Type: application/json

{
  "job_id": "8c2f0e7d4b1a4e6f9a3c5d7e9f1b2c4d",
  "status": "queued",
  "region": "vn",
  "items_requested": 1000,
  "duplicates_removed": 0,
  "created_at": "2026-10-05T10:23:16.338+00:00",
  "deadline_at": "2026-10-05T10:28:16.338+00:00",
  "estimated_wait_s": 240
}

{
  "job_id": "8c2f0e7d4b1a4e6f9a3c5d7e9f1b2c4d",
  "status": "completed",
  "region": "vn",
  "created_at": "2026-10-05T10:23:16.338+00:00",
  "started_at": "2026-10-05T10:23:21.540+00:00",
  "completed_at": "2026-10-05T10:27:41.912+00:00",
  "deadline_at": "2026-10-05T10:28:16.338+00:00",
  "items_requested": 1000,
  "items_done": 1000,
  "items_pending": 0,
  "items_returned": 997,
  "items_missing": 3,
  "items_failed": 0,
  "items_billed": 997,
  "missing_item_ids": ["23456789012", "24567890123", "25678901234"],
  "failed_item_ids": [],
  "items": [
    {
      "itemid": 27041370670,
      "shopid": 88201679,
      "name": "Điện thoại Apple iPhone 17 Pro Max 256GB",
      "historical_sold": 28975,
      "global_sold_count": 28975,
      "sold": 3223,
      "stock": 5450,
      "price": 3499000000000,
      "price_min": 3499000000000,
      "price_max": 3559000000000,
      "price_before_discount": 3799000000000,
      "currency": "VND",
      "item_rating": { "rating_star": 4.944232820356544, "rating_count": [6566, 55, 8, 29, 64, 6410], "...": "more fields" },
      "liked_count": 11289,
      "cmt_count": 6566,
      "shop_location": "Tỉnh Bắc Ninh",
      "cb_option": 0,
      "ctime": 1757498693,
      "catid": 100013,
      "global_cat": { "catid": [100013, 100073], "l0_category": 2 },
      "shop_rating": 4.922738,
      "item_status": "normal",
      "...": "more fields"
    },
    {
      "itemid": 42568221380,
      "shopid": 308461157,
      "name": "Apple iPhone 17 Pro Max 256GB Chính hãng ZP/A",
      "historical_sold": 38423,
      "global_sold_count": 38424,
      "sold": 18512,
      "...": "more fields"
    },
    … 995 more items …
  ]
}

{
  "jobs": [
    { "job_id": "8c2f0e7d4b1a4e6f9a3c5d7e9f1b2c4d", "status": "completed", "items_requested": 1000, "items_returned": 997, "...": "more fields" }
  ]
}

{
  "timezone": "UTC",
  "billing": "per returned item",
  "price_per_1000_items_usd": 3.0,
  "today":      { "items": 1840,  "amount_usd": 5.52 },
  "yesterday":  { "items": 2310,  "amount_usd": 6.93 },
  "this_month": { "items": 4150,  "amount_usd": 12.45 },
  "last_month": { "items": 0,     "amount_usd": 0.0 },
  "lifetime":   { "items": 4150,  "amount_usd": 12.45 },
  "items_pending": 300
}

HTTP/1.1 400 Bad Request
{ "detail": "min 300 distinct shop_item_ids per job (got 120 after removing duplicates)" }