Skip to content

feljor/playstore-scraper-with-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

playstore-scraper-with-api

PlayStore Scraper with Restful API using Node.js

Documentation

Available methods:

  • getApps: Retrieve a list of applications from one of the collections at Google Play.
  • getAppDetail: Retrieves the full detail of an application.
  • search: Retrieves a list of apps that results of searching by the given term.
  • searchSuggestion: Given a string returns up to five suggestion to complete a search query term.
  • getReviews: Retrieves a page of reviews for a specific application.
  • getSimilarApps: Returns a list of similar apps to the one specified.
  • developer: Returns the list of applications by the given developer name.
  • permissions: Returns the list of permissions an app has access to.

getApps

Retrieve a list of applications from one of the collections at Google Play. Options:

  • collection (optional, defaults to collection=topselling_free): the Google Play collection that will be retrieved. Available options are { topselling_free, topselling_paid, topgrossing, movers_shakers, topselling_free_games, topselling_paid_games, topselling_grossing_games, topselling_new_free, topselling_new_paid, topselling_new_free_games, topselling_new_paid_games }.
  • category (optional, defaults to no category): the app category to filter by. Available options are { APPLICATION, ANDROID_WEAR, ART_AND_DESIGN, AUTO_AND_VEHICLES, BEAUTY, BOOKS_AND_REFERENCE, BUSINESS, COMICS, COMMUNICATION, DATING, EDUCATION, ENTERTAINMENT, EVENTS, FINANCE, FOOD_AND_DRINK, HEALTH_AND_FITNESS, HOUSE_AND_HOME, LIBRARIES_AND_DEMO, LIFESTYLE, MAPS_AND_NAVIGATION, MEDICAL, MUSIC_AND_AUDIO, NEWS_AND_MAGAZINES, PARENTING, PERSONALIZATION, PHOTOGRAPHY, PRODUCTIVITY, SHOPPING, SOCIAL, SPORTS, TOOLS, TRAVEL_AND_LOCAL, VIDEO_PLAYERS, WEATHER, GAME, GAME_ACTION, GAME_ADVENTURE, GAME_ARCADE, GAME_BOARD, GAME_CARD, GAME_CASINO, GAME_CASUAL, GAME_EDUCATIONAL, GAME_MUSIC, GAME_PUZZLE, GAME_RACING, GAME_ROLE_PLAYING, GAME_SIMULATION, GAME_SPORTS, GAME_STRATEGY, GAME_TRIVIA, GAME_WORD, FAMILY, FAMILY_ACTION, FAMILY_BRAINGAMES, FAMILY_CREATE, FAMILY_EDUCATION, FAMILY_MUSICVIDEO, FAMILY_PRETEND }.
  • age (optional, defaults to no age filter): the age range to filter the apps (only for FAMILY and its subcategories). Available options are age.FIVE_UNDER, age.SIX_EIGHT, age.NINE_UP.
  • num (optional, defaults to 500): the amount of apps to retrieve.
  • lang (optional, defaults to 'en'): the two letter language code used to retrieve the applications.
  • country (optional, defaults to 'us'): the two letter country code used to retrieve the applications.
  • fullDetail (optional, defaults to false): if true, an extra request will be made for every resulting app to fetch its full detail.

Request:

GET /api/apps/

Response:

{
  "results": [
        {
            "title": "TikTok - Make Your Day",
            "appId": "com.zhiliaoapp.musically",
            "url": "http://mercipro-scraper.herokuapp.com/api/apps/com.zhiliaoapp.musically",
            "icon": "https://lh3.googleusercontent.com/z5nin1RdQ4UZhv6fa1FNG7VE33imGqPgC4kKZIUjgf_up7E-Pj3AaojlMPwNNXaeGA",
            "developer": {
                "devId": "TikTok Inc.",
                "url": "http://mercipro-scraper.herokuapp.com/api/developers/TikTok%20Inc."
            },
            "developerId": "TikTok+Inc.",
            "priceText": "FREE",
            "price": 0,
            "free": true,
            "summary": "Real People. Real Videos.",
            "scoreText": "4.1",
            "score": 4.0861216,
            "playstoreUrl": "https://play.google.com/store/apps/details?id=com.zhiliaoapp.musically",
            "permissions": "http://mercipro-scraper.herokuapp.com/api/apps/com.zhiliaoapp.musically/permissions",
            "similar": "http://mercipro-scraper.herokuapp.com/api/apps/com.zhiliaoapp.musically/similar",
            "reviews": "http://mercipro-scraper.herokuapp.com/api/apps/com.zhiliaoapp.musically/reviews"
        },
        {
            "title": "ZOOM Cloud Meetings",
            "appId": "us.zoom.videomeetings",
            "url": "http://mercipro-scraper.herokuapp.com/api/apps/us.zoom.videomeetings",
            "icon": "https://lh3.googleusercontent.com/1DqxbUca62LmV1ehZirHGWYBef9Jrtl3DhZ4m6YBnWCUX-XNr3lcnYKb31R-7ukpKAw",
            "developer": {
                "devId": "zoom.us",
                "url": "http://mercipro-scraper.herokuapp.com/api/developers/zoom.us"
            },
            "developerId": "zoom.us",
            "priceText": "FREE",
            "price": 0,
            "free": true,
            "summary": "Zoom is a free HD meeting app with video and screen sharing for up to 100 people",
            "scoreText": "3.8",
            "score": 3.757078,
            "playstoreUrl": "https://play.google.com/store/apps/details?id=us.zoom.videomeetings",
            "permissions": "http://mercipro-scraper.herokuapp.com/api/apps/us.zoom.videomeetings/permissions",
            "similar": "http://mercipro-scraper.herokuapp.com/api/apps/us.zoom.videomeetings/similar",
            "reviews": "http://mercipro-scraper.herokuapp.com/api/apps/us.zoom.videomeetings/reviews"
        }
     ]
  }

Request with Params: Get top selling action games in Canada

GET /api/apps/?fullDetail=true&collection=topselling_paid&category=GAME_ACTION&country=ca

getAppDetail

Retrieves the full detail of an application. Options:

  • appId: (as a path in url) the Google Play id of the application (the ?id= parameter on the url).
  • lang (optional, defaults to 'en'): the two letter language code in which to fetch the app page.
  • country (optional, defaults to 'us'): the two letter country code used to retrieve the applications. Needed when the app is available only in some countries.

Request:

GET /api/apps/fr.hdss/

Response:

{
    "title": "HDSS.TO - Anciens Films et Séries de 1900 - 2000",
    "description": "Nous avons conçu cette application avec un seul objectif dans la tête: \"Vous donner de quoi vous divertir avec des anciens Films et Séries TV de 1900 à 2000\". N'est-ce pas une meilleure idée ?\r\n\r\nAvec l'application HDSS.TO - Anciens Films et Séries TV en Français, oubliez tous vos moments de stress et concentrez-vous devant l'écran de votre smartphone Android pour Regarder les meilleurs Films qui ont diverti votre jeunesse.\r\n\r\nLE CONTENU DE L'APPLICATION\r\n==========================\r\n\r\nLa nostalgie est tout ce qui nous attire le plus. Pour cela, nous publions tous vos anciens films populaires dans cette application. Et comme nous nous soucions également du temps d'attente, nous avons optimisé le lecteur de l'application \"HDSS.TO - Anciens Films Complet\" pour une lecture plus rapide et avons ajouté 3 serveurs supplémentaires.\r\n\r\nLa source de nos films est souvent sur des serveurs sûrs et sécurisés comme par exemple YouTube, Viméo, Dailymotion, etc... \r\n\r\nAvec notre application, vous pouvez regarder des anciens films français gratuits sans violation des droits d'auteur. Lorsque vous ouvrez l'application, vous trouverez un guide. En lisant notre guide, vous apprendrez comment utiliser l'application. Une fois que vous utilisez notre guide, vous pouvez commencer à regarder des films en ligne gratuitement en français.\r\n\r\nLES FONCTIONNALITES\r\n====================\r\n\r\nGrâce à cette application vous bénéficierez des plusieurs avantages tels que:\r\n\r\n- La mise à jour régulière des vieux films gratuits à regarder.\r\n- Un moteur de recherche intégré pour trouver facilement les vieux films complets que vous cherchez.\r\n- Une suggestion des films qui pourront vous intéressé en plus de celui que vous regardez actuellement\r\n- Une possibilité de sauvegarder vos vieux films préférés ou de les mettre dans la liste des souhaits pour les regarder plus tard.\r\n- Capacité de gérer votre compte directement depuis l'application\r\n- Accéder à des films complets en Français par genre et par popularité\r\n- Et plus encore.\r\n\r\nVIE PRIVEE ET DONNEES PERSONNELLES\r\n==================================\r\n\r\nNous collectons certaines données à propos de vous d'une manière facultative afin de mieux vou sproposer nos services.\r\n\r\nPar exemple, il peut nous arriver pendant votre navigation de vous demander votre Email si vous décidez de créer un compte dans l'application.\r\n\r\nSi vous le souhaitez, après avoir créer votre profil dans l'application, vous pouvez également vous décider d'ajouter votre photo et toutes ses données sont stockées dans notre base des données sans aucun but nocif ou d'utilisation incorrect.\r\n\r\nPour votre vie privée, vous pouvez décider de supprimer otre compte de notre plateforme si vous ne voyez plus son utilité, mais rassurez-vous une fois encore qu'aucune de vos données n'est partagée à des tiers pour une raison quelconque.\r\n\r\nNOTRE SITE WEB\r\n==============\r\n\r\nCette application \"HDSS.TO - Anciens Films Gratuits\" est lié sur un site web avec les mêmes contenus. Si vous êtes connecté sur votre PC, vous pouvez trouver directement vos films préférés sur votre PC en accédant sur le lien suivant (https://lestreaming.fr).\r\n\r\nQue vous soyez en France, Belgique, Suisse ou tout autre pays francophone, vous pouvez regarder des films gratuitement en Streaming dans la version française ou avec des sous-titres français.",
    "descriptionHTML": "Nous avons conçu cette application avec un seul objectif dans la tête: &quot;Vous donner de quoi vous divertir avec des anciens Films et Séries TV de 1900 à 2000&quot;. N&#39;est-ce pas une meilleure idée ?<br><br>Avec l&#39;application HDSS.TO - Anciens Films et Séries TV en Français, oubliez tous vos moments de stress et concentrez-vous devant l&#39;écran de votre smartphone Android pour Regarder les meilleurs Films qui ont diverti votre jeunesse.<br><br>LE CONTENU DE L&#39;APPLICATION<br>==========================<br><br>La nostalgie est tout ce qui nous attire le plus. Pour cela, nous publions tous vos anciens films populaires dans cette application. Et comme nous nous soucions également du temps d&#39;attente, nous avons optimisé le lecteur de l&#39;application &quot;HDSS.TO - Anciens Films Complet&quot; pour une lecture plus rapide et avons ajouté 3 serveurs supplémentaires.<br><br>La source de nos films est souvent sur des serveurs sûrs et sécurisés comme par exemple YouTube, Viméo, Dailymotion, etc... <br><br>Avec notre application, vous pouvez regarder des anciens films français gratuits sans violation des droits d&#39;auteur. Lorsque vous ouvrez l&#39;application, vous trouverez un guide. En lisant notre guide, vous apprendrez comment utiliser l&#39;application. Une fois que vous utilisez notre guide, vous pouvez commencer à regarder des films en ligne gratuitement en français.<br><br>LES FONCTIONNALITES<br>====================<br><br>Grâce à cette application vous bénéficierez des plusieurs avantages tels que:<br><br>- La mise à jour régulière des vieux films gratuits à regarder.<br>- Un moteur de recherche intégré pour trouver facilement les vieux films complets que vous cherchez.<br>- Une suggestion des films qui pourront vous intéressé en plus de celui que vous regardez actuellement<br>- Une possibilité de sauvegarder vos vieux films préférés ou de les mettre dans la liste des souhaits pour les regarder plus tard.<br>- Capacité de gérer votre compte directement depuis l&#39;application<br>- Accéder à des films complets en Français par genre et par popularité<br>- Et plus encore.<br><br>VIE PRIVEE ET DONNEES PERSONNELLES<br>==================================<br><br>Nous collectons certaines données à propos de vous d&#39;une manière facultative afin de mieux vou sproposer nos services.<br><br>Par exemple, il peut nous arriver pendant votre navigation de vous demander votre Email si vous décidez de créer un compte dans l&#39;application.<br><br>Si vous le souhaitez, après avoir créer votre profil dans l&#39;application, vous pouvez également vous décider d&#39;ajouter votre photo et toutes ses données sont stockées dans notre base des données sans aucun but nocif ou d&#39;utilisation incorrect.<br><br>Pour votre vie privée, vous pouvez décider de supprimer otre compte de notre plateforme si vous ne voyez plus son utilité, mais rassurez-vous une fois encore qu&#39;aucune de vos données n&#39;est partagée à des tiers pour une raison quelconque.<br><br>NOTRE SITE WEB<br>==============<br><br>Cette application &quot;HDSS.TO - Anciens Films Gratuits&quot; est lié sur un site web avec les mêmes contenus. Si vous êtes connecté sur votre PC, vous pouvez trouver directement vos films préférés sur votre PC en accédant sur le lien suivant (https://lestreaming.fr).<br><br>Que vous soyez en France, Belgique, Suisse ou tout autre pays francophone, vous pouvez regarder des films gratuitement en Streaming dans la version française ou avec des sous-titres français.",
    "summary": "Here is the best app to watch old movies from the 20th century",
    "installs": "50,000+",
    "minInstalls": 50000,
    "maxInstalls": 62058,
    "score": 3.38,
    "scoreText": "3.4",
    "ratings": 399,
    "reviews": "http://mercipro-scraper.herokuapp.com/api/apps/fr.hdss/reviews",
    "histogram": {
        "1": 111,
        "2": 7,
        "3": 55,
        "4": 63,
        "5": 159
    },
    "price": 0,
    "free": true,
    "currency": "USD",
    "priceText": "Free",
    "offersIAP": false,
    "size": "18M",
    "androidVersion": "4.4",
    "androidVersionText": "4.4 and up",
    "developer": {
        "devId": "MerciPro Inc.",
        "url": "http://mercipro-scraper.herokuapp.com/api/developers/MerciPro%20Inc."
    },
    "developerId": "6529673015364471915",
    "developerEmail": "admin@lestreaming.fr",
    "developerAddress": "82 Ave Patrice Emery Lumumba, Bukavu, République démocratique du Congo",
    "privacyPolicy": "https://lestreaming.fr/page/confidentialite",
    "developerInternalID": "6529673015364471915",
    "genre": "Entertainment",
    "genreId": "ENTERTAINMENT",
    "icon": "https://lh3.googleusercontent.com/2f0W1Y3Z59_moDrQApnTiVwp2pmr37VCa2VNxfz9IheOvwCU6epqep2DdWPF36q2Dw",
    "headerImage": "https://lh3.googleusercontent.com/jJQuwmEBd6pbguPwkbqI-RjBzfkEt0AETKBolQglsgekwQtG82SUkN-v9obUQVxTsbw",
    "screenshots": [
        "https://lh3.googleusercontent.com/sc3t2RkK3XlshfkEzfAfu4cQw3wYOU80KmqInupYD3hK0FoWG3j8hp06A1R0O2wEjnEo",
        "https://lh3.googleusercontent.com/C2zQVPno3yMjIlfKTE_j6QOhU702bqNRljipIgANDiHTBVW9gz9kco4_4ag3Z1aj4zc",
        "https://lh3.googleusercontent.com/VFXjnj22muah2WOqVRZnR_KhP7aaWyLIwfhgybgIjI699J6fbJ4vqv5PrmyoK_XLlVS8",
        "https://lh3.googleusercontent.com/su5GzLNX6rZ5eqRgeAhDIy-mollGuGBZjtQfZvYJcf9q_byv6m7QxAF3VdZrHcurDoE9",
        "https://lh3.googleusercontent.com/o-TzwwnfNtE0r0606h7JcTyXnBv7efFM5fEx0rEUn79Y28hBsTzwROdtrF8g5XhxoLg",
        "https://lh3.googleusercontent.com/fM4N5xXtnvoeDZkLpjqWuQNDro1BNEunpdDQ5hrT_kp2Tk5yinM-q9WR2yR7eHqoQn4"
    ],
    "contentRating": "Everyone",
    "adSupported": true,
    "released": "Feb 25, 2020",
    "updated": 1593804944000,
    "version": "2.9",
    "recentChanges": "- Recherche avancée et Instantanée<br>- Correction de tous les bugs<br>- Ajout des serveurs supplémentaires<br>- Aucune inscription requise<br>- Aucune pubs à caractère adulte<br>- Aucune redirection pendant la lecture<br>- Suppression du formulaire de demande des films<br>- Autres améliorations",
    "comments": [
        "Very bad app doesn't work !!!",
        "I love this app😍😍😍",
        "You can't research the movie that you want",
        "bad app",
        "Nice"
    ],
    "editorsChoice": false,
    "appId": "fr.hdss",
    "url": "http://mercipro-scraper.herokuapp.com/api/apps/fr.hdss",
    "playstoreUrl": "https://play.google.com/store/apps/details?id=fr.hdss&hl=en&gl=us",
    "permissions": "http://mercipro-scraper.herokuapp.com/api/apps/fr.hdss/permissions",
    "similar": "http://mercipro-scraper.herokuapp.com/api/apps/fr.hdss/similar"
}

Get an app detail in swahili

GET /api/apps/fr.hdss/?lang=sw

search

Retrieves a list of apps that results of searching by the given term. Options:

  • term: the term to search by.
  • num (optional, defaults to 20, max is 250): the amount of apps to retrieve.
  • lang (optional, defaults to 'en'): the two letter language code used to retrieve the applications.
  • country (optional, defaults to 'us'): the two letter country code used to retrieve the applications.
  • fullDetail (optional, defaults to false): if true, an extra request will be made for every resulting app to fetch its full detail.
  • price (optional, defaults to all): allows to control if the results apps are free, paid or both.
    • all: Free and paid
    • free: Free apps only
    • paid: Paid apps only

Request:

GET /api/apps/?q=facebook

Response:

{
    "results": [
        {
            "title": "Facebook",
            "appId": "com.facebook.katana",
            "url": "http://mercipro-scraper.herokuapp.com/api/apps/com.facebook.katana",
            "icon": "https://lh3.googleusercontent.com/ccWDU4A7fX1R24v-vvT480ySh26AYp97g1VrIB_FIdjRcuQB2JP2WdY7h_wVVAeSpg",
            "developer": {
                "devId": "Facebook",
                "url": "http://mercipro-scraper.herokuapp.com/api/developers/Facebook"
            },
            "developerId": "Facebook",
            "priceText": "FREE",
            "price": 0,
            "free": true,
            "summary": "Find friends, watch live videos, play games &amp; save photos in your social network",
            "scoreText": "4.2",
            "score": 4.191718,
            "playstoreUrl": "https://play.google.com/store/apps/details?id=com.facebook.katana",
            "permissions": "http://mercipro-scraper.herokuapp.com/api/apps/com.facebook.katana/permissions",
            "similar": "http://mercipro-scraper.herokuapp.com/api/apps/com.facebook.katana/similar",
            "reviews": "http://mercipro-scraper.herokuapp.com/api/apps/com.facebook.katana/reviews"
        },
        {
            "title": "Facebook Lite",
            "appId": "com.facebook.lite",
            "url": "http://mercipro-scraper.herokuapp.com/api/apps/com.facebook.lite",
            "icon": "https://lh3.googleusercontent.com/6Sp9grilVISOGqi92M26BH49Tj6o_VX_gByA4u1rl8kAvqOoY9n5EzDEHcFEnGHlzg",
            "developer": {
                "devId": "Facebook",
                "url": "http://mercipro-scraper.herokuapp.com/api/developers/Facebook"
            },
            "developerId": "Facebook",
            "priceText": "FREE",
            "price": 0,
            "free": true,
            "summary": "This version of Facebook uses less data and works in all network conditions.",
            "scoreText": "4.1",
            "score": 4.14035,
            "playstoreUrl": "https://play.google.com/store/apps/details?id=com.facebook.lite",
            "permissions": "http://mercipro-scraper.herokuapp.com/api/apps/com.facebook.lite/permissions",
            "similar": "http://mercipro-scraper.herokuapp.com/api/apps/com.facebook.lite/similar",
            "reviews": "http://mercipro-scraper.herokuapp.com/api/apps/com.facebook.lite/reviews"
        }
     ]
 }

searchSuggestion

Given a string returns up to five suggestion to complete a search query term. Options:

  • term: the term to get suggestions for.
  • lang (optional, defaults to 'en'): the two letter language code used to retrieve the suggestions.
  • country (optional, defaults to 'us'): the two letter country code used to retrieve the suggestions.

Request:

GET /api/apps/?suggest=face

Response:

{
    "results": [
        {
            "term": "facebook",
            "url": "http://mercipro-scraper.herokuapp.com/api/apps/?q=facebook"
        },
        {
            "term": "facebook messenger",
            "url": "http://mercipro-scraper.herokuapp.com/api/apps/?q=facebook%20messenger"
        },
        {
            "term": "faceapp",
            "url": "http://mercipro-scraper.herokuapp.com/api/apps/?q=faceapp"
        },
        {
            "term": "facetime",
            "url": "http://mercipro-scraper.herokuapp.com/api/apps/?q=facetime"
        },
        {
            "term": "facebook lite",
            "url": "http://mercipro-scraper.herokuapp.com/api/apps/?q=facebook%20lite"
        }
    ]
}

getReviews

Retrieves a page of reviews for a specific application.

Note that this method returns reviews in a specific language (english by default), so you need to try different languages to get more reviews. Also, the counter displayed in the Google Play page refers to the total number of 1-5 stars ratings the application has, not the written reviews count. So if the app has 100k ratings, don't expect to get 100k reviews by using this method.

You can get all reviews at once, by sending the num parameter (i.g. 5000), or paginated reviews (with 150 per page), by setting the pagination parameter to true;

You`ll have to choose wich method is better for your use case.

By setting num + paginate, the num parameter will be ignored and you will receive a paginated response instead.

Options:

  • appId: Unique application id for Google Play. (e.g. id=com.mojang.minecraftpe maps to Minecraft: Pocket Edition game).
  • lang (optional, defaults to 'en'): the two letter language code in which to fetch the reviews.
  • country (optional, defaults to 'us'): the two letter country code in which to fetch the reviews.
  • sort (optional, defaults to sort=NEWEST): The way the reviews are going to be sorted. Accepted values are: sort=NEWEST, sort=RATING and sort=HELPFULNESS.
  • num (optional, defaults to 100): Quantity of reviews to be captured.
  • paginate (optional, defaults to false): Defines if the result will be paginated
  • nextPaginationToken (optional, defaults to null): The next token to paginate

Request:

GET /api/apps/fr.hdss/reviews/

Response:

{
    "results": {
        "data": [
            {
                "id": "gp:AOqpTOEq8PEYR7VWhq84y_iMATpQP3kDiL8jr_BxEBSNtDitUDxRtwBI4oR5hrr3o6Ak_puUcJGtdIRt-NBgPGM",
                "userName": "Ken Kai",
                "userImage": "https://lh3.googleusercontent.com/-85bsR7M5G74/AAAAAAAAAAI/AAAAAAAAAAA/AMZuucnxSwF5-OcS0iKTYX9hxEs6Vc2QEg/photo.jpg",
                "date": "2020-05-29T19:13:39.133Z",
                "score": 1,
                "scoreText": "1",
                "url": "https://play.google.com/store/apps/details?id=fr.hdss&reviewId=gp:AOqpTOEq8PEYR7VWhq84y_iMATpQP3kDiL8jr_BxEBSNtDitUDxRtwBI4oR5hrr3o6Ak_puUcJGtdIRt-NBgPGM",
                "title": null,
                "text": "Zero s'il un chiffre en bas de zero je le met=0",
                "replyDate": null,
                "replyText": null,
                "version": null,
                "thumbsUp": 0,
                "criterias": [
                    {
                        "criteria": "vaf_phase1_free_movies_shows",
                        "rating": null
                    },
                    {
                        "criteria": "vaf_phase1_personalization",
                        "rating": null
                    },
                    {
                        "criteria": "vaf_phase1_movie_show_info",
                        "rating": null
                    }
                ]
            },
            {
                "id": "gp:AOqpTOGyrA_RqRTsuhODtFdGreWJ0curro_CqMFhUDb8U4TOTN5yanESHQPJ7fEuU-IxYlY72DDa3qcFRpQC-nU",
                "userName": "Castel Clint",
                "userImage": "https://lh3.googleusercontent.com/-qLbTdnTTJeI/AAAAAAAAAAI/AAAAAAAAAAA/AMZuucmLglqWomvQ1eqpbQKO3YxPVw7K6w/photo.jpg",
                "date": "2020-05-20T19:35:49.767Z",
                "score": 5,
                "scoreText": "5",
                "url": "https://play.google.com/store/apps/details?id=fr.hdss&reviewId=gp:AOqpTOGyrA_RqRTsuhODtFdGreWJ0curro_CqMFhUDb8U4TOTN5yanESHQPJ7fEuU-IxYlY72DDa3qcFRpQC-nU",
                "title": null,
                "text": "Good",
                "replyDate": null,
                "replyText": null,
                "version": "2.3",
                "thumbsUp": 0,
                "criterias": [
                    {
                        "criteria": "vaf_phase1_resume_watching",
                        "rating": null
                    },
                    {
                        "criteria": "vaf_never_display_content_language",
                        "rating": null
                    },
                    {
                        "criteria": "vaf_never_display_app_description",
                        "rating": null
                    }
                ]
            }
        ],
        "nextPaginationToken": null
    }
}

getSimilarApps

Returns a list of similar apps to the one specified. Options:

  • appId: the Google Play id of the application to get similar apps for.
  • lang (optional, defaults to 'en'): the two letter language code used to retrieve the applications.
  • country (optional, defaults to 'us'): the two letter country code used to retrieve the applications.
  • fullDetail (optional, defaults to false): if true, an extra request will be made for every resulting app to fetch its full detail.

Request:

GET /api/apps/fr.hdss/similar/

Response:

{
    "results": [
        {
            "title": "AlloCine",
            "appId": "com.allocine.androidapp",
            "url": "http://mercipro-scraper.herokuapp.com/api/apps/com.allocine.androidapp",
            "icon": "https://lh3.googleusercontent.com/YIYFmHAiPFFnRt690oCv_i-Sz9mClJOQ1wXt60lqmzBR1qKppxS1xLnE15WhvyZ1qfgL",
            "developer": {
                "devId": "AlloCiné",
                "url": "http://mercipro-scraper.herokuapp.com/api/developers/AlloCin%C3%A9"
            },
            "developerId": "AlloCin%C3%A9",
            "priceText": "FREE",
            "price": 0,
            "free": true,
            "summary": "AlloCiné: Films, trailers, cinemas, TV series, showtimes, stars and news",
            "scoreText": "4.2",
            "score": 4.2402945,
            "playstoreUrl": "https://play.google.com/store/apps/details?id=com.allocine.androidapp",
            "permissions": "http://mercipro-scraper.herokuapp.com/api/apps/com.allocine.androidapp/permissions",
            "similar": "http://mercipro-scraper.herokuapp.com/api/apps/com.allocine.androidapp/similar",
            "reviews": "http://mercipro-scraper.herokuapp.com/api/apps/com.allocine.androidapp/reviews"
        },
        {
            "title": "Cinopsys: Movie  & TV Show Manager",
            "appId": "com.cinopsys.movieshows",
            "url": "http://mercipro-scraper.herokuapp.com/api/apps/com.cinopsys.movieshows",
            "icon": "https://lh3.googleusercontent.com/YwB547JopLjkEDVialwXMTINvcVZ-tTAQNQBmQjxuwCnhbimfNcd03zZktlMSDx-gA",
            "developer": {
                "devId": "Kashish Sharma",
                "url": "http://mercipro-scraper.herokuapp.com/api/developers/Kashish%20Sharma"
            },
            "developerId": "6676933009263338062",
            "priceText": "FREE",
            "price": 0,
            "free": true,
            "summary": "Simple, elegant &amp; completely free TRAKT client for Movies 🎥 &amp; Shows 📺.<br>No Ads!",
            "scoreText": "4.2",
            "score": 4.15,
            "playstoreUrl": "https://play.google.com/store/apps/details?id=com.cinopsys.movieshows",
            "permissions": "http://mercipro-scraper.herokuapp.com/api/apps/com.cinopsys.movieshows/permissions",
            "similar": "http://mercipro-scraper.herokuapp.com/api/apps/com.cinopsys.movieshows/similar",
            "reviews": "http://mercipro-scraper.herokuapp.com/api/apps/com.cinopsys.movieshows/reviews"
        }
     ]
}

developer

Returns the list of applications by the given developer name. Options:

  • devId: the name of the developer.
  • lang (optional, defaults to 'en'): the two letter language code in which to fetch the app list.
  • country (optional, defaults to 'us'): the two letter country code used to retrieve the applications. Needed when the app is available only in some countries.
  • num (optional, defaults to 60): the amount of apps to retrieve.
  • fullDetail (optional, defaults to false): if true, an extra request will be made for every resulting app to fetch its full detail.

Request:

GET /api/developers/MerciPro%20Inc./

Response:

{
    "devId": "MerciPro Inc.",
    "apps": [
        {
            "title": "Radio Star Bukavu FM",
            "appId": "com.radiostar.cd",
            "url": "http://mercipro-scraper.herokuapp.com/api/apps/com.radiostar.cd",
            "icon": "https://lh3.googleusercontent.com/_-QPLwgRb42VJV1micwnltRe7PzBMTmjMacwecZX9U7v811tWBjZi3ihczd4-AXylg",
            "developer": {
                "devId": "MerciPro Inc.",
                "url": "http://mercipro-scraper.herokuapp.com/api/developers/MerciPro%20Inc."
            },
            "developerId": "6529673015364471915",
            "priceText": "FREE",
            "price": 0,
            "free": true,
            "summary": "All local, national and international news in a single application",
            "scoreText": "0.0",
            "score": 0,
            "playstoreUrl": "https://play.google.com/store/apps/details?id=com.radiostar.cd",
            "permissions": "http://mercipro-scraper.herokuapp.com/api/apps/com.radiostar.cd/permissions",
            "similar": "http://mercipro-scraper.herokuapp.com/api/apps/com.radiostar.cd/similar",
            "reviews": "http://mercipro-scraper.herokuapp.com/api/apps/com.radiostar.cd/reviews"
        },
        {
            "title": "HDSS.TO - Anciens Films et Séries de 1900 - 2000",
            "appId": "fr.hdss",
            "url": "http://mercipro-scraper.herokuapp.com/api/apps/fr.hdss",
            "icon": "https://lh3.googleusercontent.com/2f0W1Y3Z59_moDrQApnTiVwp2pmr37VCa2VNxfz9IheOvwCU6epqep2DdWPF36q2Dw",
            "developer": {
                "devId": "MerciPro Inc.",
                "url": "http://mercipro-scraper.herokuapp.com/api/developers/MerciPro%20Inc."
            },
            "developerId": "6529673015364471915",
            "priceText": "FREE",
            "price": 0,
            "free": true,
            "summary": "Here is the best app to watch old movies from the 20th century",
            "scoreText": "3.4",
            "score": 3.38,
            "playstoreUrl": "https://play.google.com/store/apps/details?id=fr.hdss",
            "permissions": "http://mercipro-scraper.herokuapp.com/api/apps/fr.hdss/permissions",
            "similar": "http://mercipro-scraper.herokuapp.com/api/apps/fr.hdss/similar",
            "reviews": "http://mercipro-scraper.herokuapp.com/api/apps/fr.hdss/reviews"
        }
    ]
}

permissions

Returns the list of permissions an app has access to.

  • appId: the Google Play id of the application to get permissions for.
  • lang (optional, defaults to 'en'): the two letter language code in which to fetch the permissions.
  • short (optional, defaults to false): if true, the permission names will be returned instead of permission/description objects.

Request:

GET /api/apps/fr.hdss/permissions/

Response:

{
    "results": [
        {
            "permission": "approximate location (network-based)",
            "type": "Location"
        },
        {
            "permission": "read phone status and identity",
            "type": "Phone"
        },
        {
            "permission": "read the contents of your USB storage",
            "type": "Photos/Media/Files"
        },
        {
            "permission": "modify or delete the contents of your USB storage",
            "type": "Photos/Media/Files"
        },
        {
            "permission": "read the contents of your USB storage",
            "type": "Storage"
        },
        {
            "permission": "take pictures and videos",
            "type": "Camera"
        },
        {
            "permission": "view Wi-Fi connections",
            "type": "Wi-Fi connection information"
        },
        {
            "permission": "read phone status and identity",
            "type": "Device ID & call information"
        },
        {
            "permission": "full network access",
            "type": "Other"
        }
    ]
}

Releases

No releases published

Packages

No packages published