查询产品表现

接口信息

请求参数

请求示例

{
    "offset": 0,
    "length": 20,
    "sort_field": "volume",
    "sort_type": "desc",
    "search_field": "asin",
    "search_value": ["B085M7NH7K"],
    "mid": 1,
    "sid": [1,109],
    "start_date": "2024-08-01",
    "end_date": "2024-08-07",
    "extend_search": [
        {
            "field": "volume",
            "from_value": "0",
            "to_value": "1000",
            "exp": "range"
        }
    ],
    "summary_field": "asin",
    "currency_code": "CNY",
    "is_recently_enum": true,
    "purchase_status": 0
}

返回结果

Json Object

返回成功示例

{
    "code": 0,
    "msg": "success",
    "trace_id": "bd1bdd39404d4f3d9fbeb1e1b51d597d.1723115595502",
    "data": {
        "total": 1,
        "list": [
            {
                "parent_asins": [
                    {
                        "amazon_url": "https://www.amazon.com/dp/B085M7NH7K",
                        "parent_asin": "B085M7NH7K",
                        "sid": "109"
                    }
                ],
                "asins": [
                    {
                        "amazon_url": "https://www.amazon.com/dp/B085M7NH7K",
                        "asin": "B085M7NH7K",
                        "sid": "109"
                    }
                ],
                "price_list": [
                    {
                        "country": "美国",
                        "is_eur": "0",
                        "local_sku": "Yajie003",
                        "mid": "1",
                        "local_name": "Yajie003",
                        "sid": "109",
                        "is_delete": "0",
                        "volume": "0",
                        "product_pic_url": "",
                        "small_image_url": "https://m.media-amazon.com/images/I/7196b5bK6PL._SL75_.jpg",
                        "seller_name": "篮球",
                        "price": "1349.00",
                        "seller_sku": "DEE-216",
                        "source_rate": 7.1,
                        "status": "0",
                        "cid": "0"
                    }
                ],
                "small_cate_rank": null,
                "item_name": "8P-SPEED Custom Car Floor Mats for Cadillac Coverage All Weather Protection Waterproof Non-Slip Leather Liner Set Wine",
                "sku": null,
                "local_name": null,
                "cate_rank": 0,
                "rank_category": null,
                "prev_cate_rank": 0,
                "currency_icon": "￥",
                "cg_price_currency_icon": "¥",
                "ranking_update_time": null,
                "seller_store_countries": [
                    {
                        "country": "美国",
                        "seller_name": "篮球"
                    }
                ],
                "categories": [],
                "brands": [],
                "principal_names": [
                    "超级管理员"
                ],
                "developer_names": [],
                "attributes": [],
                "month_stock_sales_ratio": null,
                "volume": 0,
                "b2b_volume": 0,
                "order_items": 0,
                "b2b_order_items": 0,
                "amount": "0.00",
                "b2b_amount": "0.00",
                "volume_chain_ratio": "0.0000",
                "amount_chain_ratio": "0.0000",
                "order_chain_ratio": "0.0000",
                "gross_profit": "0.00",
                "predict_gross_profit": "0.00",
                "gross_margin": "0.0000",
                "predict_gross_margin": "0.0000",
                "roi": "0.0000",
                "promotion_volume": 0,
                "promotion_amount": "0.00",
                "promotion_order_items": 0,
                "promotion_discount": "0.00",
                "reviews_count": 0,
                "return_count": 0,
                "return_rate": "0.0000",
                "afn_fulfillable_quantity": 0,
                "afn_inbound_receiving_quantity": 0,
                "afn_inbound_shipped_quantity": 0,
                "afn_inbound_working_quantity": 0,
                "afn_unsellable_quantity": 0,
                "afn_total_inbound": 0,
                "reserved_fc_processing": 0,
                "reserved_fc_transfers": 0,
                "reserved_customerorders": 0,
                "fbm_quantity": 0,
                "stock_up_num": 0,
                "clicks": 0,
                "available_days": 0,
                "fbm_available_days": 0,
                "avg_star": "0.0",
                "prev_star": "0.0",
                "comment_rate": null,
                "sessions": 0,
                "sessions_mobile": 0,
                "sessions_total": 0,
                "buy_box_percentage": null,
                "page_views": 0,
                "page_views_mobile": 0,
                "page_views_total": 0,
                "ad_direct_order_quantity": 0,
                "ad_direct_sales_amount": "0.00",
                "adv_rate": "0.0000",
                "volume_cvr": "0.0000",
                "cvr": "0.0000",
                "ctr": "0.0000",
                "acoas": "0.0000",
                "acos": "0.0000",
                "tacos": "0.0000",
                "has_oprator_log": null,
                "return_goods_count": 0,
                "fba_return_goods_count": 0,
                "fbm_return_goods_count": 0,
                "return_goods_rate": "0.0000",
                "fba_return_goods_rate": "0.0000",
                "fbm_return_goods_rate": "0.0000",
                "cpc": null,
                "spend": "0.00",
                "roas": "0.00",
                "asoas": "0.0000",
                "cpo": null,
                "cpm": null,
                "ad_sales_amount": "0.00",
                "ad_cvr": "0.0000",
                "ad_order_quantity": 0,
                "shared_cost_of_advertising": null,
                "shared_ads_sb_cost": "0.00",
                "shared_ads_sbv_cost": "0.00",
                "ads_sd_cost": "0.00",
                "ads_sp_cost": "0.00",
                "shared_ads_al_cost": "0.00",
                "shared_ads_cc_cost": "0.00",
                "shared_ads_sspaot_cost": "0.00",
                "shared_ads_sar_cost": "0.00",
                "impressions": 0,
                "sids": [
                    109
                ],
                "net_amount": "0.00",
                "small_image_url": "https://m.media-amazon.com/images/I/7196b5bK6PL._SL75_.jpg",
                "available_inventory": {
                    "afn_fulfillable_quantity": 0,
                    "stock_up_num": 0,
                    "reserved_customerorders": 0,
                    "reserved_fc_transfers": 0,
                    "afn_inbound_receiving_quantity": 0,
                    "available_inventory": 0,
                    "reserved_fc_processing": 0,
                    "fbm_quantity": 0
                },
                "avg_custom_price": null,
                "avg_volume": "0.0",
                "icon_num": 0,
                "spu_spu_names": [
                    {
                        "spu_name": "",
                        "spu": ""
                    }
                ],
                "product_create_time": null,
                "cg_price": null,
                "whs_value": null,
                "local_quantity": null,
                "oversea_quantity": null,
                "inventory_sales_ratio": "0.0000",
                "avg_landed_price": "1349.00",
                "suppliers": [],
                "model": [],
                "return_amount": 0.0,
                "tag_set": [
                    {
                        "global_tag_id": "907414919208862908",
                        "tag_name": "这是ASIN标签",
                        "color": "#C309DB"
                    },
                    {
                        "global_tag_id": "907430960946815077",
                        "tag_name": "测试002",
                        "color": "#00B51E"
                    },
                    {
                        "global_tag_id": "907430960946815082",
                        "tag_name": "使用api创建005",
                        "color": "#9C9CA0"
                    }
                ],
                "currency_code": "CNY",
                "volume_chain": 0,
                "amount_chain": "0.00",
                "order_items_chain": 0,
                "pids": null
            }
        ],
        "chain_start_date": "2024-07-25",
        "chain_end_date": "2024-07-31",
        "available_inventory_formula_zh": "FBA可售+FBM可售+待调仓+调仓中+待发货+入库中+实际在途"
    }
}

附加说明

限流算法说明(需要同时满足才不会被限流)：
1）、令牌桶容量是1；要求在调用时，需要串行调用，需要在上一次请求返回数据后，下次请求才不会被限流
2）、如果上次请求传入的是一个店铺，则 需要在1）的基础上间隔1s；如果上次请求传入的是多个店铺，则需要间隔10s
3）、summary_field为asin时，search_field不可为parent_asin。

特别注意：本接口按照 ( 账户 + path ) 维度进行限流, 一个账户下如存在多个appld, 本接口令牌桶容量是账号下所有appId共享的 ， 如果账号下所有appId调用总和超出令牌桶容量限制，将会导致限流。 建议同一账户下的不同 appId 错开调用时间。

字段说明
PV-Total、PV-Mobile、PV-Browser字段需要在asin维度或父asin维度才有值

唯一键说明

asin维度：asin+sid

父asin维度：parent_asin+sid

msku维度：seller_sku+sid

sku维度：sku+sid