Docs menu

SHEIN API endpoint

SHEIN Category Product Listing API

Lists products in a SHEIN category, by the required numeric `cat_id`. `page` starts at 1 and `page_size` defaults to 20; `sort` is a non-negative integer, `0` by default. Each product has its id, name, images, sale, retail and USD prices, rating, review count, and `on_sale` and `sold_out` flags. `total` is the category's listing count.

GETapiKey10 credits/requestSHEINshein.categoryGoodsResponseDoc/shein/category/goods

Endpoint facts

Method: GET
API path: /shein/category/goods
Auth: apiKey
Credits: 10 credits/request
Charged on: Successful 2xx responses only
Platform: SHEIN
Response schema: #/definitions/shein.categoryGoodsResponseDoc

SHEIN Product Search & Category Data API Try SHEIN Category Product Listing API in Playground SHEIN API documentation

How this endpoint behaves

Returns SHEIN's product listing for a category, with the same product-card fields as product search.

Query parameters:

cat_id (required) — numeric SHEIN category id, e.g. 1727.
page (default 1) — 1-based page number.
page_size (default 20) — results per page.
sort (default 0) — SHEIN sort code, a non-negative integer. 0 is SHEIN's default ("recommended") and is the only code with a documented meaning. Any non-negative integer is accepted and passed through as-is; non-numeric values are rejected as invalid params.

Response data.products uses the same product-card shape as product search. data.total is the full listing count for the category.

Live monitoring

Monitored request: GET /shein/category/goods?cat_id=1727
Checks passed, 7 days to 14 Oct 2026: 1.5%
Median response time: 1.81 s

Current status of every endpoint

Request parameters

Parameter	Type	Required	Description	Example
cat_id	string	Yes	Numeric SHEIN category id	1727
page	integer	No	1-based page number	1
page_size	integer	No	Results per page	20
sort	string	No	SHEIN sort code: a non-negative integer. `0` is the default (recommended). Other codes are accepted and forwarded as-is; the full code-to-meaning mapping has not been live-verified yet (see the endpoint markdown), so callers relying on a specific ordering should confirm behavior empirically.	0
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/shein/category/goods?cat_id=1727&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "cat_id": "1727",
    "category_name": "Dresses",
    "total": 1187,
    "page": 1,
    "products": [
      {
        "goods_id": "163003837",
        "goods_name": "Sweetra Women's Oblique Shoulder Fitted Bandeau Dress",
        "sale_price": "HK$119.00",
        "on_sale": true
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/shein.categoryGoodsResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	shein.CategoryGoodsResponse	No
data.cat_id	string	No	1727
data.category_name	string	No	Dresses
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[].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	1187
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/shein/category/goods?cat_id=1727&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More SHEIN endpoint docs SHEIN Product Search & Category Data API SHEIN Category Filter Facets API documentation SHEIN Category Nav Tabs API documentation SHEIN Search Aggregation Filters API documentation SHEIN Product Detail API documentation SHEIN Product Search API documentation SHEIN Search Autocomplete API documentation

Open in Playground Back to group

Docs menu

SHEIN API endpoint

SHEIN Category Product Listing API

GETapiKey10 credits/requestSHEINshein.categoryGoodsResponseDoc/shein/category/goods

Endpoint facts

Method: GET
API path: /shein/category/goods
Auth: apiKey
Credits: 10 credits/request
Charged on: Successful 2xx responses only
Platform: SHEIN
Response schema: #/definitions/shein.categoryGoodsResponseDoc

SHEIN Product Search & Category Data API Try SHEIN Category Product Listing API in Playground SHEIN API documentation

How this endpoint behaves

Returns SHEIN's product listing for a category, with the same product-card fields as product search.

Query parameters:

cat_id (required) — numeric SHEIN category id, e.g. 1727.
page (default 1) — 1-based page number.
page_size (default 20) — results per page.
sort (default 0) — SHEIN sort code, a non-negative integer. 0 is SHEIN's default ("recommended") and is the only code with a documented meaning. Any non-negative integer is accepted and passed through as-is; non-numeric values are rejected as invalid params.

Response data.products uses the same product-card shape as product search. data.total is the full listing count for the category.

Live monitoring

Monitored request: GET /shein/category/goods?cat_id=1727
Checks passed, 7 days to 14 Oct 2026: 1.5%
Median response time: 1.81 s

Current status of every endpoint

Request parameters

Parameter	Type	Required	Description	Example
cat_id	string	Yes	Numeric SHEIN category id	1727
page	integer	No	1-based page number	1
page_size	integer	No	Results per page	20
sort	string	No	SHEIN sort code: a non-negative integer. `0` is the default (recommended). Other codes are accepted and forwarded as-is; the full code-to-meaning mapping has not been live-verified yet (see the endpoint markdown), so callers relying on a specific ordering should confirm behavior empirically.	0
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/shein/category/goods?cat_id=1727&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "cat_id": "1727",
    "category_name": "Dresses",
    "total": 1187,
    "page": 1,
    "products": [
      {
        "goods_id": "163003837",
        "goods_name": "Sweetra Women's Oblique Shoulder Fitted Bandeau Dress",
        "sale_price": "HK$119.00",
        "on_sale": true
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/shein.categoryGoodsResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	shein.CategoryGoodsResponse	No
data.cat_id	string	No	1727
data.category_name	string	No	Dresses
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[].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	1187
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/shein/category/goods?cat_id=1727&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

SHEIN Category Product Listing API

Endpoint facts

How this endpoint behaves

Live monitoring

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

SHEIN Category Product Listing API

Endpoint facts

How this endpoint behaves

Live monitoring

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related