MImixrank
Play Store Rankings

Rankings

Get app rankings by list. A list is determined by container, category and country.

Returns the latest snapshot strictly before the cutoff, searching the preceding 90 days (relative to now when before is omitted). The total is unavailable (null).

Required permissions for your API key's user: playstore.apps.

get/playstore/rankings/{container}/{category}/{country}

Request

  • Base URL
    https://api.mixrank.com/v2/json/YOUR_API_KEY
  • Auth
    none declared

Path parameters

containerstring required

Chart type identifier from /playstore/rankings.

categorystring required

Category identifier, or the literal path segment null for all categories.

countrystring required

2-letter country code, upper case (ISO 3166).

Query parameters

offsetinteger

Offset the set of results to return. Useful for paging through results.

page_sizeinteger

Number of results to return.

sort_field'ranking'

Sort the results by the field specified. Sortable fields: <code>ranking</code>.

sort_order'asc' | 'desc'

Sort the results in the order specified. Sortable directions: <code>asc</code>, <code>desc</code>.

beforestring date

Return ranking list as it appeared before given date (in UTC).

Response

Successful response.

OR

Example response

{
  "total": 1,
  "page_size": 4,
  "results": [
    {
      "pname": "com.king.candycrushsaga",
      "title": "Candy Crush Saga",
      "rank": 4,
      "score": 0.93,
      "developer_id": 142682,
      "developer_name": "King",
      "developer_email": "candycrush.techhelp@king.com",
      "developer_website": "https://candycrush.com",
      "downloads": 1000000000,
      "review_count": 2088653,
      "rating": 4.63,
      "rating_count": 38935972,
      "upload_date": "2026-10-01",
      "release_date": "2012-11-15",
      "small_icon_url": "https://playstore-images.mixrank.com/images/5d17458f52068ffa65ed345b7f46c1ce",
      "large_icon_url": "https://playstore-images.mixrank.com/images/81c200e1fd692ed95589c9935d39e0f4",
      "category": "game_casual",
      "categories": [
        "game",
        "game_casual"
      ],
      "company": {
        "id": 87953194,
        "name": "King"
      },
      "version": {
        "major_version_number": 1,
        "version_code": 1063002,
        "version_string": "1.337.0.2"
      },
      "ranking": 1,
      "ranking_date": "2026-10-12 14:45:55.375391"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.