Shopping

Shopee Products

Shopee product details by product link or shop and item id — names, prices, descriptions and images.

shopee-productsshopeeshoppingmarketplaceproductsapac

0 rows in the dataset

Download the dataset

Get every row this scraper has collected as one CSV or JSONL file. If the data is older than maxAgeHours, the scraper is re-run with its configured settings first. The key needs the datasets:export scope.

DOWNLOAD_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/datasets/shopee-products/downloads" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{"maxAgeHours":24,"format":"csv"}' | jq -r '.id')while true; do  STATUS=$(curl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY" | jq -r '.status')  [ "$STATUS" != "refreshing" ] && break  sleep 5donecurl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID/file" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -o dataset.csv

The rate is 1 credit per 100 rows cached and 2 credits live, charged on the rows in the dataset when the download becomes ready. A failed refresh is not charged. The file stays downloadable for 24 hours. See pricing.

Start a run

To choose the targets yourself, send the parameters below as input. The call returns 202 with the run; the key needs the scrapers:run scope and the account a positive credit balance.

curl -X POST "https://api.pandorlabs.com/v1/scrapers/shopee-products/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "host": "shopee.tw",      "items": [        "178926468.21448123549"      ],      "maxProducts": 50,      "requestDelayMs": 2000    }  }'

A run is billed at the live rate once it finishes: 2 credits per 100 rows it collected. A run that collects nothing costs nothing.

Parameters

Every parameter is optional. Anything you leave out uses the default shown here; an unknown name or an invalid value is rejected with a 400 that lists each problem.

Targeting

host
enum
Region
An item id only exists on the host that sold it. Currency and image CDN follow from this.
Default
shopee.tw
Allowed values
shopee.tw
shopee.sg
shopee.co.id
shopee.com.my
shopee.ph
shopee.vn
shopee.co.th
shopee.com.br
items
string[]
Products
Whole product URLs, or bare shopId.itemId pairs. Entries that parse to neither are reported as warnings.
Default
["178926468.21448123549"]
Example
https://shopee.tw/a-i.178926468.21448123549

Advanced

maxProducts
number
Max products per run
Anything beyond this is dropped and reported as a truncation warning.
Default
50
Range
1 to 2000
requestDelayMs
number
Delay between requests (ms)
Shopee rate-limits hard. Lowering this is the fastest way to get a run challenged.
Default
2000
Range
0 to 60000
tzOffsetMinutes
number
Timezone offset (minutes)
Sent as tz_offset_in_minutes. Only affects which time-limited promotions the API considers active.
Default
120
Range
-720 to 840

Anti-bot

sessionCookie
string
Session cookie
A Cookie header copied from a signed-in browser session. Without one the API answers every request with its anti-bot challenge — see the README.
Default
none
Example
SPC_F=…; SPC_SI=…; csrftoken=…
antiBotToken
string
af-ac-enc-dat token
Sent as the af-ac-enc-dat header. Measured effect on its own: it turns the challenge response from HTTP 403 into HTTP 200 with the identical challenge body. It does not unlock the data.
Default
none
Example
00c5d94926ac9d74

Input as JSON Schema

The same schema the API validates against. Use it as a tool input schema or to generate a typed client.

inputSchema

{  "type": "object",  "additionalProperties": false,  "properties": {    "host": {      "type": "string",      "enum": [        "shopee.tw",        "shopee.sg",        "shopee.co.id",        "shopee.com.my",        "shopee.ph",        "shopee.vn",        "shopee.co.th",        "shopee.com.br"      ],      "title": "Region",      "description": "An item id only exists on the host that sold it. Currency and image CDN follow from this.",      "default": "shopee.tw"    },    "items": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "Products",      "description": "Whole product URLs, or bare shopId.itemId pairs. Entries that parse to neither are reported as warnings.",      "default": [        "178926468.21448123549"      ],      "examples": [        "https://shopee.tw/a-i.178926468.21448123549"      ]    },    "maxProducts": {      "type": "number",      "minimum": 1,      "maximum": 2000,      "title": "Max products per run",      "description": "Anything beyond this is dropped and reported as a truncation warning.",      "default": 50    },    "requestDelayMs": {      "type": "number",      "minimum": 0,      "maximum": 60000,      "title": "Delay between requests (ms)",      "description": "Shopee rate-limits hard. Lowering this is the fastest way to get a run challenged.",      "default": 2000    },    "tzOffsetMinutes": {      "type": "number",      "minimum": -720,      "maximum": 840,      "title": "Timezone offset (minutes)",      "description": "Sent as tz_offset_in_minutes. Only affects which time-limited promotions the API considers active.",      "default": 120    },    "sessionCookie": {      "type": "string",      "maxLength": 2000,      "title": "Session cookie",      "description": "A Cookie header copied from a signed-in browser session. Without one the API answers every request with its anti-bot challenge — see the README.",      "examples": [        "SPC_F=…; SPC_SI=…; csrftoken=…"      ]    },    "antiBotToken": {      "type": "string",      "maxLength": 2000,      "title": "af-ac-enc-dat token",      "description": "Sent as the af-ac-enc-dat header. Measured effect on its own: it turns the challenge response from HTTP 403 into HTTP 200 with the identical challenge body. It does not unlock the data.",      "examples": [        "00c5d94926ac9d74"      ]    }  }}

Run, poll, read rows

The run is asynchronous. Poll it until it reaches a terminal status and its billing is paid, then page through its rows. Until then the rows endpoint answers 409 (still queued or running) or 402 (payment required).

RUN_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/scrapers/shopee-products/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "host": "shopee.tw",      "items": [        "178926468.21448123549"      ],      "maxProducts": 50,      "requestDelayMs": 2000    }  }' | jq -r '.id')while true; do  RUN=$(curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY")  STATUS=$(echo "$RUN" | jq -r '.status')  BILLING=$(echo "$RUN" | jq -r '.billing.status')  case "$STATUS" in queued|running) ;; *) [ "$BILLING" != "pending" ] && break ;; esac  sleep 5doneecho "$RUN" | jq '{status, rowCount, billing}'curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID/rows?page=1&limit=100" \  -H "Authorization: Bearer $PANDORLABS_KEY"

See the API reference for pagination, cancelling and listing runs.

Output fields

Rows have no fixed schema; these are the fields observed in the rows collected so far. Coverage is the share of rows where the field is present.

No rows collected yet, so no fields have been observed. Run the scraper once and they will appear here.