亚马逊商品详情接口完全指南：从 PA-API 到 SP-API 的全链路实战

import json
import boto3
from botocore.config import Config
# 配置凭证
ACCESS_KEY = 'YOUR_ACCESS_KEY'
SECRET_KEY = 'YOUR_SECRET_KEY'
PARTNER_TAG = 'yourtag-20'
REGION = 'us-east-1'  # PA-API 固定区域
def get_paapi_client():
    config = Config(
        region_name=REGION,
        retries={'max_attempts': 3, 'mode': 'standard'}
    )
    return boto3.client(
        'paapi5',
        aws_access_key_id=ACCESS_KEY,
        aws_secret_access_key=SECRET_KEY,
        config=config
    )
def get_items_by_asin(asin_list):
    """
    根据 ASIN 列表获取商品详情
    单次最多 10 个 ASIN
    """
    client = get_paapi_client()
    
    payload = {
        'ItemIds': asin_list[:10],  # 最多 10 个
        'ItemIdType': 'ASIN',
        'Resources': [
            'Images.Primary.Large',
            'Images.Variants.Large',
            'ItemInfo.Title',
            'ItemInfo.ByLineInfo',
            'ItemInfo.Features',
            'ItemInfo.ProductInfo',
            'Offers.Listings.Price',
            'Offers.Listings.SavingBasis',
            'CustomerReviews.StarRating',
            'BrowseNodeInfo.BrowseNodes'
        ],
        'PartnerTag': PARTNER_TAG,
        'PartnerType': 'Associates',
        'Marketplace': 'www.amazon.com'
    }
    
    try:
        response = client.get_items(**payload)
        return response
    except Exception as e:
        print(f"请求失败: {e}")
        return None
# 调用示例
result = get_items_by_asin(['B08N5WRWNW', 'B0BSHF7WHW'])
print(json.dumps(result, indent=2, default=str))

{
    "ItemsResult": {
        "Items": [
            {
                "ASIN": "B08N5WRWNW",
                "DetailPageURL": "https://www.amazon.com/dp/B08N5WRWNW...",
                "ItemInfo": {
                    "Title": {
                        "DisplayValue": "Apple iPhone 15 Pro Max (256 GB) - Natural Titanium"
                    },
                    "ByLineInfo": {
                        "Brand": {
                            "DisplayValue": "Apple"
                        },
                        "Manufacturer": {
                            "DisplayValue": "Apple Computer"
                        }
                    },
                    "Features": {
                        "DisplayValues": [
                            "6.7-inch Super Retina XDR display",
                            "A17 Pro chip"
                        ]
                    },
                    "ProductInfo": {
                        "Color": {
                            "DisplayValue": "Natural Titanium"
                        },
                        "Size": {
                            "DisplayValue": "256 GB"
                        }
                    }
                },
                "Images": {
                    "Primary": {
                        "Large": {
                            "URL": "https://m.media-amazon.com/images/...",
                            "Height": 500,
                            "Width": 500
                        }
                    },
                    "Variants": [...]
                },
                "Offers": {
                    "Listings": [
                        {
                            "Price": {
                                "DisplayAmount": "$1,199.00",
                                "Amount": 1199.00,
                                "Currency": "USD"
                            },
                            "SavingBasis": {
                                "Amount": 1199.00
                            }
                        }
                    ]
                },
                "CustomerReviews": {
                    "StarRating": {
                        "DisplayValue": "4.7",
                        "Value": 4.7
                    },
                    "Count": 15234
                }
            }
        ]
    }
}

import requests
import boto3
from botocore.auth import SigV4Auth
from botocore.awsrequest import AWSRequest
import json
# 配置
LWA_CLIENT_ID = 'YOUR_LWA_CLIENT_ID'
LWA_CLIENT_SECRET = 'YOUR_LWA_CLIENT_SECRET'
REFRESH_TOKEN = 'YOUR_REFRESH_TOKEN'
AWS_ACCESS_KEY = 'YOUR_AWS_ACCESS_KEY'
AWS_SECRET_KEY = 'YOUR_AWS_SECRET_KEY'
ROLE_ARN = 'YOUR_IAM_ROLE_ARN'  # 如使用 IAM Role
REGION = 'us-east-1'
MARKETPLACE_ID = 'ATVPDKIKX0DER'  # 美国站
def get_lwa_access_token():
    """获取 LWA Access Token"""
    url = 'https://api.amazon.com/auth/o2/token'
    payload = {
        'grant_type': 'refresh_token',
        'refresh_token': REFRESH_TOKEN,
        'client_id': LWA_CLIENT_ID,
        'client_secret': LWA_CLIENT_SECRET
    }
    response = requests.post(url, data=payload)
    return response.json()['access_token']
def get_catalog_item(asin, access_token):
    """
    调用 SP-API Catalog Items API 获取商品详情
    """
    endpoint = f'https://sellingpartnerapi-na.amazon.com/catalog/2022-04-01/items/{asin}'
    
    params = {
        'marketplaceIds': MARKETPLACE_ID,
        'includedData': 'images,price,description,attributes,salesRanks',
        'locale': 'en_US'
    }
    
    # 构建 AWS SigV4 签名请求
    request = AWSRequest(method='GET', url=endpoint, params=params)
    request.headers.add_header('x-amz-access-token', access_token)
    request.headers.add_header('x-amz-date', boto3.utils.datetime.datetime.utcnow().strftime('%Y%m%dT%H%M%SZ'))
    
    # 使用 boto3 的 SigV4Auth 签名
    credentials = boto3.Session(
        aws_access_key_id=AWS_ACCESS_KEY,
        aws_secret_access_key=AWS_SECRET_KEY,
        region_name=REGION
    ).get_credentials()
    
    sigv4 = SigV4Auth(credentials, 'execute-api', REGION)
    sigv4.add_auth(request)
    
    # 发送请求
    response = requests.get(endpoint, params=params, headers=dict(request.headers))
    
    if response.status_code == 200:
        return response.json()
    else:
        print(f"请求失败: {response.status_code}, {response.text}")
        return None
# 调用示例
token = get_lwa_access_token()
product = get_catalog_item('B08N5WRWNW', token)
print(json.dumps(product, indent=2))

{
    "asin": "B08N5WRWNW",
    "attributes": {
        "title": [{"value": "Apple iPhone 15 Pro Max (256 GB) - Natural Titanium"}],
        "brand": [{"value": "Apple"}],
        "bullet_point": [
            {"value": "6.7-inch Super Retina XDR display"},
            {"value": "A17 Pro chip with 6-core GPU"}
        ],
        "item_dimensions": [{
            "height": {"value": 6.33, "unit": "inches"},
            "width": {"value": 3.06, "unit": "inches"}
        }],
        "color": [{"value": "Natural Titanium"}],
        "size": [{"value": "256 GB"}]
    },
    "images": {
        "primary": {
            "large": {
                "url": "https://m.media-amazon.com/images/...",
                "height": 500,
                "width": 500
            }
        },
        "variants": [...]
    },
    "dimensions": [...],
    "productTypes": [...],
    "salesRanks": [
        {
            "marketplaceId": "ATVPDKIKX0DER",
            "classificationRanks": [
                {
                    "classificationId": "7072561011",
                    "title": "Cell Phones",
                    "link": "https://www.amazon.com/...",
                    "rank": 3
                }
            ]
        }
    ],
    "summaries": [...],
    "relationships": {
        "variations": [
            {
                "asin": "B0BSHF7WHW",
                "color": "Blue Titanium"
            }
        ]
    }
}

payload = {
    'ItemIds': ['B08N5WRWNW', 'B0BSHF7WHW', 'B0C...'],  # 最多 10 个
    'Resources': [...],
    'PartnerTag': PARTNER_TAG,
    'PartnerType': 'Associates',
    'Marketplace': 'www.amazon.com'
}
response = client.get_items(**payload)

payload = {
    'Keywords': 'wireless earbuds',
    'SearchIndex': 'Electronics',
    'ItemCount': 10,
    'Resources': [...],
    'PartnerTag': PARTNER_TAG,
    'PartnerType': 'Associates',
    'Marketplace': 'www.amazon.com'
}
response = client.search_items(**payload)