Loading / 加载中…
Loading / 加载中…
E-commerce & marketplace data
This API returns data about listings on 1688.com. It covers the category tree with translated names, category listings in fixed-size pages, keyword search over wholesale offers, a search over 1688's curated factory shortlist, detail for one offer including its quantity price ladder and variants, and the buyer reviews of one offer. Prices are in CNY.
Checking current availability and approved prices…
JSON in, a structured response out. Every public gateway endpoint uses POST.
Returns 1688 category nodes from 1 to 3 levels deep, named in any of the 9 listed languages, with the original Chinese name kept beside each node.
POST /api/v1/alibaba-1688/post-1688-categoriesUse a JSON object with the documented path, query, headers and body locations; omit unused locations. input.headers is schema-validated data, not browser request headers. Do not put credentials here. Keep body arrays, scalar values and null as documented; omission is different from null.
{
"body": {
"depth": 1,
"language": "ru"
}
}Pages through the offers of one 1688 category; each row carries a CNY price, minimum order quantity, listing date, fulfilment promises and certifications.
POST /api/v1/alibaba-1688/post-1688-category-offersUse a JSON object with the documented path, query, headers and body locations; omit unused locations. input.headers is schema-validated data, not browser request headers. Do not put credentials here. Keep body arrays, scalar values and null as documented; omission is different from null.
{
"body": {
"category_id": "1031910"
}
}For one offer id, returns title, images, CNY price and price type, the quantity price ladder, MOQ, stock, mixed-batch terms, attributes, a seller block and per-variant SKUs.
POST /api/v1/alibaba-1688/post-1688-product-detailUse a JSON object with the documented path, query, headers and body locations; omit unused locations. input.headers is schema-validated data, not browser request headers. Do not put credentials here. Keep body arrays, scalar values and null as documented; omission is different from null.
{
"body": {
"offer_id": "864971848115"
}
}For one offer id, returns the average rating out of 5, the positive-feedback percentage, a review count and individual reviews with text, quantity, variant, photos and date.
POST /api/v1/alibaba-1688/post-1688-product-reviewsUse a JSON object with the documented path, query, headers and body locations; omit unused locations. input.headers is schema-validated data, not browser request headers. Do not put credentials here. Keep body arrays, scalar values and null as documented; omission is different from null.
{
"body": {
"offer_id": "864971848115"
}
}Searches 1688 offers by keyword and returns a shortlist of about 20 offers, each with price, seller company, both repeat-purchase rates, attributes, category ids and an ad flag.
POST /api/v1/alibaba-1688/post-1688-searchUse a JSON object with the documented path, query, headers and body locations; omit unused locations. input.headers is schema-validated data, not browser request headers. Do not put credentials here. Keep body arrays, scalar values and null as documented; omission is different from null.
{
"body": {
"query": "蓝牙耳机"
}
}Searches 1688's curated manufacturer shortlist by keyword and returns location, workforce, floor area, medal, repeat-buyer and on-time rates, audit status and offer ids.
POST /api/v1/alibaba-1688/post-1688-supplier-searchUse a JSON object with the documented path, query, headers and body locations; omit unused locations. input.headers is schema-validated data, not browser request headers. Do not put credentials here. Keep body arrays, scalar values and null as documented; omission is different from null.
{
"body": {
"query": "蓝牙耳机"
}
}POST /api/v1/<project>/<action> with x-api-key, Content-Type: application/json and a required Idempotency-Key.data is the result of the operation.Yes. body.offer_id is a string that accepts either the digits of an offer id or a full offer url. Alternative field names such as offerId or url are not accepted.
1688 fills its keyword results largely with promoted listings, and the ad flag reflects what 1688 marks. For unpromoted rows, use category offers, which you can reach through the category ids on a search row.
Chinese terms return by far the richest results, because 1688 is a China-domestic market, while English or pinyin terms also match.
It sets how many attempts a call may make before giving up, from 1 to 8 with a default of 4.