---
title: "Rankings"
method: GET
path: "/playstore/rankings/{container}/{category}/{country}"
tags: ["Play Store Rankings"]
---

# Rankings

`GET /playstore/rankings/{container}/{category}/{country}`

## Request

- Base URL: `https://api.mixrank.com/v2/json/YOUR_API_KEY`
- URL: `https://api.mixrank.com/v2/json/YOUR_API_KEY/playstore/rankings/{container}/{category}/{country}`
- Auth: none declared

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`.

## Path parameters

- `container` string, required
- `category` string, required
- `country` string, required

## Query parameters

- `offset` integer
- `page_size` integer
- `sort_field` 'ranking'
- `sort_order` 'asc' | 'desc'
- `before` string, date

## Response `200`

Successful response.

- union
  - object
    - `total` integer, nullable
    - `offset` integer, nullable
    - `page_size` integer, nullable
    - `results` object[]
      - `pname` string, nullable: The package name for this app.
      - `title` string, nullable: The title of the app.
      - `rank` integer, nullable: MixRank Rank.
      - `score` number, nullable: MixRank Authority Score™.
      - `developer_id` integer, nullable: Internal numeric developer ID; use in the developer apps endpoint.
      - `developer_name` string, nullable: The name of the app publisher. Usually a company or individual's name.
      - `developer_email` string, nullable: Email address of the developer, from the public profile.
      - `developer_website` string, nullable: Developer's website.
      - `downloads` integer, nullable: Observed Google Play download bucket lower bound, not an exact count.
      - `removed` boolean, nullable: Indicates if this app has been removed from the playstore.
      - `review_count` integer, nullable: Number of reviews/comments for this app.
      - `rating` number, nullable: The current rating for this app. (0-5)
      - `rating_count` integer, nullable: Number of ratings for this app.
      - `upload_date` string, date, nullable: The upload date for the latest version of this app.
      - `release_date` string, date, nullable: The upload date for the earliest version of this app.
      - `small_icon_url` string, nullable: 48x48 app icon (deprecated).
      - `large_icon_url` string, nullable: 512x512 app icon.
      - `category` string, nullable: The primary category of this app.
      - `categories` string[]: Google Play category identifiers; empty when none are available.
      - `company` object, nullable: Information about the company associated with this object
        - `id` integer, nullable: The unique integer identifier for this company
        - `name` string, nullable: The name of this company
        - `slug` string, nullable: A unique textual identifier for this company
      - `version` object, nullable: Latest version information.
        - `major_version_number` integer, nullable: Major version number.
        - `version_code` integer, nullable: Internal unique version code.
        - `version_string` string, nullable: User-visible version number.
      - `ranking` integer, nullable: Rank within the list.
      - `ranking_date` string, nullable: When this ranking list was generated by Google (UTC).
  - object
    - `errors` object, required

## Other responses

- `403`: Invalid key or insufficient endpoint permissions.
- `404`: No matching object or results.
- `408`: The database query timed out.
- `429`: Concurrent request limit exceeded.
- `500`: Internal API error.

---

[API](https://skmtc.dev/mixrank/apis/mixrank-api.md) - [All operations](https://skmtc.dev/mixrank/apis/mixrank-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mixrank/apis/mixrank-api/revisions/786d3fcfe918?raw)