Application categories ranking (App Store only)

Returns top charts of App Store

Note

country parameter is optional here. If it’s not passed, request will return categories ranking for application in all countries available in ASOdesk for all countries. The list of countries is located in header of ASOdesk Dashboard https://hq.asodesk.com

GET /api/app-category-ranking

Query parameters

Mandatory

  • devicetype - device type (iphone or ipad)

  • storeid - store id of app (for example com.google.android.apps.maps or 585027354)

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

Optional

  • 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

  • since (defaut: 30 days ago from till)- start of search results timestamp range in ISO format (YYYY-MM-DDThh:mmTZD, ex.: 2017-07-16T19:20%2B03:00) Note that plus sign is replaced with %2B

  • till (default: now)- end of search results timestamp range in ISO format (YYYY-MM-DDThh:mmTZD, ex.: 2018-01-00T00:00%2B03:00) Note that plus sign is replaced with %2B

Example request

GET /api/app-category-ranking?country=RU&storeid=564177498&devicetype=iphone

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

Status: 200 OK

{
    "data": {
        "timestamp": <string>,  // ISO format timestamp of results,
        "country": <string>,  // same as specified in query params,
        "devicetype": <string>,  // same as specified in query params,
        "storeid": <string>,  // same as specified in query params,
        "results": {
            <string>: {  // country code
                <string>: {  // ISO format date
                    <string>: {  // store's category id
                        <string>: <integer>,  // "free" or "paid": application rank in top chart
                        "title": <string>,  // store's category title
                        "title_en": <string>,  // store's category title in english
                    }
                }
            },
        }
    },
}

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.