Shopee Product API

# 1) submit
curl -s -X POST https://shopee-multi-region.fastscraping.com/jobs \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"shop_id":83276818,"item_id":23743605234,"region":"th","ttl":600}'

# 2) poll with the job_id from step 1
curl -s https://shopee-multi-region.fastscraping.com/jobs/JOB_ID -H "X-API-Key: YOUR_API_KEY"

import time, requests

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

def fetch_product(shop_id, item_id, region, ttl=600):
    job = requests.post(f"{BASE}/jobs", headers=HEAD, timeout=30, json={
        "shop_id": shop_id, "item_id": item_id, "region": region, "ttl": ttl}).json()
    deadline = time.time() + ttl + 30   # TTL plus the 20 s delivery grace
    while time.time() < deadline:
        r = requests.get(f"{BASE}/jobs/{job['job_id']}", headers=HEAD, timeout=30).json()
        if r["status"] not in ("pending", "processing"):
            return r            # completed / failed / expired / not_found
        time.sleep(4)
    return None

r = fetch_product(83276818, 23743605234, "th")
print(r["result_status"], list(r.get("raw", {})))

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

async function fetchProduct(shopId, itemId, region, ttl = 600) {
  const job = await (await fetch(`${BASE}/jobs`, {
    method: "POST", headers: HEAD,
    body: JSON.stringify({ shop_id: shopId, item_id: itemId, region, ttl }),
  })).json();
  const deadline = Date.now() + (ttl + 30) * 1000;  // TTL plus the 20 s delivery grace
  while (Date.now() < deadline) {
    const r = await (await fetch(`${BASE}/jobs/${job.job_id}`, { headers: HEAD })).json();
    if (!["pending", "processing"].includes(r.status)) return r;
    await sleep(4000);
  }
  return null;
}

X-API-Key: YOUR_API_KEY

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

{
  "shop_id": 1665239494,
  "item_id": 58256703066,
  "region": "br",
  "ttl": 600
}

{
  "job_id": "8aabc85bf7724eceaec27e5f375ad905",
  "status": "pending",
  "shop_id": 1665239494,
  "item_id": 58256703066,
  "note": "Poll GET /jobs/8aabc85bf7724eceaec27e5f375ad905 for your result. This job expires in 600s if not fetched in time."
}

{
  "job_id": "8aabc85bf7724eceaec27e5f375ad905",
  "status": "completed",
  "shop_id": 1665239494,
  "item_id": 58256703066,
  "result_status": "success",
  "billable": true,
  "retriable": false,
  "note": "",
  "voucher_source": null,
  "raw": {
    "get_pc": {
      "bff_meta": null, "error": 0, "error_msg": null,
      "data": {
        "item": {
          "item_id": 58256703066, "shop_id": 1665239494,
          "title": "Kit Mel Cola 1k Óleo Nutritivo Mel Natural 60 ml Trihair",
          "currency": "BRL",
          "price": 7386000, "price_before_discount": 7774000,
          "stock": 409, "total_stock": 1213,
          "historical_sold": 2609,
          "tier_variations": [ { "name": "Quantidade", "options": ["Kit Mel Cola 1kg + Óleo 60ml"], … } ],
          "models": [ { "model_id": 239439288108, "name": "Kit Mel Cola 1kg + Óleo 60ml", "stock": 1213, … } ],
          …
        },
        "product_price": {
          "price": { "single_value": 7386000, "range_min": -1, "range_max": -1 },
          "price_before_discount": { "single_value": 7774000, … },
          "discount": 5, …
        },
        "price_breakdown": {
          "discount_breakdown": [ { "price_source": "Product Discount", "discount_amount": 388000, … } ], …
        },
        "product_review": {
          "rating_star": 4.983, "rating_count": [1239, 1, 0, 5, 7, 1226],
          "historical_sold": 2609, "liked_count": 2494, …
        },
        "shop_detailed": { "shopid": 1665239494, "name": "Cades Cosméticos - Loja Oficial", "rating_star": 4.886, … },
        "product_images": { … }, "product_attributes": { … },
        "product_description": { … }, "promotion_info": { … }
      }
    }
  }
}

{
  "job_id": "8aabc85bf7724eceaec27e5f375ad905",
  "status": "pending",
  "shop_id": 1665239494,
  "item_id": 58256703066,
  "result_status": null,
  "billable": null,
  "retriable": false,
  "note": ""
}

{
  "job_id": "3f1e0a9b27c84d0e9a5b1f6c2d7e8a90",
  "status": "failed",
  "shop_id": 1665239494,
  "item_id": 58256703066,
  "result_status": "shop_unavailable",
  "billable": false,
  "retriable": true,
  "note": ""
}

curl -s "https://shopee-multi-region.fastscraping.com/result?shop_id=83276818&item_id=23743605234&region=th" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "shop_id": 83276818,
  "item_id": 23743605234,
  "status": "success",
  "voucher_source": null,
  "raw": { "basic_pdp": { … }, "get_pc": { … }, "shop": { … } }
}

{
  "basic_pdp": {
    "item_id": "23743605234", "shop_id": "83276818", "currency": "THB",
    "price_min": "1089000000", "price_max": "1089000000",
    "total_stock": "311", "sold": 4266,
    "rating": { "rating_star": 4.71, "rating_counts": [0, 52, 20, 55, 119, 1477] },
    "models": [ { "model_id": "186771150146", "price": "1089000000", "normal_price": "1749000000", "stock": 311, "sold": 4266, … } ],
    …
  },
  "get_pc": { "data": { "item": { "price": 999000000, "price_before_discount": 1749000000, "show_discount": 43, … } } },
  "shop": { "shopid": 83276818, "name": "samsung_thailand", "rating_star": 4.89, "follower_count": 1628625, "response_rate": 97, … }
}

{
  "owner": "your-company",
  "timezone": "UTC",
  "key": { "is_active": true, "created_at": "2026-09-25T10:20:20" },
  "limits": { "per_minute": 120, "per_hour": 1200, "per_day": 1000, "concurrency": 100 },
  "credits": { "total": 1000, "used": 37, "remaining": 963, "unlimited": false },
  "jobs": { "total": 41, "completed": 37, "failed": 1, "pending": 3, "not_found": 0, "billable": 37 },
  "totals": {
    "today": { "all": 12, "th": 9, "tw": 3 },
    "yesterday": { "all": 25, "br": 25 },
    …  day_before_yesterday, last_7_days, last_30_days, this_month, last_month, this_year, lifetime
  },
  "daily": [ { "date": "2026-09-25", "th": 9, "tw": 3, "all": 12 }, … ],
  "monthly_breakdown": { "2026-09": { "24": { "th": 9, "all": 9 }, "25": 0, …, "total": 37 }, "2026-08": null }
}

{
  "limit": 2, "offset": 0,
  "items": [
    { "job_id": "a32d719e27744a1393722737e9209506", "region": "tw", "shop_id": 5597991, "item_id": 74412812,
      "status": "completed", "result_status": "success", "billable": true, "created_ts": 1790228814.34 },
    { "job_id": "8daf6d5a0e834572b0a0221e0089bbe8", "region": "tw", "shop_id": 37004578, "item_id": 7775080780,
      "status": "completed", "result_status": "success", "billable": true, "created_ts": 1790227317.52 }
  ]
}

HTTP/1.1 429 Too Many Requests
{ "detail": "Concurrency limit reached (100 in-flight jobs)" }