亚马逊商品榜单列表(v32)

状态码	说明
-1	failed
0	success
400	参数错误
1001	账户余额不足
1002	邮箱/手机号或密码错误
1003	请求频率超过上限
1004	邮箱或手机号已注册
1005	无效的 API Key
1006	用户不存在
1007	登录凭证无效
1008	缺少 API Key
1009	手机或邮箱已存在
1010	需要管理员授权
1011	原密码错误
1012	新密码不能与原密码相同
1013	手机号和uid不能都为空
1014	请填写验证码
1015	验证码错误或已过期
1016	登录失败次数过多，请输入验证码
1017	请填写手机号
1018	请填写邮箱
1019	接口不存在，请检查
5000	服务暂时不可用，请稍后重试
5003	网络连接失败，请稍后重试
6001	修改密码失败，请稍后重试

JSON 关键字段说明

字段路径	示例值	说明
`data.items[].name`	`"Antarctic Star Countertop Ice Maker Machine..."`	商品名称
`data.items[].url`	`"https://www.amazon.com/dp/B0F42MT8JX"`	商品页地址
`data.items[].asin`	`"B0F42MT8JX"`	商品 ASIN
`data.items[].position`	`1`	榜单排名位置
`data.items[].price.value`	`37.19`	价格
`data.items[].price.currency`	`"$"`	货币符号
`data.items[].numberOfOffers`	`7`	卖家报价数（可为 null）
`data.items[].stars`	`4.1`	评分（可为 null）
`data.items[].reviewsCount`	`4113`	评论数（可为 null）
`data.items[].thumbnailUrl`	`"https://images-na.ssl-images-amazon.com/images/I/71-5YmYfsAL._AC_UL300_SR300,200_.jpg"`	缩略图地址
`data.items[].categoryName`	`"Appliances"`	类目名称
`data.items[].categoryFullName`	`"Best Sellers in Appliances"`	类目全称（畅销榜）
`data.items[].categoryUrl`	`"https://www.amazon.com/Best-Sellers-Appliances/zgbs/appliances/ref=zg_bs_nav_appliances_0"`	类目链接
`data.items[].subcategories[].categoryName`	`"Ice Makers"`	子类目名称
`data.items[].subcategories[].categoryUrl`	`"https://www.amazon.com/Best-Sellers-Appliances-Ice-Makers/zgbs/appliances/2399939011"`	子类目链接
`data.items[].input`	`"https://www.amazon.com/Best-Sellers-Appliances/zgbs/appliances/ref=zg_bs_nav_appliances_0"`	输入链接（原始请求）

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "cost": 8000,
        "balance": 725324,
        "items": [
            {
                "name": "Antarctic Star Countertop Ice Maker Machine, 26Lbs/Day Fastest 6‑Min Ice | 8 bullet ice in 6min, 2 sizes, energy-saving, portable handle, Self-Cleaning, basket/scoop for Home/bar/RV/camping. Black",
                "url": "https://www.amazon.com/dp/B0F42MT8JX",
                "asin": "B0F42MT8JX",
                "position": 1,
                "price": {
                    "value": 37.19,
                    "currency": "$"
                },
                "numberOfOffers": 7,
                "stars": 4.1,
                "reviewsCount": 4113,
                "thumbnailUrl": "https://images-na.ssl-images-amazon.com/images/I/71-5YmYfsAL._AC_UL300_SR300,200_.jpg",
                "categoryName": "Appliances",
                "categoryFullName": "Best Sellers in Appliances",
                "subcategories": [
                    {
                        "categoryName": "Appliance Warranties",
                        "categoryUrl": "https://www.amazon.com/Best-Sellers-Appliances-Home-Appliance-Warranties/zgbs/appliances/2242350011"
                    },
                    {
                        "categoryName": "Cooktops",
                        "categoryUrl": "https://www.amazon.com/Best-Sellers-Appliances-Cooktops/zgbs/appliances/3741261"
                    },
                    {
                        "categoryName": "Dishwashers",
                        "categoryUrl": "https://www.amazon.com/Best-Sellers-Appliances-Dishwashers/zgbs/appliances/3741271"
                    },
                    {
                        "categoryName": "Freezers",
                        "categoryUrl": "https://www.amazon.com/Best-Sellers-Appliances-Freezers/zgbs/appliances/3741331"
                    },
                    {
                        "categoryName": "Ice Makers",
                        "categoryUrl": "https://www.amazon.com/Best-Sellers-Appliances-Ice-Makers/zgbs/appliances/2399939011"
                    },
                    {
                        "categoryName": "Range Hoods",
                        "categoryUrl": "https://www.amazon.com/Best-Sellers-Appliances-Range-Hoods/zgbs/appliances/3741441"
                    },
                    {
                        "categoryName": "Ranges",
                        "categoryUrl": "https://www.amazon.com/Best-Sellers-Appliances-Ranges/zgbs/appliances/3741411"
                    },
                    {
                        "categoryName": "Refrigerators, Freezers & Ice Cube Makers",
                        "categoryUrl": "https://www.amazon.com/Best-Sellers-Appliances-Refrigerators-Freezers-Ice-Makers/zgbs/appliances/17921061011"
                    },
                    {
                        "categoryName": "Wall Ovens",
                        "categoryUrl": "https://www.amazon.com/Best-Sellers-Appliances-Wall-Ovens/zgbs/appliances/3741481"
                    },
                    {
                        "categoryName": "Warming Drawers",
                        "categoryUrl": "https://www.amazon.com/Best-Sellers-Appliances-Warming-Drawers/zgbs/appliances/2399955011"
                    },
                    {
                        "categoryName": "Washers & Dryers",
                        "categoryUrl": "https://www.amazon.com/Best-Sellers-Appliances-Washers-Dryers/zgbs/appliances/2383576011"
                    },
                    {
                        "categoryName": "Wine Cellars",
                        "categoryUrl": "https://www.amazon.com/Best-Sellers-Appliances-Wine-Cellars/zgbs/appliances/3741521"
                    }
                ],
                "categoryUrl": "https://www.amazon.com/Best-Sellers-Appliances/zgbs/appliances/ref=zg_bs_nav_appliances_0",
                "input": "https://www.amazon.com/Best-Sellers-Appliances/zgbs/appliances/ref=zg_bs_nav_appliances_0"
            },
            {
                "name": "EUHOMY Countertop Ice Maker Machine with Handle, 26.5lbs Per Day, 9 Ice Cubes Ready in 6 Mins, Auto-Cleaning Portable Ice Maker with Basket and Scoop, for Home/Kitchen/Camping/RV (Black)",
                "url": "https://www.amazon.com/dp/B0G1YCQT5Q",
                "asin": "B0G1YCQT5Q",
                "position": 2,
                "price": {
                    "value": 59.53,
                    "currency": "$"
                },
                "numberOfOffers": 2,
                "stars": 4.2,
                "reviewsCount": 16751,
                "thumbnailUrl": "https://images-na.ssl-images-amazon.com/images/I/61v0kBhe+LL._AC_UL300_SR300,200_.jpg",
                "categoryName": "Appliances",
                "categoryFullName": "Best Sellers in Appliances",
                "subcategories": [
                    {

亚马逊商品榜单列表(v32)

JSON 关键字段说明#

请求参数

请求示例代码

返回响应

JSON 关键字段说明