SHEIN API endpoint
Returns a SHEIN product by the required numeric `goods_id`; `goods_sn` is optional and narrows the lookup. The response has the name, description, category, brand code, sale, retail and USD prices, images, video URL, size options, per-SKU stock and prices, and colour variants.
/shein/products/detailReturns a SHEIN product's detail: identity, copy, price, images, sizes/stock, color variants, and category/brand.
Query parameters:
goods_id (required) — numeric SHEIN goods id, from a search result's
goods_id, e.g. 163003837.goods_sn (optional) — SHEIN goods serial number; narrows the lookup when
supplied.Response data includes sale_price/usd_price/retail_price, images,
color_variants ({goods_id, goods_sn, color_name, image, color_image, goods_url_name}), sizes ({attr_id, attr_name, attr_value_id, attr_value_name}), and skus ({sku_code, sku_sale_attr, stock, sale_price, usd_price, retail_price}).
| Field | Filled in, of 6 checked | Values in the sample |
|---|---|---|
| attr_id | 6 | |
| attr_name | 6 | Size in all 6 |
| attr_value_id | 6 | |
| attr_value_name | 6 | “XXS” and 5 other values |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| goods_id | string | Yes | Numeric SHEIN goods id (from a search result's goods_id) | 163003837 | |
| goods_sn | string | No | SHEIN goods serial number, narrows the lookup | sz25081193234595996 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/shein/products/detail?goods_id=163003837" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"goods_id": "163003837",
"goods_name": "Sweetra Women's Oblique Shoulder Fitted Bandeau Dress",
"sale_price": "HK$119.00",
"usd_price": "$15.16",
"on_sale": true,
"color_variants": [
{
"goods_id": "162996968",
"color_name": "Blue"
}
],
"sizes": [
{
"attr_id": "87",
"attr_name": "Size",
"attr_value_id": "757",
"attr_value_name": "XXS"
}
],
"skus": [
{
"sku_code": "I6ar22eezl2i",
"stock": "20",
"sale_price": "HK$119.00"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/shein.productDetailResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | shein.ProductDetail | No | ||||
| data.brand_code | string | No | 1qmfm | |||
| data.category_id | string | No | 12476 | |||
| data.category_name | string | No | Women Dresses | |||
| data.color_variants | array | No | ||||
| data.color_variants[].color_image | string | No | ||||
| data.color_variants[].color_name | string | No | Blue | |||
| data.color_variants[].goods_id | string | No | 162996968 | |||
| data.color_variants[].goods_sn | string | No | sz25081190840936964 | |||
| data.color_variants[].goods_url_name | string | No | ||||
| data.color_variants[].image | string | No | ||||
| data.description | string | No | ||||
| data.goods_id | string | No | 163003837 | |||
| data.goods_name | string | No | Sweetra Women's Oblique Shoulder Fitted Bandeau Dress | |||
| data.goods_sn | string | No | sz25081193234595996 | |||
| data.images | array | No | ||||
| data.on_sale | boolean | No | true | |||
| data.retail_price | string | No | HK$119.00 | |||
| data.sale_price | string | No | HK$119.00 | |||
| data.size_guide_url | string | No | ||||
| data.sizes | array | No | ||||
| data.sizes[].attr_id | string | No | 87 | |||
| data.sizes[].attr_name | string | No | Size | |||
| data.sizes[].attr_value_id | string | No | 757 | |||
| data.sizes[].attr_value_name | string | No | XXS | |||
| data.skus | array | No | ||||
| data.skus[].retail_price | string | No | HK$119.00 | |||
| data.skus[].sale_price | string | No | HK$119.00 | |||
| data.skus[].sku_code | string | No | I6ar22eezl2i | |||
| data.skus[].sku_sale_attr | string | No | ||||
| data.skus[].stock | string | No | 20 | |||
| data.skus[].usd_price | string | No | $15.16 | |||
| data.store_code | string | No | 7945614031 | |||
| data.usd_price | string | No | $15.16 | |||
| data.video_url | string | No | ||||
| 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/products/detail?goods_id=163003837" \
-H "x-api-key: $CRAWLORA_API_KEY"