MImixrank
iOS Rankings

Rankings

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

Returns the latest recorded chart, or the most recent chart strictly before the UTC date supplied in before.

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

get/appstore/rankings/{container}/{genre}/{country}

Request

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

Path parameters

containerstring required

Chart type identifier from /appstore/rankings.

genrestring required

App category identifier from /appstore/rankings; ios includes all apps.

countrystring required

Lowercase country slug from /appstore/rankings, for example us.

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": [
    {
      "id": 284882215,
      "bundle_id": "com.facebook.Facebook",
      "title": "Facebook",
      "rank": 17,
      "score": 0.59,
      "developer_id": 284882218,
      "developer": "Meta Platforms, Inc.",
      "company_url": "http://www.facebook.com/mobile",
      "support_url": "http://www.facebook.com/help/?page=18834",
      "privacy_policy_url": "http://www.facebook.com/about/privacy/",
      "seller": "Meta Platforms, Inc.",
      "copyright": "© 2023 Meta",
      "downloaded": true,
      "review_count": 1053213,
      "rating": 4.45,
      "rating_count": 106008288,
      "upload_date": "2026-10-07",
      "release_date": "2014-04-18",
      "small_artwork_url": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/8a/a0/a8/8aa0a82f-fcd1-b9b4-f664-28b5389f2886/Icon-Production-0-0-1x_U007epad-0-1-0-sRGB-85-220.png/60x60bb.png",
      "large_artwork_url": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/8a/a0/a8/8aa0a82f-fcd1-b9b4-f664-28b5389f2886/Icon-Production-0-0-1x_U007epad-0-1-0-sRGB-85-220.png/100x100bb.png",
      "xlarge_artwork_url": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/8a/a0/a8/8aa0a82f-fcd1-b9b4-f664-28b5389f2886/Icon-Production-0-0-1x_U007epad-0-1-0-sRGB-85-220.png/512x512bb.png",
      "genre": "Social Networking",
      "genres": [
        "Social Networking"
      ],
      "configs_count": 50427,
      "company": {
        "id": 141327039,
        "name": "Meta Platforms Inc",
        "slug": "41277281"
      },
      "version": {
        "version_number": "582.0.0",
        "version_string": "15987691"
      },
      "content_rating": "12+",
      "content_rating_details": "Infrequent/Mild Guns or Other Weapons , Age Assurance , Infrequent/Mild Alcohol, Tobacco, or Drug Use or References , Advertising , Messaging and Chat , Advisory.YES.SOCIAL_MEDIA , Parental Controls...",
      "ranking": 25,
      "ranking_date": "2026-10-11 00:29:09.682780"
    }
  ]
}

Changes

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