Top charts (App Store only)

Returns top charts of App Store. ‘All Applications’ (iOS 11 and up) category returns only Free and Paid lists. Other lists return Free for iOS 11+, Paid for iOS 11+ and Grossing for iOS 7-10

GET /api/top-charts

Query parameters

  • devicetype - device type (iphone or ipad)

  • country - country ISO code (ex.: US, RU, GB etc.)

  • timestamp (default: now) - timestamp of search results in ISO format (YYYY-MM-DDThh:mmTZD, ex.: 2017-07-16T19:20%2B03:00) Note that plus sign is replaced with %2B

  • storeid (default: ‘36’) - store id of App Store category (default: ‘36’) (for example 36 for ‘Overall’, 6014 for ‘Games’ or 10000 for ‘Kids’ -> ‘Kids 5 & Under’, see the full list of store ids below)

Example request

GET /api/top-charts?country=US&storetype=appstore&storeid=36

If we have all required information for this request, you will get following response:

Status: 200 OK

{
    "id": <string>,  // request id for technical support purposes
    "data": {
        "timestamp": <string>,  // ISO format timestamp of results,
        "devicetype": <string>,  // same as specified in query params,
        "country": <string>,  // same as specified in query params,
        "category_title": <string>,  // localized App Store category title,
        "category_title_en": <string>,  // App Store category title in english,
        "storeid": <string>,  // App Store category store id
        "results": {
            "free": [<string>], // application ids with preserved rank
            "paid": [<string>]  // application ids with preserved rank
            "grossing": [<string>]  // application ids with preserved rank
        }
    }
}

Store Id List

Category Title

Store Id

Overall (iOS 7-10)

36

All Applications (iOS 11+)

3600

Lifestyle

6012

Magazines & Newspapers

6021

Medical

6020

Music

6011

Navigation

6010

News

6009

Photo & Video

6008

Productivity

6007

Reference

6006

Shopping

6024

Social Networking

6005

Sports

6004

Travel

6003

Utilities

6002

Weather

6001

Books

6018

Business

6000

Education

6017

Entertainment

6016

Finance

6015

Food & Drink

6023

Games

6014

Action

7001

Adventure

7002

Arcade

7003

Board

7004

Card

7005

Casino

7006

Family

7009

Music

7011

Puzzle

7012

Racing

7013

Role Playing

7014

Simulation

7015

Sports

7016

Strategy

7017

Trivia

7018

Word

7019

Health & Fitness

6013

Kids

0

Kids 5 & Under

10000

Kids 6–8

10001

Kids 9–11

10002


If we need to download some additional data from store’s servers, you will get following response:

Status: 202 Accepted

{
    "key": <string>,  //request key for technical support purposes
    "detail": "Result is preparing, try in 30 seconds later"
}

So, try in 30 seconds later and if response will be ready you will get full data.


If store’s servers got no required data or we don’t have required data, you will get following response:

Status: 204 No Content

You may try later to get expected data.