---
title: "Rankings Summary"
method: GET
path: "/playstore/apps/{pname}/rankings"
tags: ["Play Store Apps"]
---

# Rankings Summary

`GET /playstore/apps/{pname}/rankings`

## Request

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

Rankings for an app. Apps are ranked in "lists" which are made up of a container, and (optionally) a category.

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

## Path parameters

- `pname` string, required

## Query parameters

- `country` string
- `offset` integer
- `page_size` integer
- `sort_field` 'current_rank' | 'highest_rank'
- `sort_order` 'asc' | 'desc'

## Response `200`

Successful response.

- union
  - object
    - `total` integer, nullable
    - `offset` integer, nullable
    - `page_size` integer, nullable
    - `results` object[]
      - `container` string, nullable: List container.
      - `country` string, nullable: List country.
      - `category` string, nullable: The category this app is in.
      - `current_rank` integer, nullable: Latest observed rank in this list; not a live store rank.
      - `highest_rank` integer, nullable: The highest rank the app achieved in this list.
      - `first_ranked` string, date, nullable: The date this app first ranked in this list.
      - `last_ranked` string, date, nullable: The date this app last ranked in this list.
  - 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)