AI City Remix$11,500 prize pool. Pick a city, let AI tell its story, Oct 22 – 28.Join now

1688 Shop Products

https://api.sandbase.ai/v1/api/1688/shop/items

List products from a 1688 shop by seller member ID with pagination, sort by sales, price or listing time, and shop category and price filters.

Price
$0.02USD / call
Method
POST
Response
JSON
Parameters
1 required · 6 optional
Production route

Try the model

Playground

Open playground
Input
Seller member ID.
Page number, starting at 1.
Number of items requested per page. The returned count may differ.
Shop product sort order. Allowed values: default, sales, price_up, price_down, time_up, time_down.
Shop category ID.
Minimum price filter in CNY.
Maximum price filter in CNY.
OutputReady

Your output will appear here

Complete the inputs, then click Run.

Model card

Specifications

Pricing

Base price
$0.02 / run

Request & response

Method
POST
Request body
application/json
Response
application/json
Execution
sync

Parameters

memberId
string · required
page
integer · optional
pageSize
integer · optional
sort
string (default, sales, price_up, price_down, time_up, time_down) · optional
shopCatId
string · optional
priceStart
string · optional
priceEnd
string · optional

Access

Provider
1688
API
Platform API
Base URL
https://api.sandbase.ai
Endpoint
/v1/api/1688/shop/items
Authentication
Bearer API key

API README

1688 Shop Products API

List products from a 1688 shop by seller member ID with pagination, sort by sales, price or listing time, and shop category and price filters.

The response is the platform's original data structure.

Request

curl -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "1688/shop/items", "memberId": "b2b-22162265973262bc4b"}'

Parameters

NameTypeRequiredDescription
memberIdstringYesSeller member ID.
pageintegerNoPage number, starting at 1.
pageSizeintegerNoNumber of items requested per page. The returned count may differ.
sortstringNoShop product sort order.
shopCatIdstringNoShop category ID.
priceStartstringNoMinimum price filter in CNY.
priceEndstringNoMaximum price filter in CNY.

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API
Platform API endpoint
https://api.sandbase.ai/v1/api/1688/shop/items
Authorization header
Authorization: Bearer $SANDBASE_API_KEY
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/1688/shop/items" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "page": 1,
  "sort": "default",
  "memberId": "b2b-22162265973262bc4b",
  "pageSize": 20
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs
APIPriceResponseReleased
1688$0.02 per callJSONOct 29, 2026
1688$0.02 per callJSONOct 29, 2026
1688$0.02 per callJSONOct 29, 2026
1688$0.02 per callJSONOct 29, 2026
1688$0.02 per callJSONOct 29, 2026

Questions

FAQ

How do I use the 1688 Shop Products API?

Send a POST request to https://api.sandbase.ai/v1/api/1688/shop/items with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the 1688 Shop Products API cost?

$0.02 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

What parameters does the 1688 Shop Products API accept?

Required: memberId (string). Optional: page (integer), pageSize (integer), sort (one of default, sales, price_up, price_down, time_up, time_down), shopCatId (string), priceStart (string) and priceEnd (string). The Parameters table and the Playground on this page list every field.

What does the 1688 Shop Products API return?

A JSON response returned in the same HTTP request (synchronous).

Do I need a 1688 developer account or API key?

No. 1688 Shop Products runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for 1688 API access separately.