---
title: "Rankings Summary"
method: GET
path: "/appstore/apps/{app_id}/rankings"
tags: ["iOS Apps"]
---

# Rankings Summary

`GET /appstore/apps/{app_id}/rankings`

## Request

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

Rankings for an app. Apps are ranked in "lists" which are made up of a container, a country, and a genre.

Only lists in which the app was seen within the last month are included. Container, genre and country values are display names, not query slugs.

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

## Path parameters

- `app_id` string, required

## Query parameters

- `offset` integer
- `page_size` integer

## Response `200`

Successful response.

- union
  - object
    - `total` integer, nullable
    - `offset` integer, nullable
    - `page_size` integer, nullable
    - `results` object[]
      - `id` integer, nullable: List ID.
      - `container` string, nullable: List container.
      - `genre` string, nullable: List genre.
      - `country` string, nullable: List country.
      - `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)