Scraping API · Shopee

Units sold, split by every variant of a listing.

A Shopee listing reports one sold figure for the whole product. This endpoint returns the split beneath it, so a 400ml pouch and a 800ml bottle stop being the same number.

Get API credits Read the docs

What one call returns.

  • Per-variant sold counts, one row per model on the listing
  • Price and stock per variant, in the market's own currency
  • Listing-level totals so you can check the variants add up
  • Item status, so delisted products are visible rather than silently missing

Use this when a variant is the unit of the decision: pack-size mix, shade or size curves, or checking which SKU inside a listing is actually moving.

The specification.

Endpoint
POST /v1/shopee/variant_sold_v1/submit
Markets
Indonesia, Singapore, Thailand, Philippines, Malaysia, Vietnam, Taiwan, Brazil
Credits
Per item, see the rate card
Batch size
Up to 50,000 items per request, in batches of 50
Approval
Approved by a person before it runs
Processing hours
08:00–18:00 GMT+8

Checked against the live API specification on 2026-09-18.

A real response, not a mock-up.

POST /v1/shopee/variant_sold_v1/submit → GET .../download/{job_id}Captured 2026-07-09 
{
  "name": "Philips | Brush Replacement | Kepala Sikat Gigi Optimal White | Gigi Lebih Putih dalam Satu Minggu | Putih | Isi 4 | HX6064/67",
  "currency": "IDR",
  "sold": 237,
  "models": [
    {
      "name": "",
      "price": "52480000000",
      "stock": 4,
      "sold": 237
    }
  ]
}

The limits, stated plainly.

  • Up to 50,000 items per request, processed in batches of 50
  • One country per request
  • Approval-gated: a job starts as awaiting_approval and a person on our side releases it. Rejected or untouched for 24 hours means no charge
  • Shopee jobs process 08:00–18:00 GMT+8. You can submit and poll at any hour, but nothing moves outside that window

When not to use this.

If you only need the headline sold figure for a product, the product-page endpoint carries it and costs less per item. This endpoint exists for the variant split, which is the expensive part to read. The rate card has the current per-item rate.

See the rate card

Other endpoints.

LazadaLazada product reviewsReviews are the only place a marketplace records what a buyer thought of a specific variant.…TokopediaTokopedia keyword searchA keyword search is how a category looks to a shopper. This endpoint walks the result set and…LazadaLazada product detailsOne call returns the listing and its SKU table: what each variant costs, what it cost before…LazadaLazada keyword searchPass the catalogue URL for a keyword and the job returns the listings behind it, with the…

Price your exact scope before you pay.

The rate card is public and an estimate costs nothing.

Get API credits Rate card