版本：202201
查询商品列表
GET/openapi/2022-01/products
分页获取商品列表。
请求
Query参数
ids string
商品 ID 列表。
title string
商品名称。
collection_id string
专辑 UUID，例如：9e79ca1f-9ff2-409b-976f-98be343d38a3。
created_at_min string
筛选创建时间不早于该时间点的商品，例如：2018-10-01T16:15:47-04:00。
created_at_max string
筛选创建时间不晚于该时间点的商品，例如：2018-10-01T16:15:47-04:00。
updated_at_min string
筛选最后更新时间不早于该时间点的商品，例如：2018-10-01T16:15:47-04:00。
updated_at_max string
筛选最后更新时间不晚于该时间点的商品，例如：2018-10-01T16:15:47-04:00。
published_at_min string
筛选上架时间不早于该时间点的商品，例如：2018-10-01T16:15:47-04:00。
published_at_max string
筛选上架时间不晚于该时间点的商品，例如：2018-10-01T16:15:47-04:00。
published_status string
按上架状态筛选，可选值：published（已上架）、unpublished（未上架）、any（全部）。
spus string
商品 SPU 列表，多个值之间使用英文逗号分隔，例如：spu1,spu2。
pre_cursor string
上一页游标，参考基于游标的分页。
cursor string
分页游标，参考基于游标的分页。
per_page int32
每页记录数，最大 250。
fields string
指定响应中需要返回的字段列表。
vendors string
按商品供应商筛选（精确匹配）。
vendors_match string
按商品供应商进行模糊匹配筛选。
handles string
按商品 handle 列表筛选。
响应
- 200
200
- application/json
- 数据结构
- 示例
- Result
数据结构
- Array [
- Array [
- ]
- Array [
- ]
- Array [
- Array [
- ]
- ]
- ]
cursorstring
示例：
MjAyNC0wNC0xN1QwMjoxNToxOFojYTFhODhiZTAtYTFkNC00N2U0LWEyZjItYmE2ZTEzMWNmNDQ3pre_cursorstring
示例：
MjAyNC0wNC0xN1QwMjoxNToxOFojYTFhODhiZTAtYTFkNC00N2U0LWEyZjItYmE2ZTEzMWNmNDQ3products object[]
briefstring
示例：
shirtcreated_atstring
示例：
2024-04-17T02:15:18Zdescriptionstring
示例：
<p>Desc</p>display_fake_salesboolean
默认值：
true示例：
truefake_salesinteger
默认值：
0示例：
10handlestring
示例：
shirthas_only_default_variantboolean
默认值：
true示例：
falseidstring
示例：
a1a88be0-a1d4-47e4-a2f2-ba6e131cf447image object
srcstring
示例：
//cdn.shoplazza.com/ccf0794c594bad32a320eea0d6bfe40c.jpegwidthinteger
默认值：
0示例：
174heightinteger
默认值：
0示例：
180pathstring
示例：
ccf0794c594bad32a320eea0d6bfe40c.jpegaltstring
示例：
category object
idinteger
默认值：
0示例：
368313940138040900namestring
示例：
3google_idinteger
默认值：
0示例：
0levelinteger
默认值：
0示例：
3pathstring
示例：
368313940138008142,368313940138024526,368313940138040910images object[]
idstring
示例：
8ef098c5-5a08-44b4-b5fb-89214bb507dcproduct_idstring
示例：
a1a88be0-a1d4-47e4-a2f2-ba6e131cf447positioninteger
默认值：
0示例：
1srcstring
示例：
//cdn.shoplazza.com/ccf0794c594bad32a320eea0d6bfe40c.jpegwidthinteger
默认值：
0示例：
174heightinteger
默认值：
0示例：
180altstring
示例：
created_atstring
示例：
2024-04-17T02:15:18Zupdated_atstring
示例：
2024-04-17T02:15:35Zinventory_policystring
示例：
continueinventory_quantityinteger
默认值：
0示例：
72inventory_trackingboolean
默认值：
true示例：
truemixed_wholesaleboolean
默认值：
true示例：
falseneed_variant_imageboolean
默认值：
true示例：
truenotestring
示例：
options object[]
idstring
示例：
a4fc1abf-86fb-4e45-b774-9ff3b3f8ef90product_idstring
示例：
a1a88be0-a1d4-47e4-a2f2-ba6e131cf447positioninteger
默认值：
0示例：
1namestring
示例：
sizevaluesstring[]
publishedboolean
默认值：
true示例：
falsepublished_atstring
示例：
1970-01-01T00:00:00Zrequires_shippingboolean
默认值：
true示例：
trueseo_descriptionstring
示例：
Descseo_keywordsstring
示例：
seo_titlestring
示例：
shirtspustring
示例：
T-Mtagsstring
示例：
s1-s2taxableboolean
默认值：
true示例：
truetitlestring
示例：
shirtupdated_atstring
示例：
2024-04-17T02:15:35Zvariants object[]
idstring
示例：
88e68830-4ef5-4125-bf7d-aef8047176b2product_idstring
示例：
a1a88be0-a1d4-47e4-a2f2-ba6e131cf447image_idstring
示例：
8ef098c5-5a08-44b4-b5fb-89214bb507dccreated_atstring
示例：
2024-04-17T02:15:18Zupdated_atstring
示例：
2024-04-17T02:15:35Ztitlestring
示例：
S-blue-Toption1string
示例：
Soption2string
示例：
blueoption3string
示例：
Timage object
srcstring
示例：
//cdn.shoplazza.com/ccf0794c594bad32a320eea0d6bfe40c.jpegwidthinteger
默认值：
0示例：
174heightinteger
默认值：
0示例：
180pathstring
示例：
ccf0794c594bad32a320eea0d6bfe40c.jpegaltstring
示例：
positioninteger
默认值：
0示例：
1compare_at_pricestring
示例：
12.10pricestring
示例：
10.10skustring
示例：
T-M-S-blue-T-A001004barcodestring
示例：
6929000212340notestring
示例：
nodeinventory_quantityinteger
默认值：
0示例：
10weightstring
示例：
1.10weight_unitstring
示例：
kgcost_pricestring
示例：
1.10wholesale_price object[]
pricestring
示例：
10.10min_quantityinteger
默认值：
0示例：
1extend object
lengthinteger
默认值：
0示例：
10widthinteger
默认值：
0示例：
10heightinteger
默认值：
0示例：
10dimension_unitstring
示例：
inorigin_country_codestring
示例：
AGhs_codestring
示例：
62114390vendorstring
示例：
shoplazzavendor_urlstring
示例：
https://shoplazza.com{
"cursor": "MjAyNC0wNC0xN1QwMjoxNToxOFojYTFhODhiZTAtYTFkNC00N2U0LWEyZjItYmE2ZTEzMWNmNDQ3",
"pre_cursor": "MjAyNC0wNC0xN1QwMjoxNToxOFojYTFhODhiZTAtYTFkNC00N2U0LWEyZjItYmE2ZTEzMWNmNDQ3",
"products": [
{
"brief": "shirt",
"created_at": "2024-04-17T02:15:18Z",
"description": "<p>Desc</p>",
"display_fake_sales": true,
"fake_sales": 10,
"handle": "shirt",
"has_only_default_variant": false,
"id": "a1a88be0-a1d4-47e4-a2f2-ba6e131cf447",
"image": {
"src": "//cdn.shoplazza.com/ccf0794c594bad32a320eea0d6bfe40c.jpeg",
"width": 174,
"height": 180,
"path": "ccf0794c594bad32a320eea0d6bfe40c.jpeg",
"alt": ""
},
"category": {
"id": 368313940138040900,
"name": "3",
"google_id": 0,
"level": 3,
"path": "368313940138008142,368313940138024526,368313940138040910"
},
"images": [
{
"id": "8ef098c5-5a08-44b4-b5fb-89214bb507dc",
"product_id": "a1a88be0-a1d4-47e4-a2f2-ba6e131cf447",
"position": 1,
"src": "//cdn.shoplazza.com/ccf0794c594bad32a320eea0d6bfe40c.jpeg",
"width": 174,
"height": 180,
"alt": "",
"created_at": "2024-04-17T02:15:18Z",
"updated_at": "2024-04-17T02:15:35Z"
}
],
"inventory_policy": "continue",
"inventory_quantity": 72,
"inventory_tracking": true,
"mixed_wholesale": false,
"need_variant_image": true,
"note": "",
"options": [
{
"id": "a4fc1abf-86fb-4e45-b774-9ff3b3f8ef90",
"product_id": "a1a88be0-a1d4-47e4-a2f2-ba6e131cf447",
"position": 1,
"name": "size",
"values": [
"S"
]
}
],
"published": false,
"published_at": "1970-01-01T00:00:00Z",
"requires_shipping": true,
"seo_description": "Desc",
"seo_keywords": "",
"seo_title": "shirt",
"spu": "T-M",
"tags": "s1-s2",
"taxable": true,
"title": "shirt",
"updated_at": "2024-04-17T02:15:35Z",
"variants": [
{
"id": "88e68830-4ef5-4125-bf7d-aef8047176b2",
"product_id": "a1a88be0-a1d4-47e4-a2f2-ba6e131cf447",
"image_id": "8ef098c5-5a08-44b4-b5fb-89214bb507dc",
"created_at": "2024-04-17T02:15:18Z",
"updated_at": "2024-04-17T02:15:35Z",
"title": "S-blue-T",
"option1": "S",
"option2": "blue",
"option3": "T",
"image": {
"src": "//cdn.shoplazza.com/ccf0794c594bad32a320eea0d6bfe40c.jpeg",
"width": 174,
"height": 180,
"path": "ccf0794c594bad32a320eea0d6bfe40c.jpeg",
"alt": ""
},
"position": 1,
"compare_at_price": "12.10",
"price": "10.10",
"sku": "T-M-S-blue-T-A001004",
"barcode": "6929000212340",
"note": "node",
"inventory_quantity": 10,
"weight": "1.10",
"weight_unit": "kg",
"cost_price": "1.10",
"wholesale_price": [
{
"price": "10.10",
"min_quantity": 1
}
],
"extend": {
"length": 10,
"width": 10,
"height": 10,
"dimension_unit": "in",
"origin_country_code": "AG",
"hs_code": "62114390"
}
}
],
"vendor": "shoplazza",
"vendor_url": "https://shoplazza.com"
}
]
}
{
"cursor": "MjAyNC0wNC0xN1QwMjoxNToxOFojYTFhODhiZTAtYTFkNC00N2U0LWEyZjItYmE2ZTEzMWNmNDQ3",
"pre_cursor": "MjAyNC0wNC0xN1QwMjoxNToxOFojYTFhODhiZTAtYTFkNC00N2U0LWEyZjItYmE2ZTEzMWNmNDQ3",
"products": [
{
"brief": "shirt",
"created_at": "2024-04-17T02:15:18Z",
"description": "<p>Desc</p>",
"display_fake_sales": true,
"fake_sales": 10,
"handle": "shirt",
"has_only_default_variant": false,
"id": "a1a88be0-a1d4-47e4-a2f2-ba6e131cf447",
"image": {
"src": "//cdn.shoplazza.com/ccf0794c594bad32a320eea0d6bfe40c.jpeg",
"width": 174,
"height": 180,
"path": "ccf0794c594bad32a320eea0d6bfe40c.jpeg",
"alt": ""
},
"category": {
"id": 368313940138040910,
"name": "3",
"google_id": 0,
"level": 3,
"path": "368313940138008142,368313940138024526,368313940138040910"
},
"images": [
{
"id": "8ef098c5-5a08-44b4-b5fb-89214bb507dc",
"product_id": "a1a88be0-a1d4-47e4-a2f2-ba6e131cf447",
"position": 1,
"src": "//cdn.shoplazza.com/ccf0794c594bad32a320eea0d6bfe40c.jpeg",
"width": 174,
"height": 180,
"alt": "",
"created_at": "2024-04-17T02:15:18Z",
"updated_at": "2024-04-17T02:15:35Z"
}
],
"inventory_policy": "continue",
"inventory_quantity": 72,
"inventory_tracking": true,
"mixed_wholesale": false,
"need_variant_image": true,
"note": "",
"options": [
{
"id": "a4fc1abf-86fb-4e45-b774-9ff3b3f8ef90",
"product_id": "a1a88be0-a1d4-47e4-a2f2-ba6e131cf447",
"position": 1,
"name": "size",
"values": [
"S",
"L"
]
},
{
"id": "d6a27294-e070-4c00-988d-8d54122638a7",
"product_id": "a1a88be0-a1d4-47e4-a2f2-ba6e131cf447",
"position": 2,
"name": "color",
"values": [
"blue",
"red"
]
},
{
"id": "449e7329-a355-43b3-b17e-cfd499599086",
"product_id": "a1a88be0-a1d4-47e4-a2f2-ba6e131cf447",
"position": 3,
"name": "type",
"values": [
"T",
"S"
]
}
],
"published": false,
"published_at": "1970-01-01T00:00:00Z",
"requires_shipping": true,
"seo_description": "Desc",
"seo_keywords": "",
"seo_title": "shirt",
"spu": "T-M",
"tags": "s1-s2",
"taxable": true,
"title": "shirt",
"updated_at": "2024-04-17T02:15:35Z",
"variants": [
{
"id": "88e68830-4ef5-4125-bf7d-aef8047176b2",
"product_id": "a1a88be0-a1d4-47e4-a2f2-ba6e131cf447",
"image_id": "8ef098c5-5a08-44b4-b5fb-89214bb507dc",
"created_at": "2024-04-17T02:15:18Z",
"updated_at": "2024-04-17T02:15:35Z",
"title": "S-blue-T",
"option1": "S",
"option2": "blue",
"option3": "T",
"image": {
"src": "//cdn.shoplazza.com/ccf0794c594bad32a320eea0d6bfe40c.jpeg",
"width": 174,
"height": 180,
"path": "ccf0794c594bad32a320eea0d6bfe40c.jpeg",
"alt": ""
},
"position": 1,
"compare_at_price": "12.10",
"price": "10.10",
"sku": "T-M-S-blue-T-A001004",
"barcode": "6929000212340",
"note": "node",
"inventory_quantity": 10,
"weight": "1.10",
"weight_unit": "kg",
"cost_price": "1.10",
"wholesale_price": [
{
"price": "10.10",
"min_quantity": 1
}
],
"extend": {
"length": 10,
"width": 10,
"height": 10,
"dimension_unit": "in",
"origin_country_code": "AG",
"hs_code": "62114390"
}
},
{
"id": "deab5c4b-0ceb-498c-b2b6-d742321f3d20",
"product_id": "a1a88be0-a1d4-47e4-a2f2-ba6e131cf447",
"image_id": "8ef098c5-5a08-44b4-b5fb-89214bb507dc",
"created_at": "2024-04-17T02:15:18Z",
"updated_at": "2024-04-17T02:15:35Z",
"title": "S-blue-S",
"option1": "S",
"option2": "blue",
"option3": "S",
"image": {
"src": "//cdn.shoplazza.com/ccf0794c594bad32a320eea0d6bfe40c.jpeg",
"width": 174,
"height": 180,
"path": "ccf0794c594bad32a320eea0d6bfe40c.jpeg",
"alt": ""
},
"position": 2,
"compare_at_price": "12.10",
"price": "10.10",
"sku": "T-M-S-blue-S-A001005",
"barcode": "6929000212340",
"note": "node",
"inventory_quantity": 2,
"weight": "1.10",
"weight_unit": "kg",
"cost_price": "1.10",
"wholesale_price": [
{
"price": "10.10",
"min_quantity": 1
}
],
"extend": {
"length": 10,
"width": 10,
"height": 10,
"dimension_unit": "in",
"origin_country_code": "AO",
"hs_code": "62114390"
}
},
{
"id": "41a37521-ae26-4259-9771-22ef0221788c",
"product_id": "a1a88be0-a1d4-47e4-a2f2-ba6e131cf447",
"image_id": "8ef098c5-5a08-44b4-b5fb-89214bb507dc",
"created_at": "2024-04-17T02:15:18Z",
"updated_at": "2024-04-17T02:15:35Z",
"title": "S-red-T",
"option1": "S",
"option2": "red",
"option3": "T",
"image": {
"src": "//cdn.shoplazza.com/ccf0794c594bad32a320eea0d6bfe40c.jpeg",
"width": 174,
"height": 180,
"path": "ccf0794c594bad32a320eea0d6bfe40c.jpeg",
"alt": ""
},
"position": 3,
"compare_at_price": "12.10",
"price": "10.10",
"sku": "T-M-S-red-T-A001006",
"barcode": "6929000212340",
"note": "node",
"inventory_quantity": 10,
"weight": "1.10",
"weight_unit": "kg",
"cost_price": "1.10",
"wholesale_price": [
{
"price": "10.10",
"min_quantity": 1
}
],
"extend": {
"length": 10,
"width": 10,
"height": 10,
"dimension_unit": "in",
"origin_country_code": "AI",
"hs_code": "62114390"
}
},
{
"id": "97cbf601-7dbb-4ab4-86f2-c9b8d632494e",
"product_id": "a1a88be0-a1d4-47e4-a2f2-ba6e131cf447",
"image_id": "8ef098c5-5a08-44b4-b5fb-89214bb507dc",
"created_at": "2024-04-17T02:15:18Z",
"updated_at": "2024-04-17T02:15:35Z",
"title": "S-red-S",
"option1": "S",
"option2": "red",
"option3": "S",
"image": {
"src": "//cdn.shoplazza.com/ccf0794c594bad32a320eea0d6bfe40c.jpeg",
"width": 174,
"height": 180,
"path": "ccf0794c594bad32a320eea0d6bfe40c.jpeg",
"alt": ""
},
"position": 4,
"compare_at_price": "12.10",
"price": "10.10",
"sku": "T-M-S-red-S-A001007",
"barcode": "6929000212340",
"note": "node",
"inventory_quantity": 10,
"weight": "1.10",
"weight_unit": "kg",
"cost_price": "1.10",
"wholesale_price": [
{
"price": "10.10",
"min_quantity": 1
}
],
"extend": {
"length": 10,
"width": 10,
"height": 10,
"dimension_unit": "in",
"origin_country_code": "AI",
"hs_code": "62114390"
}
},
{
"id": "a7175820-36b3-4fc6-9baf-51e3035242ba",
"product_id": "a1a88be0-a1d4-47e4-a2f2-ba6e131cf447",
"image_id": "8ef098c5-5a08-44b4-b5fb-89214bb507dc",
"created_at": "2024-04-17T02:15:18Z",
"updated_at": "2024-04-17T02:15:35Z",
"title": "L-blue-T",
"option1": "L",
"option2": "blue",
"option3": "T",
"image": {
"src": "//cdn.shoplazza.com/ccf0794c594bad32a320eea0d6bfe40c.jpeg",
"width": 174,
"height": 180,
"path": "ccf0794c594bad32a320eea0d6bfe40c.jpeg",
"alt": ""
},
"position": 5,
"compare_at_price": "12.10",
"price": "10.10",
"sku": "T-M-L-blue-T-A001008",
"barcode": "6929000212340",
"note": "node",
"inventory_quantity": 10,
"weight": "1.10",
"weight_unit": "kg",
"cost_price": "1.10",
"wholesale_price": [
{
"price": "10.10",
"min_quantity": 1
}
],
"extend": {
"length": 10,
"width": 10,
"height": 10,
"dimension_unit": "in",
"origin_country_code": "AO",
"hs_code": "62114390"
}
},
{
"id": "e9a785a4-739b-45e6-93bb-d056d706c295",
"product_id": "a1a88be0-a1d4-47e4-a2f2-ba6e131cf447",
"image_id": "8ef098c5-5a08-44b4-b5fb-89214bb507dc",
"created_at": "2024-04-17T02:15:18Z",
"updated_at": "2024-04-17T02:15:35Z",
"title": "L-blue-S",
"option1": "L",
"option2": "blue",
"option3": "S",
"image": {
"src": "//cdn.shoplazza.com/ccf0794c594bad32a320eea0d6bfe40c.jpeg",
"width": 174,
"height": 180,
"path": "ccf0794c594bad32a320eea0d6bfe40c.jpeg",
"alt": ""
},
"position": 6,
"compare_at_price": "12.10",
"price": "10.10",
"sku": "T-M-L-blue-S-A001009",
"barcode": "6929000212340",
"note": "node",
"inventory_quantity": 10,
"weight": "1.10",
"weight_unit": "kg",
"cost_price": "1.10",
"wholesale_price": [
{
"price": "10.10",
"min_quantity": 1
}
],
"extend": {
"length": 10,
"width": 10,
"height": 10,
"dimension_unit": "in",
"origin_country_code": "AS",
"hs_code": "62114390"
}
},
{
"id": "14665246-d39e-46d6-a87a-23ad54db8477",
"product_id": "a1a88be0-a1d4-47e4-a2f2-ba6e131cf447",
"image_id": "8ef098c5-5a08-44b4-b5fb-89214bb507dc",
"created_at": "2024-04-17T02:15:18Z",
"updated_at": "2024-04-17T02:15:35Z",
"title": "L-red-T",
"option1": "L",
"option2": "red",
"option3": "T",
"image": {
"src": "//cdn.shoplazza.com/ccf0794c594bad32a320eea0d6bfe40c.jpeg",
"width": 174,
"height": 180,
"path": "ccf0794c594bad32a320eea0d6bfe40c.jpeg",
"alt": ""
},
"position": 7,
"compare_at_price": "12.10",
"price": "10.10",
"sku": "T-M-L-red-T-A001010",
"barcode": "6929000212340",
"note": "node",
"inventory_quantity": 10,
"weight": "1.10",
"weight_unit": "kg",
"cost_price": "1.10",
"wholesale_price": [
{
"price": "10.10",
"min_quantity": 1
}
],
"extend": {
"length": 10,
"width": 10,
"height": 10,
"dimension_unit": "in",
"origin_country_code": "AQ",
"hs_code": "62114390"
}
},
{
"id": "cbd7a7b0-5dd7-4902-9466-e21bd02688b4",
"product_id": "a1a88be0-a1d4-47e4-a2f2-ba6e131cf447",
"image_id": "8ef098c5-5a08-44b4-b5fb-89214bb507dc",
"created_at": "2024-04-17T02:15:18Z",
"updated_at": "2024-04-17T02:15:35Z",
"title": "L-red-S",
"option1": "L",
"option2": "red",
"option3": "S",
"image": {
"src": "//cdn.shoplazza.com/ccf0794c594bad32a320eea0d6bfe40c.jpeg",
"width": 174,
"height": 180,
"path": "ccf0794c594bad32a320eea0d6bfe40c.jpeg",
"alt": ""
},
"position": 8,
"compare_at_price": "12.10",
"price": "10.10",
"sku": "T-M-L-red-S-A001011",
"barcode": "6929000212340",
"note": "node",
"inventory_quantity": 10,
"weight": "1.10",
"weight_unit": "kg",
"cost_price": "1.10",
"wholesale_price": [
{
"price": "10.10",
"min_quantity": 1
}
],
"extend": {
"length": 10,
"width": 10,
"height": 10,
"dimension_unit": "in",
"origin_country_code": "DZ",
"hs_code": "62114390"
}
}
],
"vendor": "shoplazza",
"vendor_url": "https://shoplazza.com"
}
]
}