# 1012-App-Keyword Expansion

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /keyword/explore:
    post:
      summary: 1012-App-Keyword Expansion
      deprecated: false
      description: Expand keywords based on app + keyword or app + competitor.
      operationId: 1012_App_Keyword Expansion
      tags:
        - II. List of Interfaces/1. application Services
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                appId:
                  type: string
                  description: App ID
                  examples:
                    - '480079300'
                device:
                  type: string
                  description: AS apps only
                  examples:
                    - IPHONE
                region:
                  type: string
                  description: Country/Region
                  examples:
                    - CN
                keyword:
                  type: string
                  description: Keyword or competitors (1-5); required, choose one
                  examples:
                    - 租房
                competitorIds:
                  type: array
                  description: Keyword or competitors (1-5); required, choose one
                  examples:
                    - []
                metrics:
                  type: string
                  description: >-
                    Metrics; configure per need, separate multiple metrics with
                    commas
                  examples:
                    - - CORRELATION
                      - RANK
                      - VOLUME
                      - RESULTS
                      - TAG
                      - CHANCE
                      - DIFFICULTY
                      - INSTALL
                limit:
                  type: string
                  description: Default Query 200
                  examples:
                    - TOP_200
              required:
                - keyword
                - competitorIds
              x-apifox-orders:
                - appId
                - device
                - region
                - keyword
                - competitorIds
                - metrics
                - limit
              x-apifox-ignore-properties: []
            example:
              appId: '480079300'
              device: IPHONE
              region: CN
              limit: TOP_200
              metrics:
                - CORRELATION
                - RANK
                - VOLUME
                - RESULTS
                - TAG
                - CHANCE
                - DIFFICULTY
                - INSTALL
              keyword: 租房
              competitorIds: []
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenApiBaseVOWankaKeywordExploreV2VO'
              example:
                requestParam:
                  appId: '480079300'
                  region: CN
                  keyword: 租房
                  competitorIds: []
                  limit: TOP_200
                  device: IPHONE
                  metrics:
                    - CORRELATION
                    - RANK
                    - VOLUME
                    - RESULTS
                    - TAG
                    - CHANCE
                    - DIFFICULTY
                    - INSTALL
                result:
                  dates:
                    - '2025-11-29'
                    - '2025-11-30'
                    - '2025-12-01'
                  appInfoMap:
                    '282614216':
                      appName: eBay 在线购物与交易平台
                      icon: >-
                        /Purple211/v4/36/c0/c4/36c0c492-bde2-897b-5f9e-b30f4553c274/AppIcon-0-0-1x_U007epad-0-1-0-85-220.png/88x88w.png
                    '284882215':
                      appName: Facebook
                      icon: >-
                        /Purple211/v4/7a/01/59/7a01597f-482a-1736-35fe-9aa0432aadab/Icon-Production-0-0-1x_U007epad-0-1-0-85-220.png/88x88w.png
                  keywords:
                    - keyword: 58同城
                      searchResult:
                        num: 196
                        appIds:
                          - '480079300'
                          - '1370819508'
                          - '887314963'
                      searchVolume:
                        trend:
                          - 84
                          - 83
                          - 83
                        num: 83
                      chance: 73
                      inst:
                        top5:
                          - '480079300'
                          - '1370819508'
                          - '887314963'
                          - '415606289'
                          - '1347663353'
                        per: 0.8763
                        value: 20786
                      rank:
                        trend:
                          - 115
                          - 114
                          - 110
                        num: 1
                      diff: 45
                      tag:
                        asa: true
                        brand: true
                        asaApps:
                          - '480079300'
                          - '415606289'
                          - '1142110895'
                        brandApps:
                          - '480079300'
                        metaTypes:
                          - APP_NAME
                      relation: 100
                    - keyword: '58'
                      searchResult:
                        num: 202
                        appIds:
                          - '480079300'
                          - '1445382021'
                          - '1370819508'
                      searchVolume:
                        trend:
                          - 70
                          - 70
                          - 70
                          - 70
                          - 70
                          - 70
                          - 70
                        num: 70
                      chance: 75
                      inst:
                        top5:
                          - '480079300'
                          - '1445382021'
                          - '1370819508'
                          - '887314963'
                          - '415606289'
                        per: 0.4362
                        value: 1245
                      rank:
                        trend:
                          - 125
                          - 125
                          - 123
                          - 122
                          - 121
                          - 123
                          - 123
                        num: 1
                      diff: 43
                      tag:
                        asa: true
                        brand: false
                        asaApps:
                          - '480079300'
                          - '887314963'
                          - '1574147199'
                        metaTypes:
                          - APP_NAME
                      relation: 100
                  iconPrefix: https://is1-ssl.mzstatic.com/image/thumb
                creditsCost:
                  requestCredits: 0
                  baseCredits: 500
                  extraCredits: 0
                  totalCostCredits: 500
                next: null
          headers: {}
          x-apifox-name: Success
      security:
        - apikey-header-x-openapi-key: []
      x-apifox-folder: II. List of Interfaces/1. application Services
      x-apifox-status: developing
      x-run-in-apifox: https://app.apifox.com/web/project/4128055/apis/api-478038413-run
components:
  schemas:
    OpenApiBaseVOWankaKeywordExploreV2VO:
      type: object
      properties:
        requestParam:
          $ref: '#/components/schemas/WankaKeywordExploreQuery'
          description: Your request param.
        result:
          $ref: '#/components/schemas/WankaKeywordExploreV2VO'
          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: ''
    WankaKeywordExploreV2VO:
      type: object
      properties:
        dates:
          type: array
          items:
            type: string
          description: ''
        appInfoMap:
          $ref: '#/components/schemas/MapAppInfoVO'
          description: ''
        keywords:
          type: array
          items:
            $ref: '#/components/schemas/KeywordInfo'
            description: >-
              com.xiaoxi.openapi.model.vo.wanka.WankaKeywordExploreV2VO.KeywordInfo
          description: ''
        iconPrefix:
          type: string
          description: ''
      x-apifox-orders:
        - dates
        - appInfoMap
        - keywords
        - iconPrefix
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    KeywordInfo:
      type: object
      properties:
        keyword:
          type: string
          description: ''
        searchResult:
          $ref: '#/components/schemas/SearchResult'
          description: ''
          default: new SearchResult()
        searchVolume:
          $ref: '#/components/schemas/SearchVolume'
          description: ''
          default: new SearchVolume()
        chance:
          type: integer
          description: ''
        inst:
          $ref: '#/components/schemas/Inst'
          description: ''
          default: new Inst()
        rank:
          $ref: '#/components/schemas/Rank'
          description: ''
          default: new Rank()
        diff:
          type: integer
          description: ''
        tag:
          $ref: '#/components/schemas/Tag'
          description: private List<AppInfo> top5;
          default: new Tag()
        relation:
          type: integer
          description: ''
      x-apifox-orders:
        - keyword
        - searchResult
        - searchVolume
        - chance
        - inst
        - rank
        - diff
        - tag
        - relation
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    Tag:
      type: object
      properties:
        asa:
          type: boolean
          description: ''
        brand:
          type: boolean
          description: ''
        asaApps:
          type: array
          items:
            type: string
          description: ''
        brandApps:
          type: array
          items:
            type: string
          description: ''
        metaTypes:
          type: array
          items:
            type: string
            enum:
              - APP_NAME
              - SUB_TITLE
            x-apifox-enum:
              - value: APP_NAME
                name: APP_NAME
                description: App Name
              - value: SUB_TITLE
                name: SUB_TITLE
                description: Subtitle
          description: ''
      x-apifox-orders:
        - asa
        - brand
        - asaApps
        - brandApps
        - metaTypes
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    Rank:
      type: object
      properties:
        trend:
          type: array
          items:
            type: integer
          description: ''
        num:
          type: integer
          description: ''
      x-apifox-orders:
        - trend
        - num
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    Inst:
      type: object
      properties:
        top5:
          type: array
          items:
            type: string
          description: ''
        per:
          type: number
          description: ''
        value:
          type: integer
          description: ''
      x-apifox-orders:
        - top5
        - per
        - value
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    SearchVolume:
      type: object
      properties:
        trend:
          type: array
          items:
            type: integer
          description: ''
        num:
          type: integer
          description: ''
      x-apifox-orders:
        - trend
        - num
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    SearchResult:
      type: object
      properties:
        num:
          type: integer
          description: ''
        appIds:
          type: array
          items:
            type: string
          description: ''
      x-apifox-orders:
        - num
        - appIds
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    MapAppInfoVO:
      type: object
      properties:
        key:
          $ref: '#/components/schemas/key'
      x-apifox-orders:
        - key
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    key:
      type: object
      properties:
        appId:
          type: string
          description: ''
        appName:
          type: string
          description: ''
        icon:
          type: string
          description: ''
      x-apifox-orders:
        - appId
        - appName
        - icon
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    WankaKeywordExploreQuery:
      type: object
      properties:
        appId:
          type: string
          description: ''
          examples:
            - com.moye.shelter
        region:
          type: string
          description: ''
          examples:
            - US
        keyword:
          type: string
          description: ''
          examples:
            - games
        competitorIds:
          type: array
          items:
            type: string
          description: ''
          examples:
            - - com.moye.shelter2
              - com.moye.shelter2
            - - com.moye.shelter2
              - com.moye.shelter2
        limit:
          type: string
          description: ''
          enum:
            - TOP_200
            - TOP_400
            - ALL
          x-apifox-enum:
            - value: TOP_200
              name: TOP_200
              description: TOP_200
            - value: TOP_400
              name: TOP_400
              description: TOP_400
            - value: ALL
              name: ALL
              description: ALL
          default: Limit.TOP_200
          examples:
            - |-
              TOP_200
              TOP_400
              ALL
        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
        metrics:
          type: array
          items:
            type: string
            enum:
              - CORRELATION
              - RANK
              - CHANCE
              - DIFFICULTY
              - INSTALL
              - VOLUME
              - RESULTS
              - TAG
            x-apifox-enum:
              - value: CORRELATION
                name: CORRELATION
                description: CORRELATION
              - value: RANK
                name: RANK
                description: RANK
              - value: CHANCE
                name: CHANCE
                description: CHANCE
              - value: DIFFICULTY
                name: DIFFICULTY
                description: DIFFICULTY
              - value: INSTALL
                name: INSTALL
                description: INSTALL
              - value: VOLUME
                name: VOLUME
                description: VOLUME
              - value: RESULTS
                name: RESULTS
                description: RESULTS
              - value: TAG
                name: TAG
                description: TAG
          description: ''
          examples:
            - |-
              CORRELATION：相关度
              RANK：排名+近7天排名趋势
              VOLUME：搜索指数+近7天搜索指数
              RESULTS：搜索结果数+Top50结果应用
              CHANCE：机会得分
              DIFFICULTY：难度得分
              INSTALL：安装量+安装占比+Top5应用
              TAG：标签分类+典型应用
      x-apifox-orders:
        - appId
        - region
        - keyword
        - competitorIds
        - limit
        - device
        - metrics
      required:
        - appId
        - region
        - limit
        - 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: []

```