# 3003-Ad-Bidding Keyword Analysis

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /keyword/asa-app:
    post:
      summary: 3003-Ad-Bidding Keyword Analysis
      deprecated: false
      description: >-
        Query App Store bidding apps by keyword (visibility, traffic share,
        chart rank, etc.).
      operationId: 3003_Ad_Bidding Keyword Analysis
      tags:
        - II. List of Interfaces/3. ASA Services
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                keyword:
                  type: string
                  description: Keyword
                  examples:
                    - t
                region:
                  type: string
                  description: Country/Region
                  examples:
                    - CN
                limit:
                  type: string
                  description: Default Query 10
                  examples:
                    - TOP_50
              x-apifox-orders:
                - keyword
                - region
                - limit
              x-apifox-ignore-properties: []
            example:
              keyword: t
              limit: TOP_50
              region: CN
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenApiBaseVOListWanKaAsaAppVO'
              example:
                requestParam:
                  keyword: t
                  region: CN
                  limit: TOP_10
                result:
                  - appId: '6736826190'
                    title: Dings omni - 日本餐厅预订，tabelog预订
                    icon: >-
                      https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/33/4d/9a/334d9aa2-d94b-2354-c1ae-40640a0750ef/AppIcon-0-0-1x_U007emarketing-0-8-0-0-85-220.png/88x88w.png
                    visibilityScore: 5
                    ranks:
                      - rank: 71
                        category: '6023'
                    install: 123
                    bidding:
                      per: null
                      num: 58609
                      keywords:
                        - 航旅纵横
                        - whatsapp
                        - 有道词典
                        - google
                creditsCost:
                  requestCredits: 0
                  baseCredits: 100
                  extraCredits: 0
                  totalCostCredits: 100
                next: null
          headers: {}
          x-apifox-name: ''
      security:
        - apikey-header-x-openapi-key: []
      x-apifox-folder: II. List of Interfaces/3. ASA Services
      x-apifox-status: released
      x-run-in-apifox: https://app.apifox.com/web/project/4128055/apis/api-478038436-run
components:
  schemas:
    OpenApiBaseVOListWanKaAsaAppVO:
      type: object
      properties:
        requestParam:
          $ref: '#/components/schemas/WanKaAsaAppQuery'
          description: Your request param.
        result:
          type: array
          items:
            $ref: '#/components/schemas/WanKaAsaAppVO'
            description: com.xiaoxi.openapi.model.vo.wanka.WanKaAsaAppVO
          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: ''
    WanKaAsaAppVO:
      type: object
      properties:
        appId:
          type: string
          description: ''
        title:
          type: string
          description: ''
        icon:
          type: string
          description: ''
        visibilityScore:
          type: integer
          description: ''
        ranks:
          type: array
          items:
            $ref: '#/components/schemas/Rank'
            description: com.xiaoxi.openapi.model.vo.wanka.WanKaAsaAppVO.Rank
          description: ''
        install:
          type: integer
          description: ''
        bidding:
          $ref: '#/components/schemas/Bidding'
          description: ''
      x-apifox-orders:
        - appId
        - title
        - icon
        - visibilityScore
        - ranks
        - install
        - bidding
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    Bidding:
      type: object
      properties:
        per:
          type: number
          description: ''
        num:
          type: integer
          description: ''
        keywords:
          type: array
          items:
            type: string
          description: ''
      x-apifox-orders:
        - per
        - num
        - keywords
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    Rank:
      type: object
      properties:
        rank:
          type: integer
          description: ''
        category:
          type: string
          description: ''
      x-apifox-orders:
        - rank
        - category
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    WanKaAsaAppQuery:
      type: object
      properties:
        keyword:
          type: string
          description: ''
          examples:
            - games
        region:
          type: string
          description: ''
          examples:
            - US
        limit:
          type: string
          description: ''
          enum:
            - TOP_10
            - TOP_50
            - ALL
          x-apifox-enum:
            - value: TOP_10
              name: TOP_10
              description: TOP_10
            - value: TOP_50
              name: TOP_50
              description: TOP_50
            - value: ALL
              name: ALL
              description: ALL
          default: '{size: 10, point: 100}'
          examples:
            - TOP_10
      x-apifox-orders:
        - keyword
        - region
        - limit
      required:
        - keyword
      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: []

```
