# 2001-Market-Realtime Charts

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /ranking/realtime:
    post:
      summary: 2001-Market-Realtime Charts
      deprecated: false
      description: Query app store chart rankings across countries and categories.
      operationId: 2001_Market_Realtime Charts
      tags:
        - II. List of Interfaces/2. Market Services
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                region:
                  type: string
                  description: Country/Region
                  examples:
                    - US
                store:
                  type: string
                  description: App Store
                  examples:
                    - AS
                device:
                  type: string
                  description: AS apps only
                  examples:
                    - IPAD
                category:
                  type: string
                  description: Chart Category
                  examples:
                    - '-1'
                start:
                  type: string
                  description: Start Date
                  examples:
                    - '2025-09-19'
                end:
                  type: string
                  description: End Date
                  examples:
                    - '2025-09-20'
              x-apifox-orders:
                - region
                - store
                - device
                - category
                - start
                - end
              x-apifox-ignore-properties: []
            example:
              region: US
              store: AS
              device: IPAD
              category: '-1'
              start: '2025-09-19'
              end: '2025-09-20'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenApiBaseVOListWankaRankingVO'
              example:
                requestParam:
                  region: US
                  store: AS
                  device: IPAD
                  category: '-1'
                  start: '2025-09-19'
                  end: '2025-09-20'
                result:
                  - region: US
                    store: AS
                    device: IPAD
                    category: '-1'
                    date: '2025-09-20'
                    charts:
                      - rankType: FREE
                        apps:
                          - appId: '545519333'
                            icon: >-
                              https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/b5/67/d8/b567d87b-e9f9-d217-875a-22cc52cfc704/AppIcon-0-0-1x_U007epad-0-1-0-0-85-220.png/88x88w.png
                            title: Amazon Prime Video
                            rank: 1
                            change: 0
                      - rankType: PAID
                        apps:
                          - appId: '479516143'
                            icon: >-
                              https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/48/d0/37/48d0370e-cc6c-f1e2-1d36-6322809ba598/AppIcon-0-0-1x_U007emarketing-0-10-0-85-220.png/88x88w.png
                            title: 'Minecraft: Dream it, Build it!'
                            rank: 1
                            change: 1
                      - rankType: TOP_GROSSING
                        apps:
                          - appId: '544007664'
                            icon: >-
                              https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/bc/ff/e5/bcffe5f4-c5cd-ea33-d747-9f1acda1e084/logo_youtube_2024_q4_color-0-1x_U007emarketing-0-0-0-7-0-0-0-85-220-0.png/88x88w.png
                            title: YouTube
                            rank: 1
                            change: 0
                creditsCost:
                  requestCredits: 0
                  baseCredits: 20
                  extraCredits: 0
                  totalCostCredits: 20
                next: null
          headers: {}
          x-apifox-name: ''
      security:
        - apikey-header-x-openapi-key: []
      x-apifox-folder: II. List of Interfaces/2. Market Services
      x-apifox-status: released
      x-run-in-apifox: https://app.apifox.com/web/project/4128055/apis/api-478038425-run
components:
  schemas:
    OpenApiBaseVOListWankaRankingVO:
      type: object
      properties:
        requestParam:
          $ref: '#/components/schemas/WankaRankingQuery'
          description: Your request param.
        result:
          type: array
          items:
            $ref: '#/components/schemas/WankaRankingVO'
            description: com.xiaoxi.openapi.model.vo.wanka.WankaRankingVO
          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: ''
    WankaRankingVO:
      type: object
      properties:
        region:
          type: string
          description: ''
        store:
          type: string
          description: ''
          enum:
            - AS
            - GP
          x-apifox-enum:
            - value: AS
              name: AS
              description: AS
            - value: GP
              name: GP
              description: GP
        device:
          type: string
          description: ''
          enum:
            - IPHONE
            - IPAD
          x-apifox-enum:
            - value: IPHONE
              name: IPHONE
              description: IPHONE
            - value: IPAD
              name: IPAD
              description: IPAD
        category:
          type: string
          description: ''
        date:
          type: string
          description: ''
          x-apifox-mock: '@date'
        charts:
          type: array
          items:
            $ref: '#/components/schemas/RankingVO'
            description: com.xiaoxi.openapi.model.vo.wanka.WankaRankingVO.RankingVO
          description: ''
      x-apifox-orders:
        - region
        - store
        - device
        - category
        - date
        - charts
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    RankingVO:
      type: object
      properties:
        rankType:
          type: string
          description: ''
        apps:
          type: array
          items:
            $ref: '#/components/schemas/RankingAppVO'
            description: com.xiaoxi.openapi.model.vo.wanka.WankaRankingVO.RankingAppVO
          description: ''
      x-apifox-orders:
        - rankType
        - apps
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    RankingAppVO:
      type: object
      properties:
        appId:
          type: string
          description: ''
        icon:
          type: string
          description: ''
        title:
          type: string
          description: ''
        rank:
          type: integer
          description: ''
        change:
          type: integer
          description: ''
      x-apifox-orders:
        - appId
        - icon
        - title
        - rank
        - change
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    WankaRankingQuery:
      type: object
      properties:
        region:
          type: string
          description: ''
          examples:
            - US
        store:
          type: string
          description: ''
          enum:
            - AS
            - GP
          x-apifox-enum:
            - value: AS
              name: AS
              description: AS
            - value: GP
              name: GP
              description: GP
          examples:
            - AS
        device:
          type: string
          description: ''
          enum:
            - IPHONE
            - IPAD
          x-apifox-enum:
            - value: IPHONE
              name: IPHONE
              description: IPHONE
            - value: IPAD
              name: IPAD
              description: IPAD
          examples:
            - IPHONE,IPAD
        category:
          type: string
          description: ''
          examples:
            - '6004'
        start:
          type: string
          description: ''
          x-apifox-mock: '@date'
          examples:
            - ''
        end:
          type: string
          description: ''
          x-apifox-mock: '@date'
          examples:
            - ''
      x-apifox-orders:
        - region
        - store
        - device
        - category
        - start
        - end
      required:
        - store
        - category
        - start
        - end
      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: []

```