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
    }
]