API Documentation for App Store & Google Play Store & Dashboard
Introduction
Some of the Mobile Action services can be accessed through REST based APIs. This feature is available for enterprise customers. Contact sales for further information.
API is designed around REST principles. Our API is designed to have predictable, resource-oriented URLs and to use HTTP response codes to indicate API errors. We use built-in HTTP features, like HTTP headers and HTTP verbs, which can be understood by off-the-shelf HTTP clients. JSON will be returned in all responses from the API, including errors.
Usage Guideline
Every API user has an API_KEY that is provided by Mobile Action. You should include your API_KEY within your API requests as in the example.
Contact support team for further information.
Example
curl "https://api.mobileaction.co/appstore-keyword-ranking/366562751/US/ticket/keywordrankings?token=YOUR_API_KEY"
Remaining Credits (headers)
Credit information for the current period (hours, days,...) is provided through response headers after each successful request.
Example
curl "https://api.mobileaction.co/appstore-appinfo-v2/app/simple/US?trackIds=284882215&token=YOUR_API_KEY"
Response Headers
| Field | Description |
|---|---|
X-Credit-Cost | Credit cost of the endpoint |
X-Credit-Remaining | Remaining credits for the current period |
X-Credit-Reset | Remaining credit reset time in seconds |
Remaining Credits Endpoint
Returns detailed credit status.
GET /api-key
Response Fields
| Field | Description |
|---|---|
status | Status of the request |
data | JSON object contains the data |
creditTotal | Total credits per period |
creditRemaining | Remaining credits for the current period |
creditResetPeriod | Credit period in hours |
creditResetTime | Remaining credit reset time in seconds |
Example Request
CURL "https://api.mobileaction.co/api-key?token=YOUR_API_KEY"
Example Response
{
"success": true,
"data": {
"creditTotal": 4000,
"creditRemaining": 3012,
"creditResetPeriod": 24,
"creditResetTime": 511
}
}
Credit Usage Rate Information
Dashboard Services
| Dashboard Services | Credit |
|---|---|
| Dashboard Apps | 5 |
| Daily Keyword Rankings | 50 |
| Add Keywords | 1 |
| Delete Keywords | 1 |
| Number of Keywords | 1 |
| App Search | 1 |
| App Search By Company URL | 10 |
| Sales Metrics | 1 |
| Retention History | 1 |
| Keyword Spot | 3 |
App Store - Google Play Store Services
| App Store Services | Google Play Store Services | Credit |
|---|---|---|
| Keyword Services | Keyword Services | |
| Keyword Ranking | Keyword Ranking | 3 |
| Keyword History | Keyword History | 10 |
| Top Keywords | Top Keywords | 20 |
| Keyword Metadata | Keyword Metadata | 5 |
| List of Apps | List of Apps | 5 |
| Organic Keywords | Organic Keywords | 50 |
| Category Services | Category Services | |
| Top Charts | Top Charts | 10 |
| Category Ranking | Category Ranking | 10 |
| Global Last Day Category Rankings | Global Last Day Category Rankings | 20 |
| New Apps | New Apps | 3 |
| App Services | App Services | |
| App Detail | App Detail | 5 |
| App Simple Information | App Simple Information | 1 |
| App Version List | App Version List | 10 |
| App Version List Detailed | App Version List Detailed | 50 |
| Developer Apps | Developer Apps | 5 |
| App Discovery | App Discovery | 1 |
| App Reviews | App Reviews | 5 |
| App Review Analysis | App Review Analysis | 10 |
| Download-Revenue Estimations | Download-Revenue Estimations | 100 |
| Monthly Global Download-Revenue Estimations | Monthly Global Download-Revenue Estimations | 2 |
| Estimations Services | Estimations Services | |
| Daily Active User (DAU) Estimations | Daily Active User (DAU) Estimations | 50 |
| Monthly Active User (MAU) Estimations | Monthly Active User (MAU) Estimations | 50 |
Ad Intelligence Services
| Ad Intelligence Services | Credit |
|---|---|
| Get Creatives | 200 |
| Check Badge | 5 |
| Country Distribution | 10 |
| Creative Dimension Distribution | 20 |
| Creative Type Distribution | 20 |
| Language Distribution | 10 |
| Network Distribution | 10 |
| Top Advertisers | 150 |
| Ad Publisher Creative Dimension Distribution | 50 |
Search Ads Services
| Search Ads Services | Credit |
|---|---|
| Search Ads Services | |
| Get Search Ads Integrations | 1 |
| Get MMP Integrations | 1 |
| Get Goals | 1 |
| Get Apps | 1 |
| Get Bid History Logs | 20 |
| Get Reports | 20 |
| Search Ads Insights | |
| Paid Keywords | 50 |
| Paying Apps | 50 |
Other Services
| App Services | Credit |
|---|---|
| App Match | 10 |
| Visibility Score | 10 |
App Store Categories
List of all App Store Categories.
| Category ID | Category Name |
|---|---|
36 | Overall |
6000 | Business |
6001 | Weather |
6002 | Utilities |
6003 | Travel |
6004 | Sports |
6005 | Social Networking |
6006 | Reference |
6007 | Productivity |
6008 | Photo & Video |
6009 | News |
6010 | Navigation |
6011 | Music |
6012 | Lifestyle |
6013 | Health & Fitness |
6014 | Games |
7001 | Action |
7002 | Adventure |
7003 | Arcade |
7004 | Board |
7005 | Card |
7006 | Casino |
7007 | Dice |
7008 | Educational |
7009 | Family |
7010 | Kids |
7011 | Music |
7012 | Puzzle |
7013 | Racing |
7014 | Role Playing |
7015 | Simulation |
7016 | Sports |
7017 | Strategy |
7018 | Trivia |
7019 | Word |
6015 | Finance |
6016 | Entertainment |
6017 | Education |
6018 | Books |
6020 | Medical |
6021 | Magazines & Newspapers |
6022 | Catalogs |
6023 | Food & Drink |
6024 | Shopping |
6025 | Stickers |
6026 | Developer Tools |
6027 | Graphics & Design |
Play Store Categories
List of all Google Play Store categories. This category id is specific to Mobile Action, Google Play Store only uses category names.
| Category ID | Category Name |
|---|---|
0 | BOOKS_AND_REFERENCE |
1 | BUSINESS |
2 | COMICS |
3 | COMMUNICATION |
4 | EDUCATION |
5 | ENTERTAINMENT |
6 | FINANCE |
7 | HEALTH_AND_FITNESS |
8 | LIBRARIES_AND_DEMO |
9 | LIFESTYLE |
10 | APP_WALLPAPER |
11 | MEDIA_AND_VIDEO |
12 | MEDICAL |
13 | MUSIC_AND_AUDIO |
14 | NEWS_AND_MAGAZINES |
15 | PERSONALIZATION |
16 | PHOTOGRAPHY |
17 | PRODUCTIVITY |
18 | SHOPPING |
19 | SOCIAL |
20 | SPORTS |
21 | TRANSPORTATION |
22 | TRAVEL_AND_LOCAL |
23 | TOOLS |
24 | WEATHER |
25 | APP_WIDGETS |
26 | OVERALL |
27 | GAME |
28 | GAME_ACTION |
29 | GAME_ADVENTURE |
30 | GAME_ARCADE |
31 | GAME_BOARD |
32 | GAME_CARD |
33 | GAME_CASINO |
34 | GAME_CASUAL |
35 | GAME_EDUCATIONAL |
36 | GAME_FAMILY |
37 | GAME_MUSIC |
38 | GAME_PUZZLE |
39 | GAME_RACING |
40 | GAME_ROLE_PLAYING |
41 | GAME_SIMULATION |
42 | GAME_SPORTS |
43 | GAME_STRATEGY |
44 | GAME_TRIVIA |
45 | GAME_WORD |
46 | MAPS_AND_NAVIGATION |
47 | ANDROID_WEAR |
48 | ART_AND_DESIGN |
49 | AUTO_AND_VEHICLES |
50 | BEAUTY |
51 | DATING |
52 | EVENTS |
53 | HOUSE_AND_HOME |
54 | PARENTING |
55 | VIDEO_PLAYERS |
56 | FOOD_AND_DRINK |
57 | FAMILY |