4001-Keyword Search

POST

/app/search

Query ranked apps by keyword (rank, covered keywords, traffic share, rating, latest release, first release, etc.).

Request

Authorization

Add parameter in header

x-openapi-key

Example:

x-openapi-key: ********************

Body Params application/json

Example

{
  "appstore": "GP",
  "region": "CN",
  "device": "IPAD",
  "keyword": "武侠",
  "limit": "TOP_200"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.foxdata.com/apiv1/open-api/app/search' \
--header 'x-openapi-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
  "appstore": "GP",
  "region": "CN",
  "device": "IPAD",
  "keyword": "武侠",
  "limit": "TOP_200"
}'

Responses

🟢200

application/json

Bodyapplication/json

Examples

Success ExampleSuccess Example

{
  "requestParam": {
    "appstore": "GP",
    "region": "CN",
    "keyword": "武侠",
    "device": "IPAD",
    "limit": "TOP_200"
  },
  "result": [
    {
      "appId": "com.chillyroom.worldofkungfu.gp",
      "title": "大江湖之苍龙与白鸟",
      "icon": "https://image3.foxdata.com/gp-proxy/4bedB6C4FXiNRKTybXUgrPmUh2C7CjsIsJvCF-bZIeyWKclbR-HZ58DZFpv_Xzb6Skw",
      "subtitle": null,
      "usage": 0,
      "rank": 1,
      "rankChange": 0,
      "rankedKeywords": 7971,
      "install": 0,
      "ratingCount": 3736,
      "updateDate": 1741864943000,
      "releaseDate": 1741083603000
    }
  ],
  "creditsCost": {
    "requestCredits": 0,
    "baseCredits": 150,
    "extraCredits": 0,
    "totalCostCredits": 150
  },
  "next": null
}

Modified at 2026-06-25 05:44:00

3005-ASA Tab Rate Result

4002-Keyword Expansion