SHEIN API endpoint
Returns one page of SHEIN's coupon/deal product pool (≈3,000 items at the time of writing), with the same normalized product-card fields as product search plus an `is_new_coupon` flag. Paging is 1-based; `page_size` is capped at 20 by the upstream.
/shein/deals/productsQuery parameters:
page (default 1) — 1-based page number.page_size (default 10) — products per page, 1–20.Response data includes page, total, and products, an array of product
cards (goods_id, goods_name, goods_sn, spu, goods_url_name, brand_code, category_id, category_name, goods_img, color_img, detail_images, sale_price, retail_price, usd_price, comment_count, comment_avg, sold_out, on_sale, store_code, mall_code) with an extra is_new_coupon boolean. An empty
products array is valid when the pool is exhausted.
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| page | integer | No | 1-based page number (default 1) | 1 | |
| page_size | integer | No | Products per page, 1-20 (default 10) | 10 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/shein/deals/products?page=1" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"page": 1,
"total": 3000,
"products": [
{
"goods_id": "97008872",
"goods_name": "SHEIN Solid Tee",
"sale_price": "HK$44.00",
"usd_price": "$5.61",
"on_sale": true,
"is_new_coupon": false
}
]
}
}Request schema
No body schema
Response schema
#/definitions/shein.dealsProductsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | shein.DealsProductsResponse | No | ||||
| data.page | integer | No | 1 | |||
| data.products | array | No | ||||
| data.products[].brand_code | string | No | 1qmfm | |||
| data.products[].category_id | string | No | 12476 | |||
| data.products[].category_name | string | No | Women Long Dresses | |||
| data.products[].color_img | string | No | ||||
| data.products[].comment_avg | string | No | 4.68 | |||
| data.products[].comment_count | integer | No | 1001 | |||
| data.products[].detail_images | array | No | ||||
| data.products[].goods_id | string | No | 163003837 | |||
| data.products[].goods_img | string | No | ||||
| data.products[].goods_name | string | No | Sweetra Women's Oblique Shoulder Fitted Bandeau Dress | |||
| data.products[].goods_sn | string | No | sz25081193234595996 | |||
| data.products[].goods_url_name | string | No | Sweetra-Women-s-Oblique-Shoulder-Fitted-Bandeau-Dress | |||
| data.products[].is_new_coupon | boolean | No | false | |||
| data.products[].mall_code | string | No | 1 | |||
| data.products[].on_sale | boolean | No | true | |||
| data.products[].retail_price | string | No | HK$119.00 | |||
| data.products[].sale_price | string | No | HK$119.00 | |||
| data.products[].sold_out | boolean | No | false | |||
| data.products[].spu | string | No | z250520775866 | |||
| data.products[].store_code | string | No | 7945614031 | |||
| data.products[].usd_price | string | No | $15.16 | |||
| data.total | integer | No | 3000 | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/shein/deals/products?page=1" \
-H "x-api-key: $CRAWLORA_API_KEY"