- REFERENCE
- COMMON PARAMS
- LIST OF APIS
App Keyword History
POST
/expose/keyword/metrics-rank-history
Cost Type | Cost Credits |
---|---|
Request Credits | 1 |
Cost Type | Cost Credits |
---|---|
Base Credits | 10 |
Extra Credits | 1 |
Cost Type | Cost Credits |
---|---|
Base Credits | 10 |
Extra Credits | 1 |
Request
Header Params
x-openapi-key
string
required
Default:
Your License
Body Params application/json
Your request param.
appId
string
required
keywords
array[string] | null
optional
<= 5 items
start
string | null
required
end
string | null
required
region
string
required
device
enum<string> | enum<null>
optional
Allowed values:
IPHONEIPAD
timezone
integer | null
required
metrics
array[string]
required
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
appId
string | null
required
keywords
array[string] | null
optional
<= 5 items
start
string | null
required
end
string | null
required
region
string | null
required
device
enum<string> | enum<null>
optional
Allowed values:
IPHONEIPAD
timezone
integer | null
required
metrics
array[string] | null
required
Allowed values:
RANKINSTALL
result
array [object {3}] | null
optional
keyword
string | null
optional
installs
array[object (KeywordInfo) {2}] | null
optional
rank
array[object (KeywordInfo) {2}] | null
optional
creditsCost
object (OpenApiPointCostVO)
optional
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
}
}
}
Modified at 2024-05-17 03:01:36