Get keyword ranking information

POST

/Keyword/rank

Get current ranking of keywords with refresh time and 24h comparison.

Request

Header Params

Body Params application/json

Example

{
    "region": "US",
    "appId": "com.facebook.katana",
    "platform": 1,
    "lang": null,
    "words": [
        "facebook",
        "katana"
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://uat.asoworld.com/openApi/Keyword/rank' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data '{
    "region": "US",
    "appId": "com.facebook.katana",
    "platform": 1,
    "lang": null,
    "words": [
        "facebook",
        "katana"
    ]
}'

Responses

🟢200

application/json

Successfully retrieved keyword rankings.
Note: The rank field indicates the keyword's current search ranking position. A value greater than 0 means the keyword has an active ranking at that position. A value of -1 means the keyword is not covered or no data is available. The diff field will be "out" when the keyword is not covered, and "none" when no data is available.

Bodyapplication/json

Example

{
    "P": {
        "facebook": {
            "rank": 1,
            "ts": 1631171845877,
            "diff": "0",
            "isTooLong": false,
            "isReal": true,
            "hot": null,
            "pop": 5
        },
        "katana": {
            "rank": 40,
            "ts": 1631172599088,
            "diff": "-8",
            "isTooLong": false,
            "isReal": false,
            "hot": null,
            "pop": 5
        }
    }
}

🟠400

Modified at 2026-07-07 06:18:50

My Keywords

Get keyword ranking history