# 商品列表 - EchoTik ## OpenAPI Specification ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /api/v3/echotik/product/list: get: summary: 商品列表 - EchoTik deprecated: false description: >- **接口整体描述** 这是 EchoTik 的离线商品检索库，参数维度非常完整。它支持按一级/二级/三级类目、近7天销售趋势、总销量、近30天销量、SKU均价、佣金率、带货达人数、带货视频数、带货视频播放量、评分、评论数、是否全托管、是否包邮、总GMV、近30天GMV、首次抓取时间、带货方式、是否在售、店铺类型、是否爆款、是否品牌店、地区等筛选，并通过 `product_sort_field` 和 `sort_type` 排序；返回里则覆盖商品价格、评分、评论量、销量、GMV、直播/视频/达人关联规模等关键经营字段。 **接口用途推荐** - 适合做大规模选品 - 竞品池构建 - 按价格带和佣金率找可投品 - 发现高销量高GMV商品 - 找某个类目里最近上涨的商品，也适合给达人招商、联盟投放和店铺运营团队做选品中台 这个接口的价值在于筛选维度多，适合先广撒网，再用详情或趋势接口看深 **注意事项** - T+1 更新 - 返回的封面、头像或图片地址如果不能直接访问，通常需要再走 EchoTik 图片下载相关接口 - 数据出自EchoTik，所以该数据均属于离线数据，会有延迟，如果接口返回没有数据证明EchoTik并未收录该数据 tags: - 商品 parameters: - name: category_id in: query description: 商品一级分类ID required: false schema: type: string - name: category_l2_id in: query description: 商品二级分类ID required: false schema: type: string - name: category_l3_id in: query description: 商品三级分类ID required: false schema: type: string - name: sales_trend_flag in: query description: 近7天销售趋势， 0=平稳 1=上升 2=下降 required: false schema: type: integer - name: min_total_sale_cnt in: query description: 总销量范围筛选 required: false schema: type: integer - name: max_total_sale_cnt in: query description: 总销量范围筛选 required: false schema: type: integer - name: min_total_sale_30d_cnt in: query description: 最近30天销量范围筛选 required: false schema: type: integer - name: max_total_sale_30d_cnt in: query description: 最近30天销量范围筛选 required: false schema: type: integer - name: min_spu_avg_price in: query description: 商品sku均价范围筛选 required: false schema: type: number - name: max_spu_avg_price in: query description: 商品sku均价范围筛选 required: false schema: type: number - name: min_product_commission_rate in: query description: 商品佣金率范围筛选 required: false schema: type: number - name: max_product_commission_rate in: query description: 商品佣金率范围筛选 required: false schema: type: number - name: min_total_ifl_cnt in: query description: 带货达人数范围筛选 required: false schema: type: integer - name: max_total_ifl_cnt in: query description: 带货达人数范围筛选 required: false schema: type: integer - name: min_total_video_cnt in: query description: 带货视频数范围筛选 required: false schema: type: integer - name: max_total_video_cnt in: query description: 带货视频数范围筛选 required: false schema: type: integer - name: min_total_views_cnt in: query description: 带货视频的播放量范围筛选 required: false schema: type: integer - name: max_total_views_cnt in: query description: 带货视频的播放量范围筛选 required: false schema: type: integer - name: min_product_rating in: query description: 商品评价分范围筛选 required: false schema: type: number - name: max_product_rating in: query description: 商品评价分范围筛选 required: false schema: type: number - name: min_review_count in: query description: 商品评论数范围筛选 required: false schema: type: integer - name: max_review_count in: query description: 商品评论数范围筛选 required: false schema: type: integer - name: is_s_shop in: query description: 是否全托管，0=否 1=全托管 required: false schema: type: integer - name: free_shipping in: query description: 是否包邮，0=否 1=是 required: false schema: type: integer - name: min_total_sale_gmv_amt in: query description: 总GMV范围筛选 required: false schema: type: number - name: max_total_sale_gmv_amt in: query description: 总GMV范围筛选 required: false schema: type: number - name: min_total_sale_gmv_30d_amt in: query description: 最近30天GMV范围筛选 required: false schema: type: number - name: max_total_sale_gmv_30d_amt in: query description: 最近30天GMV范围筛选 required: false schema: type: number - name: min_first_crawl_dt in: query description: 商品首次抓取时间范围时间，格式yyyyMMdd required: false schema: type: integer - name: max_first_crawl_dt in: query description: 商品首次抓取时间范围时间，格式yyyyMMdd required: false schema: type: integer - name: sales_flag in: query description: 带货方式，1=视频带货 2=直播带货 required: false schema: type: integer - name: product_sort_field in: query description: >- 列表排序枚举，1=total_sale_cnt 2=total_sale_gmv_amt 3=spu_avg_price 4=total_sale_7d_cnt 5=total_sale_30d_cnt 6=total_sale_gmv_7d_amt 7=total_sale_gmv_30d_amt required: false schema: type: integer - name: sort_type in: query description: 排序顺序，排序顺序 0=asc 1=desc required: false schema: type: integer - name: off_mark in: query description: off_mark=0代表在售商品，可过滤掉已下架商品 required: false schema: type: integer - name: from_flag in: query description: 店铺类型，本土店=1，跨境店=2 required: false schema: type: integer - name: is_hot in: query description: 是否爆款商品， 0=否， 1=是 required: false schema: type: integer - name: shop_type in: query description: 是否品牌店， 0=否， 1=是 required: false schema: type: integer - name: region in: query description: 区域代码，地区，例如US required: true schema: type: string - name: page_num in: query description: 分页页码，从1开始，最大100000 required: true schema: type: integer - name: page_size in: query description: 分页页数，最大等于10 required: true schema: type: integer responses: '200': description: '' content: application/json: schema: type: object properties: code: type: integer message: type: string data: type: array items: type: object properties: category_id: type: string title: 一级分类ID category_l2_id: type: string title: 二级分类ID category_l3_id: type: string title: 三级分类ID cover_url: type: string title: 封面地址 如果访问没权限请使用图片下载接口 desc_detail: type: string title: 商品描述 discount: type: string title: 折扣 first_crawl_dt: type: integer title: 首次抓取时间 free_shipping: type: integer title: 是否包邮 1=是 0=否 is_s_shop: type: integer title: 是否全托管店铺 1=是 0=否 max_price: type: number title: 最高sku价格 min_price: type: number title: 最低sku价格 off_mark: type: integer title: 下架标识， <2代表未下架 product_commission_rate: type: integer title: 商品佣金 product_id: type: string title: 商品ID product_name: type: string title: 商品名称 product_rating: type: integer title: 商品评分 region: type: string title: 区域 review_count: type: integer title: 评论数 sale_props: type: string title: 商品属性 sales_flag: type: integer title: 带货标识 1=视频 2=直播 sales_trend_flag: type: integer title: 近7天销售趋势， 0=平稳 1=上升 2=下降 seller_id: type: string title: 小店ID skus: type: string title: 商品规格 spu_avg_price: type: number title: 商品sku均价 total_ifl_cnt: type: integer title: 总带货达人数 total_ifl_live_15d_cnt: type: integer title: 最近15天直播带货达人增量 total_ifl_live_1d_cnt: type: integer title: 最近1天直播带货达人增量 total_ifl_live_30d_cnt: type: integer title: 最近30天直播带货达人增量 total_ifl_live_60d_cnt: type: integer title: 最近60天直播带货达人增量 total_ifl_live_7d_cnt: type: integer title: 最近7天直播带货达人增量 total_ifl_live_90d_cnt: type: integer title: 最近90天直播带货达人增量 total_ifl_video_15d_cnt: type: integer title: 最近15天视频带货达人增量 total_ifl_video_1d_cnt: type: integer title: 最近1天视频带货达人增量 total_ifl_video_30d_cnt: type: integer title: 最近30天视频带货达人增量 total_ifl_video_60d_cnt: type: integer title: 最近60天视频带货达人增量 total_ifl_video_7d_cnt: type: integer title: 最近7天视频带货达人增量 total_ifl_video_90d_cnt: type: integer title: 最近90天视频带货达人增量 total_live_15d_cnt: type: integer title: 最近15天直播场次 total_live_1d_cnt: type: integer title: 最近1天直播场次 total_live_30d_cnt: type: integer title: 最近30天直播场次 total_live_60d_cnt: type: integer title: 最近60天直播场次 total_live_7d_cnt: type: integer title: 最近7天直播场次 total_live_90d_cnt: type: integer title: 最近90天直播场次 total_live_cnt: type: integer title: 总直播场次 total_live_sale_15d_cnt: type: integer title: 最近15天直播销量 total_live_sale_1d_cnt: type: integer title: 最近1天直播销量 total_live_sale_30d_cnt: type: integer title: 最近30天直播销量 total_live_sale_60d_cnt: type: integer title: 最近60天直播销量 total_live_sale_7d_cnt: type: integer title: 最近7天直播销量 total_live_sale_90d_cnt: type: integer title: 最近90天直播销量 total_live_sale_cnt: type: integer title: 总直播销量 total_live_sale_gmv_15d_amt: type: integer title: 最近15天直播GMV total_live_sale_gmv_1d_amt: type: integer title: 最近1天直播GMV total_live_sale_gmv_30d_amt: type: integer title: 最近30天直播GMV total_live_sale_gmv_60d_amt: type: integer title: 最近60天直播GMV total_live_sale_gmv_7d_amt: type: integer title: 最近7天直播GMV total_live_sale_gmv_90d_amt: type: integer title: 最近90天直播GMV total_live_sale_gmv_amt: type: integer title: 总直播GMV total_sale_15d_cnt: type: integer title: 最近15日销量增量 total_sale_1d_cnt: type: integer title: 最近1日销量增量 total_sale_30d_cnt: type: integer title: 最近30日销量增量 total_sale_60d_cnt: type: integer title: 最近60日销量增量 total_sale_7d_cnt: type: integer title: 最近7日销量增量 total_sale_90d_cnt: type: integer title: 最近90日销量增量 total_sale_cnt: type: integer title: 总销量 total_sale_gmv_15d_amt: type: integer title: 最近15日销售额增量 total_sale_gmv_1d_amt: type: integer title: 最近1日销售额增量 total_sale_gmv_30d_amt: type: integer title: 最近30日销售额增量 total_sale_gmv_60d_amt: type: integer title: 最近60日销售额增量 total_sale_gmv_7d_amt: type: integer title: 最近7日销售额增量 total_sale_gmv_90d_amt: type: integer title: 最近90日销售额增量 total_sale_gmv_amt: type: integer title: 总销售额 total_video_15d_cnt: type: integer title: 最近15日新增视频数 total_video_1d_cnt: type: integer title: 最近1日新增视频数 total_video_30d_cnt: type: integer title: 最近30日新增视频数 total_video_60d_cnt: type: integer title: 最近60日新增视频数 total_video_7d_cnt: type: integer title: 最近7日新增视频数 total_video_90d_cnt: type: integer title: 最近90日新增视频数 total_video_cnt: type: integer title: 总视频数 total_video_sale_15d_cnt: type: integer title: 最近15日视频销量增量 total_video_sale_1d_cnt: type: integer title: 最近1日视频销量增量 total_video_sale_30d_cnt: type: integer title: 最近30日视频销量增量 total_video_sale_60d_cnt: type: integer title: 最近60日视频销量增量 total_video_sale_7d_cnt: type: integer title: 最近7日视频销量增量 total_video_sale_90d_cnt: type: integer title: 最近90日视频销量增量 total_video_sale_cnt: type: integer title: 总视频销量 total_video_sale_gmv_15d_amt: type: integer title: 最近15日视频销售额增量 total_video_sale_gmv_1d_amt: type: integer title: 最近1日视频销售额增量 total_video_sale_gmv_30d_amt: type: integer title: 最近30日视频销售额增量 total_video_sale_gmv_60d_amt: type: integer title: 最近60日视频销售额增量 total_video_sale_gmv_7d_amt: type: integer title: 最近7日视频销售额增量 total_video_sale_gmv_90d_amt: type: integer title: 最近90日视频销售额增量 total_video_sale_gmv_amt: type: integer title: 总视频销售额 total_views_15d_cnt: type: integer title: 最近15日视频播放量增量 total_views_1d_cnt: type: integer title: 最近1日视频播放量增量 total_views_30d_cnt: type: integer title: 最近30日视频播放量增量 total_views_60d_cnt: type: integer title: 最近60日视频播放量增量 total_views_7d_cnt: type: integer title: 最近7日视频播放量增量 total_views_90d_cnt: type: integer title: 最近90日视频播放量增量 total_views_cnt: type: integer title: 总最近30日视频播放量 specification: type: string from_flag: type: integer is_hot: type: integer shop_type: type: integer shipping_price: type: string x-apifox-orders: - category_id - category_l2_id - category_l3_id - cover_url - desc_detail - discount - first_crawl_dt - free_shipping - is_s_shop - max_price - min_price - off_mark - product_commission_rate - product_id - product_name - product_rating - region - review_count - sale_props - sales_flag - sales_trend_flag - seller_id - skus - spu_avg_price - total_ifl_cnt - total_ifl_live_15d_cnt - total_ifl_live_1d_cnt - total_ifl_live_30d_cnt - total_ifl_live_60d_cnt - total_ifl_live_7d_cnt - total_ifl_live_90d_cnt - total_ifl_video_15d_cnt - total_ifl_video_1d_cnt - total_ifl_video_30d_cnt - total_ifl_video_60d_cnt - total_ifl_video_7d_cnt - total_ifl_video_90d_cnt - total_live_15d_cnt - total_live_1d_cnt - total_live_30d_cnt - total_live_60d_cnt - total_live_7d_cnt - total_live_90d_cnt - total_live_cnt - total_live_sale_15d_cnt - total_live_sale_1d_cnt - total_live_sale_30d_cnt - total_live_sale_60d_cnt - total_live_sale_7d_cnt - total_live_sale_90d_cnt - total_live_sale_cnt - total_live_sale_gmv_15d_amt - total_live_sale_gmv_1d_amt - total_live_sale_gmv_30d_amt - total_live_sale_gmv_60d_amt - total_live_sale_gmv_7d_amt - total_live_sale_gmv_90d_amt - total_live_sale_gmv_amt - total_sale_15d_cnt - total_sale_1d_cnt - total_sale_30d_cnt - total_sale_60d_cnt - total_sale_7d_cnt - total_sale_90d_cnt - total_sale_cnt - total_sale_gmv_15d_amt - total_sale_gmv_1d_amt - total_sale_gmv_30d_amt - total_sale_gmv_60d_amt - total_sale_gmv_7d_amt - total_sale_gmv_90d_amt - total_sale_gmv_amt - total_video_15d_cnt - total_video_1d_cnt - total_video_30d_cnt - total_video_60d_cnt - total_video_7d_cnt - total_video_90d_cnt - total_video_cnt - total_video_sale_15d_cnt - total_video_sale_1d_cnt - total_video_sale_30d_cnt - total_video_sale_60d_cnt - total_video_sale_7d_cnt - total_video_sale_90d_cnt - total_video_sale_cnt - total_video_sale_gmv_15d_amt - total_video_sale_gmv_1d_amt - total_video_sale_gmv_30d_amt - total_video_sale_gmv_60d_amt - total_video_sale_gmv_7d_amt - total_video_sale_gmv_90d_amt - total_video_sale_gmv_amt - total_views_15d_cnt - total_views_1d_cnt - total_views_30d_cnt - total_views_60d_cnt - total_views_7d_cnt - total_views_90d_cnt - total_views_cnt - specification - from_flag - is_hot - shop_type - shipping_price requestId: type: string x-apifox-orders: - code - message - data - requestId x-apifox-refs: {} required: - code - message - data - requestId example: code: 0 message: success data: - category_id: '600001' category_l2_id: '852488' category_l3_id: '855432' cover_url: >- [{ "url":"https://echosell-images.tos-ap-southeast-1.volces.com/product-cover/63/1729383860892963304_0.jpeg","index":0}] desc_detail: >- [{"type":"text","text":"Light Pink Baby Elephant with Rose Foam Board Cut Out for Baby Shower, Gender Reveal Baby Announcement Centerpiece or Back Drop"},{"type":"text","text":"The foam board cut out comes in 3 sizes:"},{"type":"text","text":"20""},{"type":"text","text":"24""},{"type":"text","text":"30""},{"type":"text","text":"36""},{"type":"text","text":" "},{"type":"text","text":"Check out our easel back listing, if you need to stand your cut out:"}] discount: '' first_crawl_dt: 20230614 free_shipping: 0 from_flag: 1 is_hot: 0 is_s_shop: 0 last_crawl_dt: 20240803 max_price: 83 min_price: 30 off_mark: 3 product_commission_rate: 0 product_id: '1729383860892963304' product_name: >- Light Pink Baby Elephant with Rose Foam Board Cut Out for Baby Shower, Gender Reveal Baby Announcement Centerpiece or Back Drop product_rating: 0 region: US review_count: 0 sale_props: >- [{"prop_name":"Specification","has_image":"true","prop_id":"100089","sale_prop_values":[{"image":"https://p16-oec-ttp.tiktokcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/969b19ffdf7041bdbf017c97bcc80bfb~tplv-omjb5zjo8w-resize-jpeg:800:800.jpeg?from=1826719393","prop_value_id":"7177793166140393262","prop_value":"20\""},{"image":"https://p19-oec-ttp.tiktokcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/d1089c6ef2dd45a7a695cdb1945997be~tplv-omjb5zjo8w-resize-jpeg:800:800.jpeg?from=1826719393","prop_value_id":"7177793166140426030","prop_value":"24\""},{"image":"https://p19-oec-ttp.tiktokcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/d8266e34ee024d419c36ceaa3b7fdafc~tplv-omjb5zjo8w-resize-jpeg:800:800.jpeg?from=1826719393","prop_value_id":"7177793166140458798","prop_value":"30\""},{"image":"https://p19-oec-ttp.tiktokcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/5806818a3e8c4aa2a2eb03826fc11c62~tplv-omjb5zjo8w-resize-jpeg:800:800.jpeg?from=1826719393","prop_value_id":"7177793166140491566","prop_value":"36\""}]}] sales_flag: 0 sales_trend_flag: 0 seller_id: '7494831765943781864' shipping_price: '0' shop_type: 0 skus: >- [{"sku_id":"1729383867604898280","sale_prop_value_ids":"7177793166140393262","real_price":{"price_str":"$30.00","price_val":"30","currency":"USD"}},{"sku_id":"1729383867604963816","sale_prop_value_ids":"7177793166140426030","real_price":{"price_str":"$36.00","price_val":"36","currency":"USD"}},{"sku_id":"1729383867605029352","sale_prop_value_ids":"7177793166140458798","real_price":{"price_str":"$42.00","price_val":"42","currency":"USD"}},{"sku_id":"1729383867605094888","sale_prop_value_ids":"7177793166140491566","real_price":{"price_str":"$83.00","price_val":"83","currency":"USD"}}] specification: '[]' spu_avg_price: 47.75 total_ifl_cnt: 0 total_ifl_live_15d_cnt: 0 total_ifl_live_1d_cnt: 0 total_ifl_live_30d_cnt: 0 total_ifl_live_60d_cnt: 0 total_ifl_live_7d_cnt: 0 total_ifl_live_90d_cnt: 0 total_ifl_video_15d_cnt: 0 total_ifl_video_1d_cnt: 0 total_ifl_video_30d_cnt: 0 total_ifl_video_60d_cnt: 0 total_ifl_video_7d_cnt: 0 total_ifl_video_90d_cnt: 0 total_live_15d_cnt: 0 total_live_1d_cnt: 0 total_live_30d_cnt: 0 total_live_60d_cnt: 0 total_live_7d_cnt: 0 total_live_90d_cnt: 0 total_live_cnt: 0 total_live_sale_15d_cnt: 0 total_live_sale_1d_cnt: 0 total_live_sale_30d_cnt: 0 total_live_sale_60d_cnt: 0 total_live_sale_7d_cnt: 0 total_live_sale_90d_cnt: 0 total_live_sale_cnt: 0 total_live_sale_gmv_15d_amt: 0 total_live_sale_gmv_1d_amt: 0 total_live_sale_gmv_30d_amt: 0 total_live_sale_gmv_60d_amt: 0 total_live_sale_gmv_7d_amt: 0 total_live_sale_gmv_90d_amt: 0 total_live_sale_gmv_amt: 0 total_sale_15d_cnt: 0 total_sale_1d_cnt: 0 total_sale_30d_cnt: 0 total_sale_60d_cnt: 0 total_sale_7d_cnt: 0 total_sale_90d_cnt: 0 total_sale_cnt: 0 total_sale_gmv_15d_amt: 0 total_sale_gmv_1d_amt: 0 total_sale_gmv_30d_amt: 0 total_sale_gmv_60d_amt: 0 total_sale_gmv_7d_amt: 0 total_sale_gmv_90d_amt: 0 total_sale_gmv_amt: 0 total_video_15d_cnt: 0 total_video_1d_cnt: 0 total_video_30d_cnt: 0 total_video_60d_cnt: 0 total_video_7d_cnt: 0 total_video_90d_cnt: 0 total_video_cnt: 0 total_video_sale_15d_cnt: 0 total_video_sale_1d_cnt: 0 total_video_sale_30d_cnt: 0 total_video_sale_60d_cnt: 0 total_video_sale_7d_cnt: 0 total_video_sale_90d_cnt: 0 total_video_sale_cnt: 0 total_video_sale_gmv_15d_amt: 0 total_video_sale_gmv_1d_amt: 0 total_video_sale_gmv_30d_amt: 0 total_video_sale_gmv_60d_amt: 0 total_video_sale_gmv_7d_amt: 0 total_video_sale_gmv_90d_amt: 0 total_video_sale_gmv_amt: 0 total_views_15d_cnt: 0 total_views_1d_cnt: 0 total_views_30d_cnt: 0 total_views_60d_cnt: 0 total_views_7d_cnt: 0 total_views_90d_cnt: 0 total_views_cnt: 0 requestId: 5c2f367b-72d7-4a86-9d9a-332b20b99c6d headers: {} x-apifox-name: 成功 security: - basic: [] x-apifox-folder: 商品 x-apifox-status: released x-run-in-apifox: https://app.apifox.com/web/project/7319100/apis/api-369082708-run components: schemas: {} securitySchemes: basic: type: http scheme: basic servers: - url: '' description: 正式环境 security: [] ```