AppAware for Developers

Top Applications

Returns the list of top Android applications by AppAware.

Resource URL

http://dev.appaware.com/1/app/top.json

Parameters

Name Required Description Example value
client_token required A client token for using this API. You can get it by registering to the AppAware API service for Developers. 12345
d optional The time frame (i.e. delta from current time) for retrieving top applications.
Value Information
hour In the last hour
day default In the last day
week In the last week
month In the last month
hour
c optional The category for top applications.
Value Information
0 default All applications
1 All games
2 Books & Reference
3 Business
4 Comics
5 Communication
6 Education
7 Entertainment
8 Finance
9 Health & Fitness
10 Lifestyle
11 Media & Video
12 Medical
13 Music & Audio
14 News & Magazines
15 Personalization
16 Photography
17 Productivity
18 Shopping
19 Social
20 Sports
21 Tools
22 Transportation
23 Travel & Local
24 Weather
25 Libraries & Demo
26 Arcade & Action
27 Brain & Puzzle
28 Cards & Casino
29 Casual
30 Racing
31 Sports Games
7
t optional Type of events for top applications.
Value Information
popular default Popular applications
trending Trending applications (emerging hits)
paid Top paid applications
country Popular applications in country, use optional query parameter cc to specify a county code. Country code defaults to worldwide.
installed Most-Installed applications
updated Most-Updated applications
removed Most-Removed applications
installed
app_info optional How much app information to return for each app.
Value Information
basic default Returns only basic app information
extended Returns extended app information
extended
num optional Number of applications returned.
Value Information
20 default Returns 20 apps
20
page optional Pagination parameter to combine with num.
Value Information
1 default Returns page 1 with "num" apps
2|3|.. Returns given page with "num" apps
3
callback optional If supplied, the response will use the JSONP format with a callback of the given name.

Example Requests

http://dev.appaware.com/1/app/top.json?d=hour&t=popular&c=0&cc=worldwide&num=5&page=1&client_token=YOUR_CLIENT_TOKEN 

{
        "page": 1,
        "refresh_url": "http://dev.appaware.com/1/app/top.json?d=hour&t=popular&c=0&cc=worldwide&num=5&page=1&client_token=YOUR_CLIENT_TOKEN",
        "more_url": "http://dev.appaware.com/1/app/top.json?d=hour&t=popular&c=0&cc=worldwide&num=5&page=2&client_token=YOUR_CLIENT_TOKEN",
        "number_results": 5,
        "url" : http://appaware.com/top-android-apps/popular/0/hour/worldwide,
        "results": [
            {
                "package_name": "com.box.android",
                "name": "Box",
                "icon": "http://d2lh3rxs7crswz.cloudfront.net/com.box.android.png"
            },
            {
                "package_name": "com.lsdroid.cerberus",
                "name": "Cerberus",
                "icon": "http://d2lh3rxs7crswz.cloudfront.net/com.lsdroid.cerberus.png"
            },
            {
                "package_name": "com.fingersoft.cartooncamera",
                "name": "Cartoon Camera",
                "icon": "http://d2lh3rxs7crswz.cloudfront.net/com.fingersoft.cartooncamera.png"
            },
            {
                "package_name": "com.skype.raider",
                "name": "Skype  - free video calling",
                "icon": "http://d2lh3rxs7crswz.cloudfront.net/com.skype.raider.png"
            },
            {
                "package_name": "com.autodesk.autocadws",
                "name": "AutoCAD WS",
                "icon": "http://d2lh3rxs7crswz.cloudfront.net/com.autodesk.autocadws.png"
            }
        ]
}

Errors

AppAware DEV API returns a standardized JSON response in case of an invalid request. (only Internal Server Error (500) may fail to return one)

http://dev.appaware.com/1/top.json?d=hour&t=popular&c=0&cc=worldwide&num=5&page=1&client_token=WRONG_CLIENT_TOKEN 

{
    "status_code": 400,
    "message": "Please provide a valid client_token",
    "request": "https://dev.appaware.com/1/app/top.json?d=day&t=popular&c=0&cc=worldwide&num=5&page=1&client_token=WRONG_CLIENT_TOKEN"
}