Chuyển tới nội dung chính

v2.product.get_item_list

GET /api/v2/product/get_item_list

Use this call to get a danh sách items.

Đường dẫn Endpoint

URL: https://partner.shopeemobile.com/api/v2/product/get_item_list

Tham số chung

TênKiểuMẫuMô tả
partner_idint1Partner ID được gán khi đăng ký thành công. Bắt buộc cho tất cả các yêu cầu.
timestamptimestamp1610000000Dùng để chỉ định thời gian của yêu cầu. Bắt buộc cho tất cả các yêu cầu. Hết hạn sau 5 phút.
access_tokenstringc09222e3fc40ffb25fc947f738b1abf1Token truy cập API, dùng để xác định quyền của bạn đối với API. Có thể sử dụng nhiều lần và hết hạn sau 4 giờ.
shop_idint600000Mã định danh duy nhất của Shopee cho một cửa hàng. Tham số bắt buộc cho hầu hết các API.
signstringe318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2Signature generated by partner_id, api path, timestamp, access_token, shop_id and partner_key via HMAC-SHA256 hashing algorithm. More details: https://open.shopee.com/documents?module=87&type=2&id=58&version=2

Tham số Request

TênKiểuBắt buộcMẫuMô tả
offsetint64True0Specifies the starting entry of data to return in the current call. Default is 0. if data is more than one page, the offset can be some entry to start next call.
page_sizeint64True10the size of one page.Max=100
update_time_fromtimestampFalse1611311600The update_time_from and update_time_to fields specify a date range for retrieving orders (based on the item update time). The update_time_from field is the starting date range.
update_time_totimestampFalse1611311631The update_time_from and update_time_to fields specify a date range for retrieving orders (based on the item update time). The update_time_to field is the ending date range
item_statusstring[]True["NORMAL"]NORMAL/BANNED/UNLIST/REVIEWING/SELLER_DELETE/SHOPEE_DELETE If you want to search multiple status, please upload the url like this: item_status=NORMAL&item_status=BANNED

Tham số Response

TênKiểuMẫuMô tả
errorstringLoại lỗi nếu có lỗi xảy ra. Trống nếu không có lỗi.
messagestringChi tiết lỗi nếu có lỗi xảy ra. Trống nếu không có lỗi.
warningstringIndicate waring details if hit waring. Empty if no waring happened.
request_idstring7b9da0c6926642199c33ee9dd3a266f5The identifier for an API request for error tracking
responseobject
itemobject[]danh sách item info with item_id/ item_status/ update_time
item_idint642500139861Shopee's mã định danh duy nhất for an item.
item_statusstringNORMALEnumerated type that defines the current status of the item. Các giá trị áp dụng: NORMAL, BANNED, UNLIST, REVIEWING, SELLER_DELETE, SHOPEE_DELETE.
update_timetimestamp1608128470The update time of item.
tagobject
kitbooleantrueIndicate if the item is kit item.
total_countint6410total count of all items
has_next_pagebooleantrueThis is to indicate whether the item list is more than one page. If this value is true, you may want to continue to check next page to retrieve the rest of items.
next_offsetint6410if has_next_page is true, this value need set to next request.offset

Unirest.setTimeouts(0, 0); HttpResponse<String> response = Unirest.get("https://partner.shopeemobile.com/api/v2/product/get\_item\_list?page\_size=10&item\_status=NORMAL&offset=0&partner\_id=partner\_id&access\_token=access\_token&timestamp=timestamp&update\_time\_from=1611311600&update\_time\_to=1611311631&sign=sign&shop\_id=shop\_id") .asString();<?php $curl = curl_init(); curl_setopt_array($curl, array( CURLOPT_URL => 'https://partner.shopeemobile.com/api/v2/product/get\_item\_list?access\_token=access\_token&item\_status=NORMAL&offset=0&page\_size=10&partner\_id=partner\_id&shop\_id=shop\_id&sign=sign&timestamp=timestamp&update\_time\_from=1611311600&update\_time\_to=1611311631', CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => '', CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 0, CURLOPT_FOLLOWLOCATION => true, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => 'GET', CURLOPT_HTTPHEADER => array( 'Content-Type: application/json' ), )); $response = curl_exec($curl); curl_close($curl); echo $response; curl --location --request GET 'https://partner.shopeemobile.com/api/v2/product/get\_item\_list?access\_token=access\_token&timestamp=timestamp&update\_time\_from=1611311600&page\_size=10&item\_status=NORMAL&offset=0&partner\_id=partner\_id&update\_time\_to=1611311631&sign=sign&shop\_id=shop\_id' import requests url = "https://partner.shopeemobile.com/api/v2/product/get\_item\_list?access\_token=access\_token&item\_status=NORMAL&offset=0&page\_size=10&partner\_id=partner\_id&shop\_id=shop\_id&sign=sign&timestamp=timestamp&update\_time\_from=1611311600&update\_time\_to=1611311631" payload={} headers = { } response = requests.request("GET",url,headers=headers, data=payload, allow_redirects=False) print(response.text)

, "update_time": 1608128470 } ], "total_count": 19, "has_next_page": true, "next_offset": 10 } }