# 1007-App-Ratings & Reviews

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /app/rating-comment:
    post:
      summary: 1007-App-Ratings & Reviews
      deprecated: false
      description: >-
        Query app ratings and reviews (current rating, trends, review details,
        etc.).
      operationId: 1007_App_Ratings & Reviews
      tags:
        - II. List of Interfaces/1. application Services
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                appId:
                  type: string
                  description: App ID
                  examples:
                    - com.kiloo.subwaysurf
                store:
                  type: string
                  description: App Store
                  examples:
                    - GP
                region:
                  type: string
                  description: Country/Region
                  examples:
                    - US
                metrics:
                  type: string
                  description: Only one metric can be queried per request
                  examples:
                    - - REVIEWS
                type:
                  type: string
                  description: Review type; only applies to REVIEWS (optional)
                  examples:
                    - |-
                      AS：TIME（默认）, HELPFUL, HIGHEST, LOWEST
                      GP：TIME（默认）, HELPFUL
                star:
                  type: array
                  description: Star rating (reviews only)
                  examples:
                    - - 5
                reply:
                  type: boolean
                  description: Whether replied (reviews only)
                  examples:
                    - true
                deleted:
                  type: boolean
                  description: Review type (reviews only)
                  examples:
                    - true
                start:
                  type: string
                  description: Start Date
                  examples:
                    - '2025-09-26'
                end:
                  type: string
                  description: End Date
                  examples:
                    - '2025-09-28'
              required:
                - type
              x-apifox-orders:
                - appId
                - store
                - region
                - metrics
                - type
                - star
                - reply
                - deleted
                - start
                - end
              x-apifox-ignore-properties: []
            example:
              store: GP
              appId: com.kiloo.subwaysurf
              metrics:
                - REVIEWS
              deleted: true
              star:
                - 5
              region: US
              start: '2025-09-26'
              end: '2025-09-28'
              reply: true
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenApiBaseVOWanKaAppRatingVO'
              example:
                requestParam:
                  appId: com.kiloo.subwaysurf
                  region: US
                  metrics:
                    - RATING
                    - REVIEWS
                  start: '2025-09-26'
                  end: '2025-09-28'
                  star:
                    - 5
                  reply: true
                  deleted: true
                result:
                  appId: com.kiloo.subwaysurf
                  title: Subway Surfers
                  icon: >-
                    https://image2.foxdata.com/gp-proxy/FVWs-cooG28tz3GuKSaBKW_Rp91wLJxGxlmB9et_r-chKrjWpvXGxtRJWQi0QKithdM
                  rating:
                    - date: '2025-09-28'
                      num: 4.6
                      stars:
                        - star: 1
                          num: 2317318
                          per: 0.06
                        - star: 2
                          num: 699365
                          per: 0.02
                        - star: 3
                          num: 1482987
                          per: 0.04
                        - star: 4
                          num: 4431787
                          per: 0.11
                        - star: 5
                          num: 33186077
                          per: 0.79
                      records:
                        - star: 1
                          num: -70
                        - star: 2
                          num: -240
                        - star: 3
                          num: -274
                        - star: 4
                          num: -538
                        - star: 5
                          num: -161
                  reviews:
                    - star: 5
                      user: Binam Bajgain
                      content: nice game 🎮🎮🎮 nensssnns
                      date: 1758909150000
                      version: 3.52.2
                      deleted: true
                      reply:
                        content: >-
                          Hey Binam Bajgain! We're really happy to hear you
                          enjoy the game! If you have any specific feedback or
                          run into any issues, please reach out to our support
                          team at reviews@sybogames.com. Your insights are super
                          valuable to us! Thanks for being a part of our
                          community!
                        date: 1758910650000
                      helpfulCount: 0
                creditsCost:
                  requestCredits: 0
                  baseCredits: 12
                  extraCredits: 0
                  totalCostCredits: 12
                next:
                  taskId: c95097f2-a7d9-4883-9c70-a6858c4b7906
                  pageKey: '2'
          headers: {}
          x-apifox-name: Success
      security:
        - apikey-header-x-openapi-key: []
      x-apifox-folder: II. List of Interfaces/1. application Services
      x-apifox-status: released
      x-run-in-apifox: https://app.apifox.com/web/project/4128055/apis/api-478038408-run
components:
  schemas:
    OpenApiBaseVOWanKaAppRatingVO:
      type: object
      properties:
        requestParam:
          $ref: '#/components/schemas/WanKaAppRatingQuery'
          description: Your request param.
        result:
          $ref: '#/components/schemas/WanKaAppRatingVO'
          description: Your response.
        creditsCost:
          $ref: '#/components/schemas/OpenApiPointCostVO'
          description: Credits cost info.
        next:
          $ref: '#/components/schemas/PaginationInfo'
          description: Next page info
      x-apifox-orders:
        - requestParam
        - result
        - creditsCost
        - next
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    PaginationInfo:
      type: object
      properties:
        taskId:
          type: string
          description: Task ID
        pageKey:
          type: string
          description: Page Key
        totalCount:
          type: integer
          description: Total Count
          format: int64
        totalPages:
          type: integer
          description: Total Pages
          format: int64
      x-apifox-orders:
        - taskId
        - pageKey
        - totalCount
        - totalPages
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    OpenApiPointCostVO:
      type: object
      properties:
        requestCredits:
          type: integer
          description: ''
        baseCredits:
          type: integer
          description: ''
        extraCredits:
          type: integer
          description: ''
        totalCostCredits:
          type: integer
          description: ''
      x-apifox-orders:
        - requestCredits
        - baseCredits
        - extraCredits
        - totalCostCredits
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    WanKaAppRatingVO:
      type: object
      properties:
        appId:
          type: string
          description: ''
        title:
          type: string
          description: ''
        icon:
          type: string
          description: ''
        rating:
          type: array
          items:
            $ref: '#/components/schemas/RatingVO'
            description: com.xiaoxi.openapi.model.vo.wanka.WanKaAppRatingVO.RatingVO
          description: ''
        reviews:
          type: array
          items:
            $ref: '#/components/schemas/CommentDetail'
            description: com.xiaoxi.openapi.model.vo.wanka.WanKaAppRatingVO.CommentDetail
          description: ''
      x-apifox-orders:
        - appId
        - title
        - icon
        - rating
        - reviews
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    CommentDetail:
      type: object
      properties:
        title:
          type: string
          description: ''
        star:
          type: integer
          description: ''
        user:
          type: string
          description: ''
        content:
          type: string
          description: ''
        date:
          type: integer
          description: ''
          format: int64
        version:
          type: string
          description: ''
        deleted:
          type: boolean
          description: ''
        reply:
          $ref: '#/components/schemas/Replay'
          description: ''
        helpfulCount:
          type: integer
          description: ''
          format: int64
      x-apifox-orders:
        - title
        - star
        - user
        - content
        - date
        - version
        - deleted
        - reply
        - helpfulCount
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    Replay:
      type: object
      properties:
        content:
          type: string
          description: ''
        date:
          type: integer
          description: ''
          format: int64
      x-apifox-orders:
        - content
        - date
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    RatingVO:
      type: object
      properties:
        date:
          type: string
          description: ''
          x-apifox-mock: '@date'
        num:
          type: number
          description: ''
        stars:
          type: array
          items:
            $ref: '#/components/schemas/PieChartVO'
            description: com.xiaoxi.openapi.model.vo.wanka.WanKaAppRatingVO.PieChartVO
          description: ''
        records:
          type: array
          items:
            $ref: '#/components/schemas/RatingChangeVO'
            description: com.xiaoxi.openapi.model.vo.wanka.WanKaAppRatingVO.RatingChangeVO
          description: ''
      x-apifox-orders:
        - date
        - num
        - stars
        - records
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    RatingChangeVO:
      type: object
      properties:
        star:
          type: integer
          description: ''
        num:
          type: integer
          description: ''
      x-apifox-orders:
        - star
        - num
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    PieChartVO:
      type: object
      properties:
        star:
          type: integer
          description: ''
        num:
          type: integer
          description: ''
        per:
          type: number
          description: ''
      x-apifox-orders:
        - star
        - num
        - per
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    WanKaAppRatingQuery:
      type: object
      properties:
        store:
          type: string
          description: ''
          enum:
            - AS
            - GP
          x-apifox-enum:
            - value: AS
              name: AS
              description: AS
            - value: GP
              name: GP
              description: GP
          examples:
            - AS
        appId:
          type: string
          description: ''
          examples:
            - com.moye.shelter
        region:
          type: string
          description: ''
          examples:
            - US
        type:
          type: string
          description: ''
          enum:
            - TIME
            - HELPFUL
            - HIGHEST
            - LOWEST
          x-apifox-enum:
            - value: TIME
              name: TIME
              description: TIME
            - value: HELPFUL
              name: HELPFUL
              description: HELPFUL
            - value: HIGHEST
              name: HIGHEST
              description: HIGHEST
            - value: LOWEST
              name: LOWEST
              description: LOWEST
          examples:
            - |-
              AS：TIME（默认）, HELPFUL, HIGHEST, LOWEST
              GP：TIME（默认）, HELPFUL
        metrics:
          type: array
          items:
            type: string
            enum:
              - RATING
              - REVIEWS
            x-apifox-enum:
              - value: RATING
                name: RATING
                description: RATING
              - value: REVIEWS
                name: REVIEWS
                description: REVIEWS
          description: ''
          examples:
            - |-
              RATING：评分
              REVIEWS：评论
        start:
          type: string
          description: ''
          x-apifox-mock: '@date'
          examples:
            - |-
              开始事件和结束事件不传就是全量
              默认全量是查询最近1年的数据
        end:
          type: string
          description: ''
          x-apifox-mock: '@date'
          examples:
            - |-
              开始事件和结束事件不传就是全量
              默认全量是查询最近1年的数据
        star:
          type: array
          items:
            type: integer
          description: ''
          examples:
            - - 0（默认，全部）1，2，3，4，5
            - - 0（默认，全部）1，2，3，4，5
        reply:
          type: boolean
          description: ''
          examples:
            - false
        deleted:
          type: boolean
          description: ''
          examples:
            - false
      x-apifox-orders:
        - store
        - appId
        - region
        - type
        - metrics
        - start
        - end
        - star
        - reply
        - deleted
      required:
        - store
        - appId
        - metrics
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
  securitySchemes:
    apikey-header-x-openapi-key:
      type: apiKey
      in: header
      name: x-openapi-key
servers:
  - url: https://api.foxdata.com/apiv1/open-api
    description: Api Server
security:
  - apikey-header-x-openapi-key: []

```