Mobile Action API Documentation

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