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

Keywords Metrics

POST
/expose/keyword/metrics
Credits Cost
Cost TypeCost Credits
Request Credits1
Credits Cost of Each Metrics
Volume
Cost TypeCost Credits
Base Credits10
Results
Cost TypeCost Credits
Base Credits10
Correlation
Cost TypeCost Credits
Base Credits10
Chance
Cost TypeCost Credits
Base Credits10
Difficulty
Cost TypeCost Credits
Base Credits10
Keyword Types
Cost TypeCost Credits
Base Credits10

Request

Header Params
x-openapi-key
string 
required
Default:
Your License
Body Params application/json
Your request param.
appId
string 
required
Application ID or packageName
region
string 
required
Two character region code,like US.
Default:
US
metrics
array[string]
required
Keyword Metrics
Allowed values:
POPNUMRELATIONDIFFCHANCETAG
keywords
array[string] | null 
optional
Filtered Keywords
<= 5 items
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.
Example
{
  "appId": "416048305",
  "region": "KR",
  "metrics": [
    "POP",
    "NUM"
  ],
  "keywords": [
    "alight motion",
    "북플레이",
    "alight motion"
  ],
  "device": "IPHONE",
  "timezone": 8
}

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' \
--header 'x-openapi-key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appId": "416048305",
    "region": "KR",
    "metrics": [
        "POP",
        "NUM"
    ],
    "keywords": [
        "alight motion",
        "북플레이",
        "alight motion"
    ],
    "device": "IPHONE",
    "timezone": 8
}'

Responses

🟢200Success
application/json
Body
requestParam
object (KeywordMetricsQuery) 
optional
Your request param.
appId
string  | null 
required
Application ID or packageName
region
string  | null 
required
Two character region code,like US.
Default:
US
metrics
array[string] | null 
required
Keyword Metrics
Allowed values:
POPNUMRELATIONDIFFCHANCETAG
keywords
array[string] | null 
optional
Filtered Keywords
<= 5 items
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.
result
array [object {7}]  | null 
optional
Your response.
keyword
string  | null 
optional
Keyword
relation
object 
optional
Correlation
pop
object (KeywordInfo) 
optional
Volume
num
object (KeywordInfo) 
optional
Results
chance
object (KeywordInfo) 
optional
Chance
diff
object (KeywordInfo) 
optional
Difficulty
tag
object (Tag) 
optional
Keyword Types
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",
      "region": "KR",
      "metrics": [
        "POP",
        "NUM",
        "TAG"
      ],
      "keywords": [
        "alight motion",
        "북플레이",
        "alight motion"
      ],
      "device": "IPHONE",
      "timezone": 0
    },
    "result": [
      {
        "keyword": "alight motion",
        "pop": {
          "value": null,
          "date": "2024-05-14"
        },
        "num": {
          "value": 237,
          "date": "2024-05-14"
        },
        "tag": {
          "date": "2024-05-14",
          "brand": [
            {
              "appId": "1459833443",
              "appName": "Alight Motion",
              "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/37/2b/3c/372b3c49-d733-f623-376b-f98759af471a/AppIcon-0-0-1x_U007emarketing-0-4-0-0-0-0-85-220.png/88x88w.png"
            }
          ],
          "asa": [
            {
              "appId": "416048305",
              "appName": "Meitu 메이투 - 베스트 보정 앱 & AI 카툰",
              "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/48/af/6e/48af6ed0-e840-dc22-09a6-d0dd4eddec2f/AppIcon-0-0-1x_U007emarketing-0-7-0-85-220.png/88x88w.png"
            },
            {
              "appId": "389801252",
              "appName": "Instagram",
              "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/21/d3/08/21d308ff-6354-fd2a-8844-4354ba710dab/Prod-0-0-1x_U007emarketing-0-7-0-85-220.png/88x88w.png"
            },
            {
              "appId": "1006386292",
              "appName": "만들기  비디오 으로 & 노래 편집기",
              "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/38/a2/bc/38a2bc9d-4457-6dbd-0559-f82c0cfd4b36/AppIcon-0-0-1x_U007epad-0-0-0-0-0-0-P3-0-0-0-GLES2_U002c0-512MB-85-220-0-0.png/88x88w.png"
            }
          ],
          "meta": null
        }
      },
      {
        "keyword": "북플레이",
        "pop": {
          "value": null,
          "date": "2024-05-14"
        },
        "num": {
          "value": 219,
          "date": "2024-05-14"
        },
        "tag": {
          "date": "2024-05-14",
          "brand": null,
          "asa": [
            {
              "appId": "1619262637",
              "appName": "WePlay - 파티게임",
              "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/7d/5f/8e/7d5f8e47-1fa6-93f1-08db-7c44321e8d6f/AppIcon-KR-0-0-1x_U007epad-0-0-0-sRGB-85-220.png/88x88w.png"
            },
            {
              "appId": "947258826",
              "appName": "마피아42",
              "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/f0/83/78/f0837892-1b84-9639-6261-fc350f2e339c/AppIcon-0-0-1x_U007emarketing-0-7-0-sRGB-85-220.png/88x88w.png"
            },
            {
              "appId": "1074569961",
              "appName": "원티드 - 취업·이직, 프리랜서, 커리어 성장",
              "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/3b/df/c2/3bdfc2f1-8bca-65f6-c90f-c4df5bc4cdc1/AppIcon-0-0-1x_U007ephone-0-0-85-220.png/88x88w.png"
            }
          ],
          "meta": null
        }
      }
    ],
    "creditsCost": {
      "requestCredits": 1,
      "baseCredits": 30,
      "extraCredits": 0,
      "totalCostCredits": 31
    }
  }
}
Previous
App Keyword History
Next
Keywords Metrics History
Built with