# 商品趋势(快照) - EchoTik

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /api/v3/echotik/product/trend:
    get:
      summary: 商品趋势(快照) - EchoTik
      deprecated: false
      description: >-
        **接口整体描述**

        这是商品历史趋势快照接口，按 `product_id` 返回最多 180 天的日级记录。返回里既有商品 SKU
        均价，也有总带货达人数、总直播场次、总视频数、总销量、总销售额，以及最近1天销量增量和最近1天销售额增量，所以它能回答商品是在稳卖、放量还是下滑。


        **接口用途推荐**

        - 适合做单品增长分析

        - 判断商品是不是最近起量

        - 看大促或投流前后销量与GMV变化、监控新品爬坡期，也适合做爆品复盘和预警

        相比商品详情，它更适合解释变化过程


        **注意事项**

        - 趋势/快照类接口最多支持近 180 天历史

        - 数据出自EchoTik，所以该数据均属于离线数据，会有延迟，如果接口返回没有数据证明EchoTik并未收录该数据
      tags:
        - 商品
      parameters:
        - name: product_id
          in: query
          description: 商品ID
          required: true
          schema:
            type: string
        - name: start_date
          in: query
          description: 日期范围筛选，yyyy-MM-dd格式
          required: true
          schema:
            type: string
        - name: end_date
          in: query
          description: 日期范围筛选，yyyy-MM-dd格式
          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:
                        dt:
                          type: string
                        product_id:
                          type: string
                          title: 商品ID
                        spu_avg_price:
                          type: number
                          title: 商品SKU均价
                        total_ifl_cnt:
                          type: integer
                          title: 总带货达人数
                        total_live_cnt:
                          type: integer
                          title: 总直播场次
                        total_sale_1d_cnt:
                          type: integer
                          title: 最近1天销量增量
                        total_sale_cnt:
                          type: integer
                          title: 总销量
                        total_sale_gmv_1d_amt:
                          type: integer
                          title: 最近1天销售额增量
                        total_sale_gmv_amt:
                          type: integer
                          title: 总销售额
                        total_video_cnt:
                          type: integer
                          title: 总视频数
                      x-apifox-orders:
                        - dt
                        - product_id
                        - spu_avg_price
                        - total_ifl_cnt
                        - total_live_cnt
                        - total_sale_1d_cnt
                        - total_sale_cnt
                        - total_sale_gmv_1d_amt
                        - total_sale_gmv_amt
                        - total_video_cnt
                      x-apifox-ignore-properties: []
                  requestId:
                    type: string
                x-apifox-orders:
                  - 01K8SZSBQECNNAFDH8PQ21SEJ6
                required:
                  - code
                  - message
                  - data
                  - requestId
                x-apifox-refs:
                  01K8SZSBQECNNAFDH8PQ21SEJ6:
                    $ref: >-
                      #/components/schemas/%E5%95%86%E5%93%81%E8%B6%8B%E5%8A%BF%EF%BC%88%E5%BF%AB%E7%85%A7%EF%BC%89
                x-apifox-ignore-properties:
                  - code
                  - message
                  - data
                  - requestId
          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-369131823-run
components:
  schemas:
    商品趋势（快照）:
      type: object
      properties:
        code:
          type: integer
        message:
          type: string
        data:
          type: array
          items:
            type: object
            properties:
              dt:
                type: string
              product_id:
                type: string
                title: 商品ID
              spu_avg_price:
                type: number
                title: 商品SKU均价
              total_ifl_cnt:
                type: integer
                title: 总带货达人数
              total_live_cnt:
                type: integer
                title: 总直播场次
              total_sale_1d_cnt:
                type: integer
                title: 最近1天销量增量
              total_sale_cnt:
                type: integer
                title: 总销量
              total_sale_gmv_1d_amt:
                type: integer
                title: 最近1天销售额增量
              total_sale_gmv_amt:
                type: integer
                title: 总销售额
              total_video_cnt:
                type: integer
                title: 总视频数
            x-apifox-orders:
              - dt
              - product_id
              - spu_avg_price
              - total_ifl_cnt
              - total_live_cnt
              - total_sale_1d_cnt
              - total_sale_cnt
              - total_sale_gmv_1d_amt
              - total_sale_gmv_amt
              - total_video_cnt
            x-apifox-ignore-properties: []
        requestId:
          type: string
      required:
        - code
        - message
        - data
        - requestId
      x-apifox-orders:
        - code
        - message
        - data
        - requestId
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
  securitySchemes:
    basic:
      type: http
      scheme: basic
servers:
  - url: ''
    description: 正式环境
security: []

```