Mobile Action API Documentation

Keyword Services

This section describes Google Play related API services.

Keyword Ranking ( 3 Credits / Request )

Provides single day's keyword ranking for given keyword list and track id of an app in Google Play.

GET /playstore-keyword-ranking/{trackId}/{countryCode}/keywordrankings?keywords={keywords}&date={date}

Request Parameters

Parameter Description
trackId (required) Google Play track id of app
countryCode (required) Two letter country code
keywords (required) Comma separated keyword list (max 100 keywords are allowed)
date (optional) YYYY-MM-DD formatted date, yesterday is used if omitted.

Response Fields

Field Description
trackId Google Play track id of app
keyword Keyword
countryCode Two letter country code
date Date in epoch time format
rank Keyword ranking for current day

Example request

curl "https://api.mobileaction.co/playstore-keyword-ranking/com.facebook.katana/US/keywordrankings?keywords=face&token=YOUR_API_KEY"

Example response

[
  {
    "trackId":"com.facebook.katana",
    "keyword":"face",
    "rank":1,
    "countryCode":"US",
    "date":1480579200000
    }
]

Keyword History ( 10 Credits / Request )

Provides historic keyword ranking for given keyword and track id of an app in Google Play. Max 30 days of history is allowed for a single request.

GET /playstore-keyword-ranking/{trackId}/{countryCode}/{keyword}/keywordrankings?startDate={startDate}&endDate={endDate}

Request Parameters

Parameter Description
trackId (required) Google Play track id of app
countryCode (required) Two letter country code
keywords (required) Comma separated keyword list (max 100 keywords are allowed)
date (optional) YYYY-MM-DD formatted date, yesterday is used if omitted.
startDate (required) YYYY-MM-DD formatted date, history start date, inclusive.
endDate (required) YYYY-MM-DD formatted date, history end date, inclusive.

Response Fields

Field Description
trackId Google Play track id of app
keyword Keyword
countryCode Two letter country code
date Date in epoch time format
rank Keyword ranking for current day

Example request

curl "https://api.mobileaction.co/playstore-keyword-ranking/com.facebook.katana/US/face/keywordrankings?startDate=2017-01-01&endDate=2017-01-15&token=YOUR_API_KEY"

Example response

[
  {
    "trackId":"com.facebook.katana",
    "keyword":"face",
    "rank":1,
    "countryCode":"US",
    "date":1480579200000
    }
]

Top Keywords ( 20 Credits / Request )

Provides single day's top keywords for given track id of an app in Google Play.

GET /playstore-keyword-ranking/{trackId}/{countryCode}/top-keywords?date={date}&limit={limit}

Request Parameters

Parameter Description
trackId (required) Google Play track id of the app
countryCode (required) Two letter country code
date (required) YYYY-MM-DD formatted date
limit (optional) Requested number of keywords in result, default value is 100

Response Fields

Field Description
keyword Keyword
searchVolume Search volume of keyword
rank Keyword ranking of the app

Example request

curl "https://api.mobileaction.co/playstore-keyword-ranking/com.facebook.katana/US/top-keywords?date=2018-06-26&limit=150&token=YOUR_API_KEY"

Example response

[
  {
    "keyword":"facebook",
    "searchVolume":85,
    "rank":1
  },
  {
    "keyword":"face",
    "searchVolume":75,
    "rank":1
  }
]

Keyword Metadata ( 5 Credits / Request )

Provides last day's keyword meta-data for given keyword for Google Play.

GET /playstore-keyword-ranking/{countryCode}/keyword-metadata?keyword={keyword}

Request Parameters

Parameter Description
countryCode (required) Two letter country code
keyword (required) Keyword

Response Fields

Field Description
keyword Keyword
countryCode Two letter country code
numberOfApps Number of apps
searchVolume Search Volume
playChance Chance
brandApp Brand app track id

Example request

curl "https://api.mobileaction.co/playstore-keyword-ranking/US/keyword-metadata?keyword=whatsapp&token=YOUR_API_KEY"

Example response

{
    "keyword": "whatsapp",
    "countryCode": "US",
    "numberOfApps": 249,
    "searchVolume": 61,
    "playChance": 56.3,
    "brandApp": "com.whatsapp"
}

List of Apps ( 5 Credits / Request )

Provides app list for given keyword for Google Play.

GET /playstore-keyword-ranking/{countryCode}/keyword-apps?keyword={keyword}

Request Parameters

Parameter Description
countryCode (required) Two letter country code
keyword (required) Keyword

Response Fields

Field Description
keyword Keyword
countryCode Two letter country code
lastUpdateDate Last update date
apps List of track id for PlayStore apps

Example request

curl "https://api.mobileaction.co/playstore-keyword-ranking/US/keyword-apps?keyword=twitter&token=YOUR_API_KEY"

Example response

{
    "keyword": "twitter",
    "countryCode": "US",
    "lastUpdateDate": 1535698790000,
    "apps": [
        "com.twitter.android",
        "tv.periscope.android",
        "co.vine.android",
        "com.klinker.android.twitter_l",
        "com.handmark.tweetcaster",
        "tweeter.gif.twittervideodownloader",
        "com.arthurivanets.owly",
        "it.mvilla.android.fenix2",
        "com.dwdesign.tweetings",
        "twitter.android.finch",
        "org.mariotaku.twidere",
        "nubianplanet.com",
        "com.innovatty.followersplus",
        "com.echofon",
        "com.tweetkit.app",
        "com.filippocicirelli.followers",
        "com.levelup.touiteur",
        "com.twidroid",
        "com.rosteam.saveinstaa",
        "com.ubersocialpro",
        "ccstudio.followers.unfollowers.twitter"
    ]
}

Organic Keywords ( 50 Credits / Request )

Provides list of organic keywords and their rankings for Google Play.

GET /playstore-keyword-ranking/{trackId}/{countryCode}/organic-keywords?date={date}

Request Parameters

Parameter Description
trackId (required) Track id of the app
countryCode (required) Two letter country code
date (required) YYYY-MM-DD formatted date

Response Fields

Field Description
trackId Track id of the app
countryCode Two letter country code
date Given date
rankings List of keywords and their rankings

Example request

curl "https://api.mobileaction.co/playstore-keyword-ranking/com.facebook.katana/US/organic-keywords?date=2019-06-13&token=YOUR_API_KEY"

Example response

{
    "trackId": "com.facebook.katana",
    "countryCode": "US",
    "date": 1560409200000,
    "rankings": [
        {
            "keyword": "fees",
            "rank": 1
        },
        {
            "keyword": "fase",
            "rank": 1
        },
        {
            "keyword": "gace",
            "rank": 1
        },
        {
            "keyword": "f",
            "rank": 1
        }
    ]
}

Category Services

Top Charts ( 10 Credits / Request )

Provides top charts information for given category, country, ranking type and device.

GET /playstore-category/topcharts/{category}/{countryCode}/{categoryType}

Request Parameters

Parameter Description
category (required) Category name
countryCode (required) Two letter country code
categoryType (required) FREE, PAID, GROSSING
date (required) YYYY-MM-DD formatted date

Response Fields

Field Description
trackId Google Play track id of the app
category Category id
rank Category ranking value
date Date in epoch time format
type 0=Free, 1= Paid, 2=Grossing

Example request

curl "https://api.mobileaction.co/playstore-category/topcharts/FAMILY/US/FREE?date=2019-03-01&token=YOUR_API_KEY"

Example response

[
    {
        "trackId": "com.roblox.client",
        "category": 57,
        "rank": 1,
        "date": 1551436343000,
        "type": 0
    },
    {
        "trackId": "com.google.android.apps.youtube.kids",
        "category": 57,
        "rank": 2,
        "date": 1551436343000,
        "type": 0
    },
    {
        "trackId": "com.duolingo",
        "category": 57,
        "rank": 3,
        "date": 1551436343000,
        "type": 0
    },
    {
        "trackId": "com.superbinogo.jungleboyadventure",
        "category": 57,
        "rank": 4,
        "date": 1551436343000,
        "type": 0
    },
    {
        "trackId": "com.WildWorks.RyansTag",
        "category": 57,
        "rank": 5,
        "date": 1551436343000,
        "type": 0
    },
    {
        "trackId": "org.pbskids.video",
        "category": 57,
        "rank": 6,
        "date": 1551436343000,
        "type": 0
    },
    {
        "trackId": "com.KnowledgeAdventure.SchoolOfDragons",
        "category": 57,
        "rank": 7,
        "date": 1551436343000,
        "type": 0
    },
    {
        "trackId": "com.disney.datg.videoplatforms.android.watchdc",
        "category": 57,
        "rank": 8,
        "date": 1551436343000,
        "type": 0
    },
    {
        "trackId": "org.pbskids.gamesapp",
        "category": 57,
        "rank": 9,
        "date": 1551436343000,
        "type": 0
    },
    {
        "trackId": "no.mobitroll.kahoot.android",
        "category": 57,
        "rank": 10,
        "date": 1551436343000,
        "type": 0
    }
]

Category Ranking ( 10 Credits / Request )

Provides category rankings history of an app in Google Play. Max 30 days of history is allowed for a single request.

GET /playstore-category/{trackId}/{country}&startDate={startDate}&endDate={endDate}

Request Parameters

Parameter Description
trackId (required) Google Play track id of app
countryCode (required) Two letter country code
startDate (required) YYYY-MM-DD formatted date, history start date, inclusive.
endDate (required) YYYY-MM-DD formatted date, history end date, exclusive.

Response Fields

Field Description
trackId Google Play track id of app
countryCode Two letter country code, categories are mapped by this
categoryName Category name, ranking type and ranking data are mapped by this
rankingType 0 = FREE, 1 = PAID, 2 = GROSSING
date Date in timestamp format
ranking Category ranking value

Example request

curl "https://api.mobileaction.co/playstore-category/com.facebook.katana/US?startDate=2019-09-01&endDate=2019-09-03&token=YOUR_API_KEY"

Example response

{
    "trackId": "com.facebook.katana",
    "countryCode": "US",
    "ranksByCategoryNames": [
        {
            "categoryName": "OVERALL",
            "rankings": [
                {
                    "rankingType": 0,
                    "ranksByDate": [
                        {
                            "date": 1567321200000,
                            "rank": 37
                        },
                        {
                            "date": 1567407600000,
                            "rank": 52
                        }
                    ]
                },
                {
                    "rankingType": 2,
                    "ranksByDate": [
                        {
                            "date": 1567321200000,
                            "rank": 261
                        },
                        {
                            "date": 1567407600000,
                            "rank": 266
                        }
                    ]
                }
            ]
        },
        {
            "categoryName": "SOCIAL",
            "rankings": [
                {
                    "rankingType": 0,
                    "ranksByDate": [
                        {
                            "date": 1567321200000,
                            "rank": 4
                        },
                        {
                            "date": 1567407600000,
                            "rank": 4
                        }
                    ]
                },
                {
                    "rankingType": 2,
                    "ranksByDate": [
                        {
                            "date": 1567321200000,
                            "rank": 10
                        },
                        {
                            "date": 1567407600000,
                            "rank": 10
                        }
                    ]
                }
            ]
        }
    ]
}

Global Last Day Category Rankings ( 20 Credits / Request )

Provides global category rankings of an app in PlayStore for last day.

GET /playstore-category/global-rankings-last-day/{trackId}

Request Parameters

Parameter Description
trackId (required) Google Play track id of app

Response Fields

Field Description
trackId Google Play track id of app
countryCode Two letter country code, categories are mapped by this
categoryName Category name, ranking type and ranking data are mapped by this
rankingType FREE, PAID, GROSSING
date Date in LocalDateTime format
ranking Category ranking value

Example request

curl "https://api.mobileaction.co/playstore-category/global-rankings-last-day/com.facebook.katana?token=YOUR_API_KEY"

Example response

{
  "trackId": "com.facebook.katana",
  "ranksByCategory": {
    "PK": {
      "OVERALL": [
        {
          "rankingType": "FREE",
          "rankingsByDate": [
            {
              "date": "2019-06-18T07:00:00",
              "ranking": 9
            }
          ]
        },
        {
          "rankingType": "GROSSING",
          "rankingsByDate": [
            {
              "date": "2019-06-18T07:00:00",
              "ranking": 444
            }
          ]
        }
      ],
      "SOCIAL": [
        {
          "rankingType": "FREE",
          "rankingsByDate": [
            {
              "date": "2019-06-18T07:00:00",
              "ranking": 2
            }
          ]
        },
        {
          "rankingType": "GROSSING",
          "rankingsByDate": [
            {
              "date": "2019-06-18T07:00:00",
              "ranking": 42
            }
          ]
        }
      ]
    }
  }
}

New Apps ( 3 Credits / Request )

Provides app infos for newly released app for given country and category.

GET /playstore-category/new-apps/{category}/{countryCode}/{rankingType}?date={date}

Request Parameters

Parameter Description
category (required) Category name
countryCode (required) Two letter country code
rankingType (required) FREE, PAID or GROSSING
date (optional) YYYY-MM-DD formatted date, default value is yesterday's date

Response Fields

Field Description
trackId Google Play track id of app
name App name
url App URL
price App price, empty if app is free
iconUrl URL containing app's icon
developerId Google Play Store name of the developer
releaseDate Release date of the app in date-time format
developerName Name of the developer

Example request

curl "https://api.mobileaction.co/playstore-category/new-apps/BOOKS_AND_REFERENCE/US/FREE?token=YOUR_API_KEY"

Example response

[
    {
        "trackId": "com.aorio.freediamond.freefirediamondforfree1",
        "name": "Guide and Free Diamonds for Free App",
        "url": "",
        "price": "",
        "iconUrl": "https://play-lh.googleusercontent.com/kMgW0BSLyIZpjxr9wN6AInHd3kf7v5Qm7iTegzoxofyw4t0k9krbjaiVjQF7mqBneMCR",
        "category": "",
        "developerId": "Aorio Apps",
        "releaseDate": "2021-04-28T00:00:00",
        "developerName": "Aorio Apps"
    },
    {
        "trackId": "com.istory.lite",
        "name": "iStory Lite-Read & Write Stories",
        "url": "",
        "price": "",
        "iconUrl": "https://play-lh.googleusercontent.com/i7-mEqMDSyzj7QqCj2Crb3wDyVyFTjBqqISZmc9KiqeG8sbWcFiwWLuk_MgincDRZgOM",
        "category": "",
        "developerId": "Reader Studio",
        "releaseDate": "2021-04-29T00:00:00",
        "developerName": "Reader Studio"
    }
]

App Services

App Detail ( 5 Credits / Request )

This endpoint provides detailed info of the apps in PlayStore.

GET /playstore-appinfo-v2/app/detailed/{trackId}
GET /playstore-appinfo-v2/app/detailed/{trackId}/{langCode}

Request Parameters

Parameter Description
trackId (required) PlayStore track id of app.
langCode (optional) Two letter language code of the app.EN is default.
Supported Codes : [ EN, EN_AU, EN_GB, EN_CA, ZH, ZH_TW, TR, ES, ES_MX, DE, IT, JA, NL, RU, KO, AR, FR, PT_PT, PT_BR, ID, VI, TH, CS, DA, FI, EL, HE, HU, MS, NO, PL, RO, SK, SV ]

Response Fields

Field Description
langCode Two letter country code
version Version name
fileSize Size of the app for that version
supportUrl Support url of the app
name Name of the app
url Play store url of the app
developerId Owner of the app
price Price of the app
iconUrl Icon url of the app
category Category of the app
description Description of the app
screenshots Screenshot urls of the app
email Email of the app owner
lastUpdateDate Last update date of the app
userRating Average user rating for the app
numUserRating Number of user rating for the app
installRange Download number range of the app
offersInAppPurchase Whether the app offers in app purchase or not
numOfFiveRatings Number of five star ratings
numOfFourRatings Number of four star ratings
numOfThreeRatings Number of three star ratings
numOfTwoRatings Number of two star ratings
numOfOneRatings Number of one star ratings
topDeveloperBadge Whether the app has top developers badge
lastModified Last modified date of the app
whatsnew Whats new section of the app

Example request

curl "https://api.mobileaction.co/playstore-appinfo-v2/app/detailed/com.facebook.katana?token=YOUR_API_KEY"

Example response

{
    "trackId": "com.facebook.katana",
    "langCode": "en",
    "removed": false,
    "lastModified": 1555329905000,
    "name": "Facebook",
    "developerId": "Facebook",
    "price": "0",
    "iconUrl": "https://lh3.googleusercontent.com/ZZPdzvlpK9r_Df9C3M7j1rNRi7hhHRvPhlklJ3lfi5jk86Jd1s0Y5wcQ1QgbVaAP5Q=s180",
    "lastUpdateDate": 1554966000000,
    "version": "Varies with device",
    "description": "Keeping up with friends is faster and easier than ever. Share updates and photos, engage with friends and Pages, and stay connected to communities important to you. Features on the Facebook app include: * Connect with friends and family and meet new people on your social media network * Set status updates & use Facebook emoji to help relay what’s going on in your world * Share photos, videos, and your favorite memories. * Get notifications when friends like and comment on your posts * Find local social events, and make plans to meet up with friends * Play games with any of your Facebook friends * Backup photos by saving them in albums * Follow your favorite artists, websites, and companies to get their latest news * Look up local businesses to see reviews, operation hours, and pictures * Buy and sell locally on Facebook Marketplace * Watch live videos on the go The Facebook app does more than help you stay connected with your friends and interests. It's also your personal organizer for storing, saving and sharing photos. It's easy to share photos straight from your Android camera, and you have full control over your photos and privacy settings. You can choose when to keep individual photos private or even set up a secret photo album to control who sees it. Facebook also helps you keep up with the latest news and current events around the world. Subscribe to your favorite celebrities, brands, news sources, artists, or sports teams to follow their newsfeeds, watch live streaming videos and be caught up on the latest happenings no matter where you are! The most important desktop features of Facebook are also available on the app, such as writing on timelines, liking photos, browsing for people, and editing your profile and groups. Now you can get early access to the next version of Facebook for Android by becoming a beta tester. Learn how to sign up, give feedback and leave the program in our Help Center: http://on.fb.me/133NwuP Sign up directly here: http://play.google.com/apps/testing/com.facebook.katana Problems downloading or installing the app? See http://bit.ly/GPDownload1 Still need help? Please tell us more about the issue. http://bit.ly/invalidpackage Facebook is only available for users age 13 and over. Terms of Service: http://m.facebook.com/terms.php.",
    "offersInAppPurchase": true,
    "screenshotList": [
        "https://lh3.googleusercontent.com/JcPdPqplBxgG6dEQuxvuhO4jvE64AzxOCGWe8w55dMMeXU4rZs2MwpfGQTWvv6QR-g=w720-h310",
        "https://lh3.googleusercontent.com/w0kSYY7jlPjGDd3KEVgDTpzUf4k67G7rfELOf6qj1SSC7n6Ege44vp8QkeX57ZM6bFU=w720-h310",
        "https://lh3.googleusercontent.com/A4R7mxkLT6S6C1J-I3M4XWlSPj1YKSYQCp2s43Be5cB2E4xvbd1xhTRYJKMRImN5hrKW=w720-h310",
        "https://lh3.googleusercontent.com/ohTxUlC0GXQ1vM-FZmLrQRTRtvLE3AYPs29FlxccPmYqkJh7wm34TUMUUGPsRh4JFuw=w720-h310",
        "https://lh3.googleusercontent.com/ASS7ix2xHQpHc6epdV-vP2V6fNibGGz4_S1EPQW1x1S-HUQnpXdDje7d-6P_LMrJwlCt=w720-h310"
    ],
    "fileSize": "Varies with device",
    "supportUrl": "https://www.facebook.com/facebook",
    "url": "/store/apps/details?id=com.facebook.katana",
    "category": "SOCIAL",
    "categoryId": 19,
    "email": "[email protected]",
    "userRating": 4.1,
    "numUserRating": 86090514,
    "installRange": "1,000,000,000+",
    "numOfFiveRatings": 52334824,
    "numOfFourRatings": 12715155,
    "numOfThreeRatings": 7465861,
    "numOfTwoRatings": 3489945,
    "numOfOneRatings": 10084729,
    "topDeveloperBadge": false,
    "whatsnew": [],
    "inAppProducts": "$0.99 - $399.99 per item",
    "similarApps": [],
    "videoUrl": null,
    "videoFrameUrl": null
}

App Simple Information ( 1 Credit / Request )

Provides simplified information for given apps in PlayStore.

GET /playstore-appinfo-v2/app/simple/{langCode}?trackIds={trackIds}

Request Parameters

Parameter Description
trackIds (required) Comma separated list of PlayStore track ids of apps. Max. 10 apps are allowed.
langCode (required) Two letter language code of the app.

Response Fields

Field Description
trackId PlayStore track id of app
name Name of the app
developerId Id of the app owner
price App price information
iconUrl Url for up to date app icon
categoryId A code for the category of the app
categoryName Name of the category of the app
ratingCount Counts of the user ratings for the app
rating Average user rating value for the app
lastUpdate Last update date of the app

Example request

curl "https://api.mobileaction.co/playstore-appinfo-v2/app/simple/EN?trackIds=com.facebook.katana,com.instagram.android&token=YOUR_API_KEY"

Example response

[
  {
    "trackId": "com.facebook.katana",
    "name": "Facebook",
    "category": "SOCIAL",
    "categoryId": 19,
    "iconUrl": "https://lh3.googleusercontent.com/ccWDU4A7fX1R24v-vvT480ySh26AYp97g1VrIB_FIdjRcuQB2JP2WdY7h_wVVAeSpg=s180",
    "price": "0",
    "developerId": "Facebook",
    "rating": 4.1,
    "ratingCount": 88127734,
    "lastUpdate": 1560322800000
  },
  {
    "trackId": "com.instagram.android",
    "name": "Instagram",
    "category": "SOCIAL",
    "categoryId": 19,
    "iconUrl": "https://lh3.googleusercontent.com/aYbdIM1abwyVSUZLDKoE0CDZGRhlkpsaPOg9tNnBktUQYsXflwknnOn2Ge1Yr7rImGk=s180",
    "price": "0",
    "developerId": "Instagram",
    "rating": 4.5,
    "ratingCount": 83575867,
    "lastUpdate": 1560841200000
  }
]

App Version List ( 1 Credit / Request )

This endpoint provides version list (app update timeline) of the apps in PlayStore.

GET /playstore-appinfo-v2/versions/{trackId}/{langCode}?startDate={startDate}&endDate={endDate}

Request Parameters

Parameter Description
trackId (required) AppStore track id of app
langCode (required) Two letter language code
startDate (required) YYYY-MM-DD formatted date, history start date, inclusive
endDate (required) YYYY-MM-DD formatted date, history end date, exclusive

Response Fields

Field Description
versionString Version identifier
versionDate Release date of version
releaseNotes Release notes
differences List contains the information about which properties of apps are changed in the last version
Possible values of differences field
AVERAGE_USER_RATING
USER_RATING_COUNT
CURRENT_VERSION_RELEASE_DATE
NAME
DEVELOPER_ID
PRICE
ICON
SUPPORT_URL
VERSION
DESCRIPTION
CATEGORY
SCREENSHOTS
FILE_SIZE
RELEASE_NOTES
HAS_INAPP_PURCHASES
VIDEO_PREVIEWS
SIMILAR_APPS
SHORT_DESCRIPTION
COMMENT_COUNT
EMAIL
INSTALL_RANGE
TOP_DEVELOPER_BADGE
INAPP_PRODUCTS

Example request

curl "https://api.mobileaction.co/playstore-appinfo-v2/versions/com.abtnprojects.ambatana/en?startDate=2020-02-01&endDate=2020-02-10&token=YOUR_API_KEY"

Example response

[
    {
        "versionString": "2.9.16",
        "versionDate": "2020-02-05T08:00:00",
        "releaseNotes": "What’s new: • Revamped user reviews: buy and sell with confidence and show everyone you’re the real deal! • Buyers and sellers will now have 7 days to review one another after completing a transaction - and your reviews won’t be visible until you’ve both completed one or the 7-day window has ended Like it? LOVE it? Share your feedback and rate us in the Google Play Store to let us know! And if you have any questions or suggestions, give us a shout at [email protected]! the letgo team",
        "differences": [
            "CURRENT_VERSION_RELEASE_DATE",
            "ICON",
            "VERSION",
            "SCREENSHOTS",
            "FILE_SIZE",
            "RELEASE_NOTES",
            "SIMILAR_APPS",
            "INSTALL_RANGE",
            "USER_RATING_COUNT",
            "SHORT_DESCRIPTION",
            "COMMENT_COUNT",
            "VIDEO_PREVIEWS"
        ]
    },
    {
        "versionString": "2.9.15",
        "versionDate": "2020-02-04T08:00:00",
        "releaseNotes": "What’s new:,• Revamped user reviews: buy and sell with confidence and show everyone you’re the real deal!,• Buyers and sellers will now have 7 days to review one another after completing a transaction - and your reviews won’t be visible until you’ve both completed one or the 7-day window has ended,,Like it? LOVE it? Share your feedback and rate us in the Google Play Store to let us know! And if you have any questions or suggestions, give us a shout at [email protected]!,,the letgo team",
        "differences": [
            "CURRENT_VERSION_RELEASE_DATE",
            "VERSION",
            "RELEASE_NOTES",
            "SIMILAR_APPS",
            "USER_RATING_COUNT"
        ]
    }
]

App Version List Detailed ( 50 Credits / Request )

This endpoint provides version list (app update timeline) with changed values of the apps in PlayStore. Max. 30 days of data allowed for a single request.

GET /playstore-appinfo-v2/versions/detailed/{trackId}/{langCode}?startDate={startDate}&endDate={endDate}

Request Parameters

Parameter Description
trackId (required) PlayStore track id of app
langCode (required) Two letter language code
startDate (required) YYYY-MM-DD formatted date, history start date, inclusive
endDate (required) YYYY-MM-DD formatted date, history end date, exclusive

Response Fields

Field Description
versionDate Release date of version
differences List contains the information about which properties of apps are changed in the last version
newData JSON object contains new values of changed properties
oldData JSON object contains old values of changed properties

Example request

curl "https://api.mobileaction.co/playstore-appinfo-v2/versions/detailed/com.abtnprojects.ambatana/en?startDate=2020-02-01&endDate=2020-02-10&token=YOUR_API_KEY"

Example response

[
    {
        "versionDate": "2020-02-05T08:00:00",
        "differences": [
            "CURRENT_VERSION_RELEASE_DATE",
            "ICON",
            "VERSION",
            "SCREENSHOTS",
            "FILE_SIZE",
            "RELEASE_NOTES",
            "SIMILAR_APPS",
            "INSTALL_RANGE",
            "USER_RATING_COUNT",
            "SHORT_DESCRIPTION",
            "COMMENT_COUNT",
            "VIDEO_PREVIEWS"
        ],
        "newData": {
            "versionDate": "2020-02-05T08:00:00",
            "versionString": "2.9.16",
            "fileSize": "22861173",
            "iconUrl": "https://lh3.googleusercontent.com/5sg1kvqmYDZS4tB8Ub8t3UwILVfHwS7To4lJy_pCbjRQ7HStTe45GKM1NpXC0bgfiw",
            "screenshots": [
                "https://lh3.googleusercontent.com/YA0EtrBV-wgt3IzbfE97HYZEM9a64oOWEHxdx793eOUi4KCrkxKLFSB8MRgwaIs5hM8",
                "https://lh3.googleusercontent.com/TzsfEztqHDHiXT_4RFOpw5duTk45HZTXzVb5Te33SKKsuQGZsmEf0QYfRAy_7oKkZl08",
                "https://lh3.googleusercontent.com/jlQZaIs3NOu_36Hh44rIGpA7lw26noZrD4IRJUHhwHpH4009A-nL0a07HEAMPY_Vxw",
                "https://lh3.googleusercontent.com/cKVxGXJVNJ-7Oj7F9ATtcUX7fFLpmQh_Q3C72ZZPb0Hw97tIqEKiMP34q5qjcUpbwA",
                "https://lh3.googleusercontent.com/ElKvyMAPpssU7pIKU959kXEFDBI8bBOXcb-t5AIf61Hr-VW2UVVGsY8aJbE6ebuH"
            ],
            "installRange": "50000000+",
            "releaseNotes": [
                "What’s new: • Revamped user reviews: buy and sell with confidence and show everyone you’re the real deal! • Buyers and sellers will now have 7 days to review one another after completing a transaction - and your reviews won’t be visible until you’ve both completed one or the 7-day window has ended Like it? LOVE it? Share your feedback and rate us in the Google Play Store to let us know! And if you have any questions or suggestions, give us a shout at [email protected]! the letgo team"
            ],
            "similarApps": [
                "com.ebay.mobile",
                "com.app.offerit",
                "com.shpock.android",
                "com.contextlogic.geek",
                "com.codified.hipyard",
                "com.mercariapp.mercari",
                "com.modanisa"
            ],
            "shortDescription": "Find the best Local Deals for Online Shopping & let go of your Used Stuff! ",
            "commentCount": 436618,
            "videoPreviews": [
                {
                    "previewUrl": null,
                    "frameUrl": null,
                    "phoneFrameUrl": "https://lh3.googleusercontent.com/q9tiEM1RjY-nnHLryc4DoCIMhbUqhy8HiOUWwuXc89DoAxi-xt4OfXucLJTHInk6JwcK"
                }
            ],
            "userRatingCount": 1362627
        },
        "oldData": {
            "versionDate": "2020-02-04T08:00:00",
            "versionString": "2.9.15",
            "fileSize": "20M",
            "iconUrl": "https://lh3.googleusercontent.com/5sg1kvqmYDZS4tB8Ub8t3UwILVfHwS7To4lJy_pCbjRQ7HStTe45GKM1NpXC0bgfiw=s180",
            "screenshots": [
                "https://lh3.googleusercontent.com/YA0EtrBV-wgt3IzbfE97HYZEM9a64oOWEHxdx793eOUi4KCrkxKLFSB8MRgwaIs5hM8=w720-h310",
                "https://lh3.googleusercontent.com/TzsfEztqHDHiXT_4RFOpw5duTk45HZTXzVb5Te33SKKsuQGZsmEf0QYfRAy_7oKkZl08=w720-h310",
                "https://lh3.googleusercontent.com/jlQZaIs3NOu_36Hh44rIGpA7lw26noZrD4IRJUHhwHpH4009A-nL0a07HEAMPY_Vxw=w720-h310",
                "https://lh3.googleusercontent.com/cKVxGXJVNJ-7Oj7F9ATtcUX7fFLpmQh_Q3C72ZZPb0Hw97tIqEKiMP34q5qjcUpbwA=w720-h310",
                "https://lh3.googleusercontent.com/ElKvyMAPpssU7pIKU959kXEFDBI8bBOXcb-t5AIf61Hr-VW2UVVGsY8aJbE6ebuH=w720-h310"
            ],
            "installRange": "50,000,000+",
            "releaseNotes": [
                "What’s new:",
                "• Revamped user reviews: buy and sell with confidence and show everyone you’re the real deal!",
                "• Buyers and sellers will now have 7 days to review one another after completing a transaction - and your reviews won’t be visible until you’ve both completed one or the 7-day window has ended",
                "",
                "Like it? LOVE it? Share your feedback and rate us in the Google Play Store to let us know! And if you have any questions or suggestions, give us a shout at [email protected]!",
                "",
                "the letgo team"
            ],
            "similarApps": [
                "com.thirdrock.fivemiles",
                "com.offerup",
                "com.ebay.mobile",
                "com.shpock.android",
                "com.contextlogic.geek"
            ],
            "userRatingCount": 1361294
        }
    },
    {
        "versionDate": "2020-02-04T08:00:00",
        "differences": [
            "CURRENT_VERSION_RELEASE_DATE",
            "VERSION",
            "RELEASE_NOTES",
            "SIMILAR_APPS",
            "USER_RATING_COUNT"
        ],
        "newData": {
            "versionDate": "2020-02-04T08:00:00",
            "versionString": "2.9.15",
            "releaseNotes": [
                "What’s new:",
                "• Revamped user reviews: buy and sell with confidence and show everyone you’re the real deal!",
                "• Buyers and sellers will now have 7 days to review one another after completing a transaction - and your reviews won’t be visible until you’ve both completed one or the 7-day window has ended",
                "",
                "Like it? LOVE it? Share your feedback and rate us in the Google Play Store to let us know! And if you have any questions or suggestions, give us a shout at [email protected]!",
                "",
                "the letgo team"
            ],
            "similarApps": [
                "com.thirdrock.fivemiles",
                "com.offerup",
                "com.ebay.mobile",
                "com.shpock.android",
                "com.contextlogic.geek"
            ],
            "userRatingCount": 1361294
        },
        "oldData": {
            "versionDate": "2020-01-30T08:00:00",
            "versionString": "2.9.14",
            "releaseNotes": [
                "- Introducing letgo Reveal: Simply point your camera at your stuff to see what similar items are selling for on letgo. Tap to list and we'll fill in the details.",
                "",
                "Make sure to give it a try, and keep the feedback coming, we love hearing from you!",
                "
Love it? Review and rate us! Contact [email protected] if you have any suggestions or need help"
            ],
            "similarApps": [
                "com.thirdrock.fivemiles",
                "com.offerup",
                "com.ebay.mobile",
                "com.app.offerit",
                "com.shpock.android"
            ],
            "userRatingCount": 1358897
        }
    }
]

Developer Apps ( 5 Credits / Request )

This endpoint provides app details for the given developer and country in PlayStore.

GET /playstore-appinfo-v2/app/developer/{developerName}/{langCode}

Request Parameters

Parameter Description
developerName (required) Name of the developer
langCode (required) Two letter language code

Response Fields

Field Description
trackId Track id of the app
name Name of the app
iconUpl URL for app display image
price Price of the app
category Category id of the app
developerName Name of the developer
lastUpdateTime Timestamp of the last update

Example request

curl "https://api.mobileaction.co/playstore-appinfo-v2/app/developer/Playtika/EN?token=YOUR_API_KEY"

Example response

[
    {
        "trackId": "air.com.playtika.cvs",
        "name": "Vegas Downtown Slots™ - Slot Machines & Word Games",
        "iconUrl": "https://lh3.googleusercontent.com/6lbF-g6YBFwr9wbgdgvTVk3L1rDHDQYdzDS7JSKApyGBUELcdKf2rP6jz5OYfikqMWx0=s180",
        "price": "0",
        "category": "GAME_CASINO",
        "categoryId": 33,
        "developerId": "Playtika",
        "developerName": "Playtika",
        "lastUpdateTime": 1545292800000
    },
    {
        "trackId": "air.com.playtika.slotomania",
        "name": "Slotomania™ Slots Casino: Vegas Slot Machine Games",
        "iconUrl": "https://lh3.googleusercontent.com/PyXb-ltmxVmH8oppeASQsIRmnmTaI6ypp4RVDZ_25aKvav6GsXvFFVS-wYU1uggAEic=s180",
        "price": "0",
        "category": "GAME_CASINO",
        "categoryId": 33,
        "developerId": "Playtika",
        "developerName": "Playtika",
        "lastUpdateTime": 1554966000000
    },
    {
        "trackId": "com.bigblueparrot.pokerfriends",
        "name": "Poker Heat™ - Free Texas Holdem Poker Games",
        "iconUrl": "https://lh3.googleusercontent.com/TWdyOQlYq2HymGXCJ3-_ICFQ2sKxYek-aT0zl6qW4by0URmK1KIIgeQh2Eta_ab0D1Y=s180",
        "price": "0",
        "category": "GAME_CARD",
        "categoryId": 32,
        "developerId": "Playtika",
        "developerName": "Playtika",
        "lastUpdateTime": 1547625600000
    },
    {
        "trackId": "com.playtika.caesarscasino",
        "name": "Caesars Slots: Free Slot Machines and Casino Games",
        "iconUrl": "https://lh3.googleusercontent.com/wRifbj53rOZ2P-R2wAC337gi8XLk1uRrnmxeuekPqgCXdFCA3wdti1eikJYRa1lClQ8=s180",
        "price": "0",
        "category": "GAME_CASINO",
        "categoryId": 33,
        "developerId": "Playtika",
        "developerName": "Playtika",
        "lastUpdateTime": 1555311600000
    },
    {
        "trackId": "com.playtika.colorio",
        "name": "Colorio.io",
        "iconUrl": "https://lh3.googleusercontent.com/6bcDDZ7HTzA4X0BeUbzVLFbhaKgJdKXg9aP68ohO-PIPTts4iWF3wbKGe3vAsnwVuGo=s180",
        "price": "0",
        "category": "GAME_CASUAL",
        "categoryId": 34,
        "developerId": "Playtika",
        "developerName": "Playtika",
        "lastUpdateTime": 1552892400000
    },
    {
        "trackId": "com.playtika.slotomania.gp.jp",
        "name": "スロットマニア・フィーバー~本場ラスベガススロット",
        "iconUrl": "https://lh3.googleusercontent.com/vSNsSCyK4elDTMYQuoTlwNpRhSW0k3sgFOsxwMBsWFaetGK6vjbQ64UUDZyLV4iY5JQ=s180",
        "price": "0",
        "category": "GAME_CASINO",
        "categoryId": 33,
        "developerId": "Playtika",
        "developerName": "Playtika",
        "lastUpdateTime": 1550044800000
    },
    {
        "trackId": "com.playtika.slotomania.ru",
        "name": "Слотомания",
        "iconUrl": "https://lh3.googleusercontent.com/kU7PfT7m-fdXUrTJ3S_7w17q2OZLrHinKC0IWKQ9gTpVnHPgZsunJ8KA9fhkh0022nE=s180",
        "price": "0",
        "category": "GAME_CASINO",
        "categoryId": 33,
        "developerId": "Playtika",
        "developerName": "Playtika",
        "lastUpdateTime": 1550736000000
    },
    {
        "trackId": "com.playtika.wsop.gp",
        "name": "World Series of Poker – WSOP Free Texas Holdem",
        "iconUrl": "https://lh3.googleusercontent.com/NsQWVg_SM9LN6YjbLixTvl8YavpZJP1hLEjPqt2YZzB_EdzCT8s4hkD_8zos1TINotwh=s180",
        "price": "0",
        "category": "GAME_CARD",
        "categoryId": 32,
        "developerId": "Playtika",
        "developerName": "Playtika",
        "lastUpdateTime": 1554274800000
    }
]

App Discovery ( 1 Credit / Request )

Queues the given Google Play Store app for discovery.

POST /playstore-appinfo-v2/app/discover/{trackId}/{country}

Request Parameters

Parameter Description
trackId (required) Google Play Store track id of app
country (required) Two letter country code

Response Parameters

A boolean value for confirmation.

Example request

curl "https://api.mobileaction.co/playstore-appinfo-v2/app/discover/com.calm.android/US?token=YOUR_API_KEY"

Example response

true

App Reviews ( 5 Credits / Request )

This endpoint provides review list of the apps in PlayStore. If the app is not crawled it flags the app for crawling and returns empty list.

GET /playstore-app-reviews/{trackId}/{startDate}/{endDate}

Request Parameters

Parameter Description
trackId (required) PlayStore track id of app
startDate (required) Start date for the reviews to be listed, format: "yyyy-MM-dd"
endDate (required) End date for the reviews to be listed, format: "yyyy-MM-dd"
rating (optional) Rating star count(s) for the reviews to be listed. Value must be between 1-5, i.e "3" or "1,5"
languages (optional) Two letter language code(s) of the reviews posted from. Must be comma separated if provided more than one.
textQuery (optional) Any word to be searched in the reviews.
page (optional) Returns a maximum of 100 reviews per request, use this parameter to iterate, defaults to 0.

Response Fields

Field Description
id Id of the review
reviewer Name of the reviewer
date Post date of the review
countryCode Two letter country code (language code for Play Store) of the review posted from
rating Rating star count for the review
content Review content
title Review title

Example request

curl "https://api.mobileaction.co/playstore-app-reviews/com.facebook.katana/2019-08-01/2019-08-02?rating=1,2&languages=en&token=YOUR_API_KEY"

Example response

[
    {
        "id": 794800742,
        "reviewer": "T. Kandasamy T. Kanadsamy",
        "date": "2019-08-02T17:00:00",
        "countryCode": "en",
        "rating": 1,
        "content": "good app very useful",
        "title": ""
    },
    {
        "id": 794800737,
        "reviewer": "Mohamed Faisal",
        "date": "2019-08-02T17:00:00",
        "countryCode": "en",
        "rating": 1,
        "content": "Ads are the reason why left the facebook.",
        "title": ""
    },
    {
        "id": 794800731,
        "reviewer": "Abid Galaxy",
        "date": "2019-08-02T17:00:00",
        "countryCode": "en",
        "rating": 2,
        "content": "a l a vl pl a ll a l lpllplw a x a, a wz l pl senl xe",
        "title": ""
    }
]

App Review Analysis ( 10 Credits / Request )

This endpoint provides word based analysis for the reviews of a given app. Max. 30 days of data allowed for a single request.

Request Parameters

Parameter Description
trackId (required) PlayStore track id of app
startDate (required) Start date for the reviews to be listed, format: "yyyy-MM-dd"
endDate (required) End date for the reviews to be listed, format: "yyyy-MM-dd"
rating (optional) Rating star count(s) for the reviews to be listed. Value must be between 1-5, i.e "3" or "1,5"
languages (optional) Two letter language code(s) of the reviews posted from. Must be comma separated if provided more than one.
textQuery (optional) Any word to be searched in the reviews.

Response Fields

Field Description
word Keyword occurred in the reviews
averageRating Average rating of the reviews
frequency Number of occurrences of the word
numReviews Number of reviews the word occurred in
sentiment Distribution of the word in review ratings
trend Keyword trend

Example Request

curl "https://api.mobileaction.co/playstore-app-reviews/word-analysis/com.facebook.katana/2020-04-01/2020-04-02?rating=1,2&languages=en&token=YOUR_API_KEY"

Example Response

[
    {
        "word": "facebook",
        "averageRating": 1.1027397260273972,
        "frequency": 194,
        "numReviews": 146,
        "sentiment": {
            "1": 131,
            "2": 15
        },
        "trend": {
            "2020-04-02": 81,
            "2020-04-01": 113
        }
    },
    {
        "word": "update",
        "averageRating": 1.1684210526315788,
        "frequency": 103,
        "numReviews": 95,
        "sentiment": {
            "1": 79,
            "2": 16
        },
        "trend": {
            "2020-04-02": 53,
            "2020-04-01": 50
        }
    }
]

Download-Revenue Estimations ( 100 Credits / Request )

Provides download-revenue estimations of an app in Google Play. Max 30 days of history is allowed for a single request.

GET /market-estimations/playstore/estimation/download-revenue?trackId={trackId}&country={countryCode}&startDate={startDate}&endDate={endDate}

Request Parameters

Parameter Description
trackId (required) Google Play track id of app
country (required) Two letter country code
startDate (required) YYYY-MM-DD formatted date, history start date, inclusive.
endDate (required) YYYY-MM-DD formatted date, history end date, inclusive.

Response Fields

Field Description
date Date in YYYY-MM-DD format
download Download estimation
revenue Revenue estimation

Example request

curl "https://api.mobileaction.co/market-estimations/playstore/estimation/download-revenue?trackId=com.facebook.katana&country=US&startDate=2019-01-01&endDate=2019-01-02&token=YOUR_API_KEY"

Example response

[
  {
    "date": "2019-01-01",
    "download": 14344,
    "revenue": 143
  },
  {
    "date": "2019-01-02",
    "download": 3051,
    "revenue": 30
  }
]

Monthly Global Download-Revenue Estimations ( 2 Credits / Request )

Provides global download-revenue estimations of an app in PlayStore for the last month.

GET /market-estimations/playstore/estimation/download-revenue-last-month/{trackId}

Request Parameters

Parameter Description
trackId (required) PlayStore track id of app

Response Fields

Field Description
countryBreakDown Map of download and revenue per country
download Download estimation
revenue Revenue estimation

Example request

curl "https://api.mobileaction.co/market-estimations/playstore/estimation/download-revenue-last-month/com.facebook.katana?token=YOUR_API_KEY"

Example response

{
    "countryBreakDown": {
        "PT": {
            "download": 35245,
            "revenue": 3424
        },
        "US": {
            "download": 890808,
            "revenue": 2623614
        },
        "CA": {
            "download": 71519,
            "revenue": 144217
        },
        "FR": {
            "download": 141630,
            "revenue": 26960
        },
        "DE": {
            "download": 148746,
            "revenue": 40753
        }
    },
    "download": 4073459,
    "revenue": 3889426
}

Daily Active User (DAU) Estimations ( 50 Credits / Request )

Provides Daily Active User (DAU) estimations for the given app and country between the dates. Max 30 days of data allowed for a single request.

GET /market-estimations/playstore/estimation/dau/{trackId}?country={country}&startDate={startDate}&endDate={endDate}&token={YOUR_API_KEY}

Request Parameters

Parameter Description
trackId (required) AppStore track id of app
country (required) 2 letter uppercase country code
startDate (required) Start date in YYYY-MM-DD format
endDate (required) End date in YYYY-MM-DD format

Response Fields

Field Description
date Date for estimation
value Estimated DAU

Example request

curl "https://api.mobileaction.co/market-estimations/playstore/estimation/dau/com.calm.android?country=US&startDate=2020-09-01&endDate=2020-09-07&token=YOUR_API_KEY"

Example response

[
    {
        "date": "2020-09-01",
        "value": 105366
    },
    {
        "date": "2020-09-02",
        "value": 130723
    },
    {
        "date": "2020-09-03",
        "value": 147377
    },
    {
        "date": "2020-09-04",
        "value": 316486
    },
    {
        "date": "2020-09-05",
        "value": 101587
    },
    {
        "date": "2020-09-06",
        "value": 8259
    }
]

Monthly Active User (MAU) Estimations ( 50 Credits / Request )

Provides Monthly Active User (MAU) estimations for the given app and country between the dates. Max 30 days of data allowed for a single request.

GET /market-estimations/playstore/estimation/mau/{trackId}?country={country}&startDate={startDate}&endDate={endDate}&token={YOUR_API_KEY}

Request Parameters

Parameter Description
trackId (required) AppStore track id of app
country (required) 2 letter uppercase country code
startDate (required) Start date in YYYY-MM-DD format
endDate (required) End date in YYYY-MM-DD format

Response Fields

Field Description
date Date for estimation
value Estimated DAU

Example request

curl "https://api.mobileaction.co/market-estimations/playstore/estimation/mau/com.calm.android?country=US&startDate=2020-09-01&endDate=2020-09-07&token=YOUR_API_KEY"

Example response

[
    {
        "date": "2020-09-01",
        "value": 1133637
    },
    {
        "date": "2020-09-02",
        "value": 1366441
    },
    {
        "date": "2020-09-03",
        "value": 959466
    },
    {
        "date": "2020-09-04",
        "value": 2354355
    },
    {
        "date": "2020-09-05",
        "value": 719859
    },
    {
        "date": "2020-09-06",
        "value": 6326110
    }
]

Start for free - upgrade anytime!

No credit card required.