# 视频榜单列表 - EchoTik ## OpenAPI Specification ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /api/v3/echotik/video/ranklist: get: summary: 视频榜单列表 - EchoTik deprecated: false description: >- **接口整体描述** 这是视频榜单接口，支持按日期、地区、商品一级类目、是否AI视频、榜单排序字段和榜单周期取排行榜。返回不仅有达人身份和视频基础信息，还会带带货商品分类、视频带货商品信息、评论点赞收藏分享、总播放、视频销量、视频销售额等结果，因此是看头部视频格局的周期榜。 **接口用途推荐** - 适合找热门带货视频 - 按周/月观察内容风向 - 研究 AI 视频在榜单里的占比、筛某个类目近期最强素材，也适合输出视频榜单周报 **注意事项** - 返回的封面、头像或图片地址如果不能直接访问，通常需要再走 EchoTik 图片下载相关接口 - 数据出自EchoTik，所以该数据均属于离线数据，会有延迟，如果接口返回没有数据证明EchoTik并未收录该数据 - 榜单中返回的值是当前周期中的增量数据 - date字段是yyyy-MM-dd格式， 榜单分为天/周/月 三个榜单， 周榜：每周周一， 月榜：每月一号。 - video_rank_field说明： video_rank_field=1代表热门榜， video_rank_field=2代表带货榜 tags: - 视频 parameters: - name: date in: query description: yyyy-MM-dd格式 榜单具体时间 required: true schema: type: string - name: region in: query description: 区域代码，地区，例如US required: true schema: type: string - name: product_category_id in: query description: 商品一级类目id筛选，用于带货视频榜单的商品分类筛选 required: false schema: type: string - name: product_category_l2_id in: query description: 商品二级类目id筛选 required: false schema: type: string - name: product_category_l3_id in: query description: 商品三级类目id筛选 required: false schema: type: string - name: created_by_ai in: query description: true / false， 是否AI视频 required: false schema: type: string - name: aweme_type in: query description: 内容类型， 150代表图文 required: false schema: type: integer - name: video_rank_field in: query description: 榜单排序字段 1=total_views_cnt 2=total_video_sale_cnt required: true schema: type: integer - name: rank_type in: query description: 榜单类型 1=day 2=week 3=month required: true schema: type: integer - 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: avatar: type: string title: 达人头像封面地址，如需访问请使用下载接口 category: type: string title: 达人分类 create_time: type: string title: 视频发布时间 duration: type: integer title: 视频时长 nick_name: type: string title: 昵称 product_category_list: type: string title: 带货商品分类信息 reflow_cover: type: string title: 视频封面地址，如需访问请使用下载接口 region: type: string title: 地区 sales_flag: type: integer title: 主要带货方式，0不带货，1视频带货 2直播带货 total_comments_cnt: type: integer title: 总评论量 total_digg_cnt: type: integer title: 总点赞量 total_favorites_cnt: type: integer title: 总收藏量 total_shares_cnt: type: integer title: 总分享量 total_video_sale_cnt: type: integer title: 视频销量（预估） total_video_sale_gmv_amt: type: integer title: 视频销售额（预估） total_views_cnt: type: integer title: 总播放量 unique_id: type: string title: tiktok ID user_id: type: string title: 达人ID video_desc: type: string title: 视频描述 video_id: type: string title: 视频ID video_products: type: string title: 视频带货商品信息 created_by_ai: type: string description: 是否AI视频 product_category_id: type: string description: 商品一级类目 product_category_l2_id: type: string description: 商品二级类目 product_category_l3_id: type: string description: 商品三级类目 x-apifox-orders: - avatar - category - create_time - duration - nick_name - product_category_list - reflow_cover - region - sales_flag - total_comments_cnt - total_digg_cnt - total_favorites_cnt - total_shares_cnt - total_video_sale_cnt - total_video_sale_gmv_amt - total_views_cnt - unique_id - user_id - video_desc - video_id - video_products - created_by_ai - product_category_id - product_category_l2_id - product_category_l3_id requestId: type: string x-apifox-orders: - code - message - data - requestId x-apifox-refs: {} required: - code - message - data - requestId example: code: 0 message: success data: - avatar: >- https://echosell-images.tos-ap-southeast-1.volces.com/user-avatar/853/MS4wLjABAAAAJN3v63JkTkZW72ae9hb2Wlb70uzhU8H3AZEKxIVTg38lwBGTx0tSNH7IBcrocdKd.jpg category: Other create_time: '1769838405' created_by_ai: 'false' duration: 15 nick_name: ﾌひﾚﾉの product_category_list: >- [{ "category_name":"Beauty & Personal Care","category_id":"601450"}] reflow_cover: >- https://echosell-images.tos-ap-southeast-1.volces.com/video-cover/422/7601397977986501919.jpg region: US sales_flag: 1 total_comments_cnt: 0 total_digg_cnt: 0 total_favorites_cnt: 0 total_shares_cnt: 0 total_video_sale_cnt: 5508 total_video_sale_gmv_amt: 44613 total_views_cnt: 0 unique_id: iamjuliocr user_id: '6633792625097490438' video_desc: >- W huzz magnet 🧲 #fyp #ttshopfinds #seasaltspray #level3 #barbertok video_id: '7601397977986501919' video_products: '[1729436418527695003]' product_category_id: '' product_category_l2_id: '' product_category_l3_id: '' requestId: b9ff3078-0b12-45b5-8b00-b7017ed18713 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-372721575-run components: schemas: {} securitySchemes: basic: type: http scheme: basic servers: - url: '' description: 正式环境 security: [] ```