API Request Format

The Alibaba product detail endpoint retrieves comprehensive product information including attributes, pricing, and main images using a GET request with the following parameters:

# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests

# API endpoint with query parameters
api_url = "https://api-gw.example.com/alibaba/product/detail/"
params = {
    "key": "your_api_key_here",
    "secret": "your_api_secret_here",
    "product_id": "60840463360"
}
headers = {
    "Accept-Encoding": "gzip",
    "Connection": "close"
}

if __name__ == "__main__":
    response = requests.get(api_url, params=params, headers=headers)
    data = response.json()
    print(data)

Response Structure

The API returns product data in JSON format with the following structure:

{
    "item": {
        "num_iid": "60840463360",
        "title": "Casual Urban Walking Shoes",
        "desc_short": "",
        "price": "47.70",
        "nick": "cn1522808546pkux",
        "num": 9999,
        "min_num": 2,
        "detail_url": "https://www.alibaba.com/product-detail/some-product_60840463360.html",
        "pic_url": "https://sc04.alicdn.com/kf/HTB1GHVXaPvuK1Rjy0Faq6x2aVXa7.jpg",
        "desc": "...",
        "item_imgs": [
            {"url": "https://sc04.alicdn.com/kf/HTB1GHVXaPvuK1Rjy0Faq6x2aVXa7.jpg"},
            {"url": "https://sc04.alicdn.com/kf/HTB1S8U6avfsK1RjSszbq6AqBXXaz.jpg"}
        ],
        "video_url": "https://vod-icbu.example.com/video.mp4",
        "props_name": "191288010:-1:Color:navy;191288010:3331185:Color:White;...",
        "prop_imgs": {
            "prop_img": [
                {
                    "properties": "191288010:3327837",
                    "url": "https://sc04.alicdn.com/kf/HTB1ZEZYasrrK1Rjy1zeq6xalFXai.jpg"
                }
            ]
        },
        "props": [
            {"name": "Origin", "value": "China"},
            {"name": "Brand", "value": "HOTPOTATO"},
            {"name": "Model", "value": "G2"}
        ],
        "skus": {
            "sku": [
                {
                    "price": "47.70",
                    "properties": "191288010:-1;214524521:28393",
                    "properties_name": "191288010:-1:Color:navy;214524521:28393:Shoe Size:44",
                    "quantity": "999",
                    "sku_id": 274257648
                }
            ]
        },
        "priceRange": [
            [2, 47.7],
            [1200, 17.9],
            [2700, 16.1]
        ],
        "props_list": {
            "191288010:-1": "Color:navy",
            "214524521:28393": "Shoe Size:44"
        },
        "seller_info": {
            "zhuy": "https://example.en.alibaba.com/company_profile.html",
            "title": "Guangzhou Gull Road Trade Co., Ltd.",
            "nick": "cn1522808546pkux",
            "shop_name": "Guangzhou Gull Road Trade Co., Ltd."
        },
        "props_img": {
            "191288010:3327837": "https://sc04.alicdn.com/kf/HTB1ZEZYasrrK1Rjy1zeq6xalFXai.jpg"
        },
        "currency_code": "USD",
        "language_code": "en",
        "property_alias": "191288010:-1:navy;214524521:28393:44;...",
        "sales": 0,
        "desc_img": ["//sc01.alicdn.com/kf/...", "//sc01.alicdn.com/kf/..."]
    },
    "error": ""
}

Field Reference

Field Name	Type	Description
num_iid	Bigint	Unique product identifier
title	String	Product title
desc_short	String	Short product description
price	String	Current price in specified currency
nick	String	Seller nickname
num	String	Total stock quantity
min_num	String	Minimum order quantity
detail_url	String	Direct link to product page
pic_url	String	Main product image URL
item_imgs	Mix	Array of all product images
props_name	String	Full attribute names with values
prop_imgs	Mix	Attribute-specific images (color variants)
props	Mix	Detailed product specifications
skus	Mix	SKU list with individual pricing and stock
priceRange	Mix	Tiered pricing based on quantity
props_list	Mix	Simplified attribute mapping
seller_info	Mix	Seller details including shop name and URL
props_img	Mix	Attribute to image mapping
currency_code	String	Currency code (USD, CNY, etc.)
language_code	String	Response language code
property_alias	String	Attribute value aliases
sales	String	Total sales count
desc_img	Mix	Detailed description images

SKU Structure

Each SKU entry contains:

• price: Unit price for this variant
• properties: Attribute ID combination (color, size, etc.)
• properties_name: Human-readable attribute values
• quantity: Available stock to this specific variant
• sku_id: Unique SKU identifier

Pricing Tiers

The priceRange field provides tiered pricing based on order quantity. Each tier is represented as [minimum_quantity, unit_price], enabling bulk pricing calculations.

Integration Notes

• API authentication requires both key and secret parameters
• Product images are served from Alibaba's CDN network
• Attribute IDs vary between product caetgories
• Response language can be controlled via parameters
• Rate limiting policies apply to API usage