FoxData Open API

App Keyword History

POST/expose/keyword/metrics-rank-history

Credits Cost

Cost Type	Cost Credits
Request Credits	1

Credits Cost of Each Metrics

Rank

Cost Type	Cost Credits
Base Credits	10
Extra Credits	1

Installs

Cost Type	Cost Credits
Base Credits	10
Extra Credits	1

请求参数

appId

string

required

Application ID or Application PackageName

keywords

array[string] | null

optional

Keyword list

<= 5 items

start

string | null

required

Start Date

end

string | null

required

End Date

region

string

required

Two character region code,like US.

device

enum<string> | enum<null>

optional

App Store Device, only for AppStore query.

Allowed values:

IPHONEIPAD

timezone

integer | null

required

Your timezone,enter 8 for UTC+8,enter -7 for UTC-7.

metrics

array[string]

required

Keyword Metrics

Allowed values:

RANKINSTALL

{
  "appId": "416048305",
  "region": "KR",
  "metrics": [
    "RANK",
    "INSTALL"
  ],
  "keywords": [
    "alight motion",
    "북플레이",
    "alight motion"
  ],
  "device": "IPHONE",
  "timezone": 0,
  "start": "2024-05-10",
  "end": "2024-05-12"
}

示例代码

Responses

Success(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

requestParam

#/definitions/97994121

optional

Your request param.

result

array [object {3}] | null

optional

Your response.

keyword

string | null

optional

Keyword

installs

$ref(#/definitions/85655820)[] | null

optional

Installs

rank

$ref(#/definitions/85655820)[] | null

optional

Rank

creditsCost

#/definitions/85655826

optional

Credits cost info.

{
  "code": 200,
  "msg": "success",
  "data": {
    "requestParam": {
      "appId": "416048305",
      "keywords": [
        "alight motion",
        "북플레이",
        "alight motion"
      ],
      "start": "2024-05-10",
      "end": "2024-05-12",
      "region": "KR",
      "device": "IPHONE",
      "timezone": 0,
      "metrics": [
        "RANK",
        "INSTALL"
      ]
    },
    "result": [
      {
        "keyword": "alight motion",
        "installs": [
          {
            "value": null,
            "date": "2024-05-10"
          },
          {
            "value": null,
            "date": "2024-05-11"
          },
          {
            "value": null,
            "date": "2024-05-12"
          }
        ],
        "rank": [
          {
            "value": 37,
            "date": "2024-05-10"
          },
          {
            "value": 44,
            "date": "2024-05-11"
          },
          {
            "value": 49,
            "date": "2024-05-12"
          }
        ]
      },
      {
        "keyword": "북플레이",
        "installs": [
          {
            "value": null,
            "date": "2024-05-10"
          },
          {
            "value": null,
            "date": "2024-05-11"
          },
          {
            "value": null,
            "date": "2024-05-12"
          }
        ],
        "rank": [
          {
            "value": 162,
            "date": "2024-05-10"
          },
          {
            "value": 155,
            "date": "2024-05-11"
          },
          {
            "value": 164,
            "date": "2024-05-12"
          }
        ]
      }
    ],
    "creditsCost": {
      "requestCredits": 1,
      "baseCredits": 20,
      "extraCredits": 4,
      "totalCostCredits": 25
    }
  }
}

Last modified: 6 个月前