# 类目趋势 - EchoTik

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /api/v3/echotik/category/trend:
    get:
      summary: 类目趋势 - EchoTik
      deprecated: false
      description: >-
        **接口整体描述**

        这是类目趋势接口，支持通过国家地区以及 1/2/3 级类目 ID
        获取该赛道的时间序列趋势。返回主要是类目在某个时间点的近1日销量和近1日销售额，并带 `category_id`
        与地区，用于观察赛道在时间维度上的销售变化。


        **接口用途推荐**

        - 适合做类目趋势监控

        - 对比不同细分类目近期表现

        - 判断某个类目是否在升温、做赛道周报和月报，也适合给选品团队做“先看赛道，再看商品”的前置分析


        **注意事项**

        - 数据出自EchoTik，所以该数据均属于离线数据，会有延迟

        - 付费接口，暂不提供免费试用调用
      tags:
        - 商品大盘
      parameters:
        - name: category_id
          in: query
          description: ''
          required: false
          schema:
            type: string
        - name: category_l2_id
          in: query
          description: ''
          required: false
          schema:
            type: string
        - name: category_l3_id
          in: query
          description: ''
          required: false
          schema:
            type: string
        - name: region
          in: query
          description: ''
          required: true
          example: US
          schema:
            type: string
        - name: start_date
          in: query
          description: yyyy-MM-dd格式，时间范围筛选
          required: true
          example: '2026-06-15'
          schema:
            type: string
        - name: end_date
          in: query
          description: yyyy-MM-dd格式，时间范围筛选
          required: true
          example: '2026-06-30'
          schema:
            type: string
        - name: page_num
          in: query
          description: ''
          required: true
          example: 1
          schema:
            type: integer
        - name: page_size
          in: query
          description: ''
          required: true
          example: 10
          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
                        category_l2_id:
                          type: string
                        category_l3_id:
                          type: string
                        dt:
                          type: string
                        priority_region:
                          type: string
                        total_sale_1d_cnt:
                          type: integer
                          description: 近1日销量
                        total_sale_gmv_1d_amt:
                          type: number
                          description: 近1日销售额
                      x-apifox-orders:
                        - category_id
                        - category_l2_id
                        - category_l3_id
                        - dt
                        - priority_region
                        - total_sale_1d_cnt
                        - total_sale_gmv_1d_amt
                  requestId:
                    type: string
                required:
                  - code
                  - message
                  - data
                  - requestId
                x-apifox-orders:
                  - code
                  - message
                  - data
                  - requestId
              example:
                code: 0
                message: success
                data:
                  - category_id: '601450'
                    category_l2_id: '1086856'
                    category_l3_id: '1004680'
                    dt: '2026-06-15'
                    priority_region: US
                    total_sale_1d_cnt: 674
                    total_sale_gmv_1d_amt: 10438.67
                requestId: 48ef66ca-071b-4052-9ba7-ac8bbefd3a73
          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-482865001-run
components:
  schemas: {}
  securitySchemes:
    basic:
      type: http
      scheme: basic
servers:
  - url: ''
    description: 正式环境
security: []

```