Thông tin cơ bản sản phẩm — Shopee API

v2.product.get_item_base_info

Request

Endpoint

Authentication & shop

Request parameters

Request examples

curl -s "https://partner.quantri360.com/v1/shopee/api/v2/product/get_item_base_info?item_id_list=10000000081%2C10000000059" \
  -H "Authorization: Bearer $KEY"

import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.get(
    "https://partner.quantri360.com/v1/shopee/api/v2/product/get_item_base_info",
    params={
        "item_id_list": "10000000081,10000000059"
    },
    headers={"Authorization": f"Bearer {KEY}"},
    timeout=60,
)
print(r.status_code)
print(r.json())

const KEY = 'q360_live_...'; // khóa API của brand
const url = new URL('https://partner.quantri360.com/v1/shopee/api/v2/product/get_item_base_info');
for (const [k, v] of Object.entries({"item_id_list":"10000000081,10000000059"})) url.searchParams.set(k, typeof v === 'object' ? JSON.stringify(v) : String(v));
const r = await fetch(url, {
  method: 'GET',
  headers: { Authorization: `Bearer ${KEY}` },
});
console.log(r.status, await r.json());

<?php
$key = 'q360_live_...'; // khóa API của brand
$url = 'https://partner.quantri360.com/v1/shopee/api/v2/product/get_item_base_info' . '?' . http_build_query(['item_id_list' => '10000000081,10000000059']);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $key]);
$res = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status, "\n", $res;

Response

Response fields (as returned by Shopee)

Response sample

{
  "error": "",
  "message": "",
  "warning": "fail to get channel estimated_shipping_fee for channel [50039];…",
  "request_id": "e3e3e7f35ef6c60c…",
  "response": {
    "item_list": [
      {
        "item_id": 10000000081,
        "category_id": 100102,
        "item_name": "Sản phẩm mẫu",
        "item_sku": "Sản phẩm mẫu",
        "create_time": 1720759705,
        "update_time": 1793242278,
        "attribute_list": [
          {
            "attribute_id": 100134,
            "original_attribute_name": "Material",
            "attribute_value_list": [
              {
                "value_id": 0,
                "original_value_name": "Tuytsi",
                "value_unit": ""
              }
            ],
            "is_mandatory": false
          },
          {
            "attribute_id": 100152,
            "original_attribute_name": "Dress/Skirt Style",
            "attribute_value_list": [
              {
                "value_id": 1367,
                "original_value_name": "A-Line",
                "value_unit": ""
              }
            ],
            "is_mandatory": false
          }
        ],
        "image": {
          "image_id_list": [
            "sg-10000000095-8258g-mtrn1z8ec64mdd",
            "vn-10000000092-7r98o-lxm45esiq5zt3b"
          ],
          "image_url_list": [
            "https://example.com/anh-mau.jpg",
            "https://example.com/anh-mau.jpg"
          ],
          "image_ratio": "1:1"
        },
        "weight": "0.5",
        "dimension": {
          "package_length": 25,
          "package_width": 20,
          "package_height": 10
        },
        "logistic_info": [
          {
            "logistic_id": 5001,
            "logistic_name": "Nhanh",
            "enabled": true,
            "size_id": 0,
            "is_free": false,
            "include_pickup": false
          },
          {
            "logistic_id": 5012,
            "logistic_name": "Trong Ngày",
            "enabled": false,
            "size_id": 0,
            "is_free": false,
            "include_pickup": false
          }
        ],
        "pre_order": {
          "is_pre_order": false,
          "days_to_ship": 2
        },
        "condition": "NEW",
        "item_status": "NORMAL",
        "has_model": true,
        "promotion_id": 10000000101,
        "has_promotion": true,
        "brand": {
          "brand_id": 1069303,
          "original_brand_name": "Thương hiệu mẫu"
        },
        "description_type": "extended",
        "description_info": {
          "extended_description": {
            "field_list": [
              {
                "field_type": "text",
                "text": "Chân váy Thương hiệu mẫu dáng A… Chất liệu: Tuytsi…"
              },
              {
                "field_type": "image",
                "image_info": {
                  "image_id": "vn-10000000102-7r98o-lxm48z1tdyorab",
                  "image_url": "https://example.com/anh-mau.jpg"
                }
              }
            ]
          }
        },
        "size_chart_id": 0,
        "deboost": "FALSE",
        "is_fulfillment_by_shopee": false,
        "tag": {
          "kit": false
        },
        "purchase_limit_info": {
          "min_purchase_limit": 1
        }
      }
    ]
  },
  "debug_message": ""
}

Shopee error codes (21)

Get started

1. Sign up for Partner
2. Enable a data type of the Sản phẩm group on the platform page
3. Create an API key (tick the Shopee channel)
4. Call it as in the examples above