Introduction
Some of the MobileAction 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 MobileAction. You should include your API_KEY within your API requests as in the example.
TIP
Contact support team for further information.
curl "https://api.mobileaction.co/appstore-keyword-ranking/366562751/US/ticket/keywordrankings?startDate=2025-01-01&endDate=2025-01-15&token=YOUR_API_KEY"Remaining Credits (headers)
Credit information for the current period (hours, days,...) is provided through response headers after each successful request.
curl "https://api.mobileaction.co/appstore-appinfo-v2/app/simple/US?trackIds=284882215&token=YOUR_API_KEY"Response Header
| 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-keyResponse 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"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 |
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 Name | Category ID |
|---|---|
| Overall | 36 |
| Business | 6000 |
| Weather | 6001 |
| Utilities | 6002 |
| Travel | 6003 |
| Sports | 6004 |
| Social Networking | 6005 |
| Reference | 6006 |
| Productivity | 6007 |
| Photo & Video | 6008 |
| News | 6009 |
| Navigation | 6010 |
| Music | 6011 |
| Lifestyle | 6012 |
| Health & Fitness | 6013 |
| Games | |
| Games Overall | 6014 |
| Action | 7001 |
| Adventure | 7002 |
| Arcade | 7003 |
| Board | 7004 |
| Card | 7005 |
| Casino | 7006 |
| Dice | 7007 |
| Educational | 7008 |
| Family | 7009 |
| Kids | 7010 |
| Music | 7011 |
| Puzzle | 7012 |
| Racing | 7013 |
| Role Playing | 7014 |
| Simulation | 7015 |
| Sports | 7016 |
| Strategy | 7017 |
| Trivia | 7018 |
| Word | 7019 |
| Finance | 6015 |
| Entertainment | 6016 |
| Education | 6017 |
| Books | 6018 |
| Medical | 6020 |
| Magazines & Newspapers | 6021 |
| Catalogs | 6022 |
| Food & Drink | 6023 |
| Shopping | 6024 |
| Stickers | 6025 |
| Developer Tools | 6026 |
| Graphics & Design | 6027 |
Google Play Store Categories
List of all Google Play Store categories. This category id is specific to MobileAction, Google Play Store only uses category names.
| Category Name | Category ID |
|---|---|
| OVERALL | 26 |
| BOOKS_AND_REFERENCE | 0 |
| BUSINESS | 1 |
| COMICS | 2 |
| COMMUNICATION | 3 |
| EDUCATION | 4 |
| ENTERTAINMENT | 5 |
| FINANCE | 6 |
| HEALTH_AND_FITNESS | 7 |
| LIBRARIES_AND_DEMO | 8 |
| LIFESTYLE | 9 |
| APP_WALLPAPER | 10 |
| MEDIA_AND_VIDEO | 11 |
| MEDICAL | 12 |
| MUSIC_AND_AUDIO | 13 |
| NEWS_AND_MAGAZINES | 14 |
| PERSONALIZATION | 15 |
| PHOTOGRAPHY | 16 |
| PRODUCTIVITY | 17 |
| SHOPPING | 18 |
| SOCIAL | 19 |
| SPORTS | 20 |
| TRANSPORTATION | 21 |
| TRAVEL_AND_LOCAL | 22 |
| TOOLS | 23 |
| WEATHER | 24 |
| APP_WIDGETS | 25 |
| GAME | |
| GAME | 27 |
| GAME_ACTION | 28 |
| GAME_ADVENTURE | 29 |
| GAME_ARCADE | 30 |
| GAME_BOARD | 31 |
| GAME_CARD | 32 |
| GAME_CASINO | 33 |
| GAME_CASUAL | 34 |
| GAME_EDUCATIONAL | 35 |
| GAME_FAMILY | 36 |
| GAME_MUSIC | 37 |
| GAME_PUZZLE | 38 |
| GAME_RACING | 39 |
| GAME_ROLE_PLAYING | 40 |
| GAME_SIMULATION | 41 |
| GAME_SPORTS | 42 |
| GAME_STRATEGY | 43 |
| GAME_TRIVIA | 44 |
| GAME_WORD | 45 |
| MAPS_AND_NAVIGATION | 46 |
| ANDROID_WEAR | 47 |
| ART_AND_DESIGN | 48 |
| AUTO_AND_VEHICLES | 49 |
| BEAUTY | 50 |
| DATING | 51 |
| EVENTS | 52 |
| HOUSE_AND_HOME | 53 |
| PARENTING | 54 |
| VIDEO_PLAYERS | 55 |
| FOOD_AND_DRINK | 56 |
| FAMILY | 57 |