Shopee Scraper

Search Shopee by keyword or category and get one row per product: the name, the canonical link, the shop and item ids, and with details switched on, the brand, category, seller location, images and the seller's declared attributes.

Eight markets, chosen with one input:

Indonesia shopee.co.id	Singapore shopee.sg	Malaysia shopee.com.my	Thailand shopee.co.th
Vietnam shopee.vn	Philippines shopee.ph	Taiwan shopee.tw	Brazil shopee.com.br

Search in the market's own language: sepatu for Indonesia, giày for Vietnam, tenis for Brazil. Around forty products come back per term per page.

Prices, included

Every product comes back priced, in the market's own currency, with the price before discount and the discount percentage when the seller is running one:

title	price	price_original	discount_percent	rating	currency
Sepatu Slip On Pria HF07 Kulit Asli	51250	125000	59	4.7	IDR
【GERALD】Canvas Sneakers Size 35-44	18.90	50.00	62	5.0	MYR
Giày thể thao nữ đế mỏng siêu nhẹ	152880	190000	20	4.8	VND

Measured across all eight markets on 2026-09-12: 315 of 319 products priced, 308 with a rating, 302 with a seller location. The handful without a price are promoted placements that Shopee renders without one.

Read the currency column, do not assume it. 18.90 is Malaysian ringgit on one market and Brazilian reais on another, and the markets do not agree on whether a dot is a thousands separator or a decimal point. Each row states its own currency for exactly that reason, and the amounts are already normalised to ordinary units, so 51250 is fifty-one thousand two hundred and fifty rupiah.

Sold count and stock are not included. Shopee does not put either on a listing page in any market, so they are absent here rather than present as a column of nulls.

Optional: your own session, for the extra detail fields

Prices do not need a login. A session adds the fields Shopee only shows to a signed-in shopper, such as stock and the rating count.

Paste your own Shopee cookies into Your Shopee session cookies. Log in to your Shopee account in a browser, open the developer tools, and copy the cookies for the Shopee domain: SPC_EC, SPC_F, SPC_U and SPC_ST are the ones that carry the session.

They expire the way any login does. If the cookies are spent or wrong the run does not fail: it records session_refused and carries on with the standard path, so you still get every row, priced. That fallback is tested.

What you get per product

• title — the product name, as the seller wrote it
• price, price_original, discount_percent, currency — what it costs
• rating — the average buyer rating out of 5
• location — where the seller ships from
• product_url, shop_id, item_id — the canonical link and its parts
• market, list_position, source, source_input — where the row came from

With Fetch product details on, each product page adds:

• brand and brand_id
• cat_id — Shopee's own category id, which is how you group a result set
• shop_location — the seller's full location, where the listing gives a short form
• images, attributes, ctime

Details are optional, and usually unnecessary

A keyword search returns forty named, priced products in one request. That is why Fetch product details is off by default: it costs a request per product, and the name, the price, the rating and the link are already there without it.

Turn it on when you need the brand, the category id or the attributes. Leave it off when you are enumerating a market.

Run sizes

Pages per search term walks deeper into a search. Maximum products caps the whole run and is also the cost ceiling, since every product is a billed row.

Errors

Code	Meaning
blocked	A listing page could not be read after every attempt
detail_failed	A product page could not be read; the product still appears, without its details
bad_input	No search term, category or product URL was given

A detail_failed never costs you the row. The product keeps its name and link and simply has no brand or attributes.

A note on reliability

Access here is narrow. If a run suddenly returns blocked across the board where it worked last week, that is what has happened; it is not your search term. Check products against errorCount in the run summary, which is exactly the ratio that tells the two apart.

Related actors

For marketplaces where prices are available, see the Amazon, eBay, Walmart, Bol, Idealo and AliExpress actors.