FoxData Open API
My License
My License
  1. LIST OF APIS
  • REFERENCE
    • Make Your First API Request
    • API Billing Rules
  • COMMON PARAMS
    • App Store Categories
    • Google Play Categories
    • Supported Countries/Languages
  • LIST OF APIS
    • App Metadata
      POST
    • App Metadata History
      POST
    • App Category Ranking
      POST
    • App Category Ranking History
      POST
    • App Metrics
      POST
    • App Metrics History
      POST
    • App Keyword
      POST
    • App Keyword History
      POST
    • Keywords Metrics
      POST
    • Keywords Metrics History
      POST
  1. LIST OF APIS

App Keyword History

POST
/expose/keyword/metrics-rank-history
Credits Cost
Cost TypeCost Credits
Request Credits1
Credits Cost of Each Metrics
Rank
Cost TypeCost Credits
Base Credits10
Extra Credits1
Installs
Cost TypeCost Credits
Base Credits10
Extra Credits1

Request

Header Params
x-openapi-key
string 
required
Default:
Your License
Body Params application/json
Your request param.
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
Example
{
  "appId": "416048305",
  "region": "KR",
  "metrics": [
    "RANK",
    "INSTALL"
  ],
  "keywords": [
    "alight motion",
    "북플레이",
    "alight motion"
  ],
  "device": "IPHONE",
  "timezone": 0,
  "start": "2024-05-10",
  "end": "2024-05-12"
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.foxdata.com/apiv1/expose/keyword/metrics-rank-history' \
--header 'x-openapi-key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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

🟢200Success
application/json
Body
requestParam
object (KeywordRankMetricsHistoryQuery) 
optional
Your request param.
appId
string  | null 
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  | null 
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] | null 
required
Keyword Metrics
Allowed values:
RANKINSTALL
result
array [object {3}]  | null 
optional
Your response.
keyword
string  | null 
optional
Keyword
installs
array[object (KeywordInfo) {2}]  | null 
optional
Installs
rank
array[object (KeywordInfo) {2}]  | null 
optional
Rank
creditsCost
object (OpenApiPointCostVO) 
optional
Credits cost info.
requestCredits
integer  | null 
optional
baseCredits
integer  | null 
optional
extraCredits
integer  | null 
optional
totalCostCredits
integer  | null 
optional
Example
{
  "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
    }
  }
}
Previous
App Keyword
Next
Keywords Metrics
Built with