---
title: "Lists"
method: GET
path: "/appstore/rankings"
tags: ["iOS Rankings"]
---

# Lists

`GET /appstore/rankings`

## Request

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

App Store chart identifiers: container (chart type), genre (app category), and country (store). Not every combination has a ranking list.

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

## Response `200`

Successful response.

- object
  - `container` string[], nullable: List of iOS rankings containers, eg "topfreeapplications".
  - `genre` string[], nullable: List of iOS genres, eg "ios-games-racing".
  - `country` string[], nullable: List of iOS rankings countries, eg "us".

## 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)