{"id":13602701,"url":"https://github.com/facundoolano/app-store-scraper","last_synced_at":"2025-05-14T22:08:46.649Z","repository":{"id":37271206,"uuid":"60108707","full_name":"facundoolano/app-store-scraper","owner":"facundoolano","description":"scrape data from the itunes app store","archived":false,"fork":false,"pushed_at":"2025-01-24T01:19:52.000Z","size":212,"stargazers_count":1125,"open_issues_count":67,"forks_count":260,"subscribers_count":36,"default_branch":"master","last_synced_at":"2025-04-28T12:31:36.128Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/facundoolano.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["facundoolano"]}},"created_at":"2016-05-31T17:13:43.000Z","updated_at":"2025-04-28T07:37:04.000Z","dependencies_parsed_at":"2023-01-31T14:01:15.098Z","dependency_job_id":"8d79fe26-063b-4697-b655-3d02f8ee1b7c","html_url":"https://github.com/facundoolano/app-store-scraper","commit_stats":{"total_commits":142,"total_committers":34,"mean_commits":4.176470588235294,"dds":"0.43661971830985913","last_synced_commit":"ecdcfdde958bf02601c200be2c23633a89b81563"},"previous_names":[],"tags_count":30,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/facundoolano%2Fapp-store-scraper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/facundoolano%2Fapp-store-scraper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/facundoolano%2Fapp-store-scraper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/facundoolano%2Fapp-store-scraper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/facundoolano","download_url":"https://codeload.github.com/facundoolano/app-store-scraper/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254235700,"owners_count":22036964,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-01T18:01:34.497Z","updated_at":"2025-05-14T22:08:41.626Z","avatar_url":"https://github.com/facundoolano.png","language":"JavaScript","readme":"# app-store-scraper [![Build Status](https://secure.travis-ci.org/facundoolano/app-store-scraper.png)](http://travis-ci.org/facundoolano/app-store-scraper)\nNode.js module to scrape application data from the iTunes/Mac App Store.\nThe goal is to provide an interface as close as possible to the\n[google-play-scraper](https://github.com/facundoolano/google-play-scraper) module.\n\n## Installation\n```\nnpm install app-store-scraper\n```\n\n## Usage\nAvailable methods:\n- [app](#app): Retrieves the full detail of an application.\n- [list](#list): Retrieves a list of applications from one of the collections at iTunes.\n- [search](#search): Retrieves a list of apps that results of searching by the given term.\n- [developer](#developer): Retrieves a list of apps by the given developer id.\n- [privacy](#privacy): Display the privacy details for the app.\n- [suggest](#suggest): Given a string returns up to 50 suggestions to complete a search query term.\n- [similar](#similar): Returns the list of \"customers also bought\" apps shown in the app's detail page.\n- [reviews](#reviews): Retrieves a page of reviews for the app.\n- [ratings](#ratings): Retrieves the ratings for the app.\n- [versionHistory](#versionHistory): Retrieves the version history for the app.\n\n### app\nRetrieves the full detail of an application. Options:\n\n* `id`: the iTunes \"trackId\" of the app, for example `553834731` for Candy Crush Saga. Either this or the `appId` should be provided.\n* `appId`: the iTunes \"bundleId\" of the app, for example `com.midasplayer.apps.candycrushsaga` for Candy Crush Saga. Either this or the `id` should be provided.\n* `country`: the two letter country code to get the app details from. Defaults to `us`. Note this also affects the language of the data.\n* `lang`: language code for the result text. Defaults to undefined, so country specific language should be used automatically.\n+ `ratings`: load additional ratings information like `ratings` number and `histogram`\n\nExample:\n\n```javascript\nvar store = require('app-store-scraper');\n\nstore.app({id: 553834731}).then(console.log).catch(console.log);\n```\n\nResults:\n\n```javascript\n{ id: 553834731,\n  appId: 'com.midasplayer.apps.candycrushsaga',\n  title: 'Candy Crush Saga',\n  url: 'https://itunes.apple.com/us/app/candy-crush-saga/id553834731?mt=8\u0026uo=4',\n  description: 'Candy Crush Saga, from the makers of Candy Crush ...',\n  icon: 'http://is5.mzstatic.com/image/thumb/Purple30/v4/7a/e4/a9/7ae4a9a9-ff68-cbe4-eed6-fe0a246e625d/source/512x512bb.jpg',\n  genres: [ 'Games', 'Entertainment', 'Puzzle', 'Arcade' ],\n  genreIds: [ '6014', '6016', '7012', '7003' ],\n  primaryGenre: 'Games',\n  primaryGenreId: 6014,\n  contentRating: '4+',\n  languages: [ 'EN', 'JA' ],\n  size: '73974859',\n  requiredOsVersion: '5.1.1',\n  released: '2012-11-14T14:41:32Z',\n  updated: '2016-05-31T06:39:52Z',\n  releaseNotes: 'We are back with a tasty Candy Crush Saga update ...',\n  version: '1.76.1',\n  price: 0,\n  currency: 'USD',\n  free: true,\n  developerId: 526656015,\n  developer: 'King',\n  developerUrl: 'https://itunes.apple.com/us/developer/king/id526656015?uo=4',\n  developerWebsite: undefined,\n  score: 4,\n  reviews: 818816,\n  currentVersionScore: 4.5,\n  currentVersionReviews: 1323,\n  screenshots:\n   [ 'http://a3.mzstatic.com/us/r30/Purple49/v4/7a/8a/a0/7a8aa0ec-976d-801f-0bd9-7b753fdaf93c/screen1136x1136.jpeg',\n     ... ],\n  ipadScreenshots:\n   [ 'http://a1.mzstatic.com/us/r30/Purple49/v4/db/45/cf/db45cff9-bdb6-0832-157f-ac3f14565aef/screen480x480.jpeg',\n     ... ],\n  appletvScreenshots: [],\n  supportedDevices:\n   [ 'iPhone-3GS',\n     'iPadWifi',\n     ... ]}\n```\n\nExample with `ratings` option:\n\n```javascript\nvar store = require('app-store-scraper');\n\nstore.app({id: 553834731, ratings: true}).then(console.log).catch(console.log);\n```\n\nResults:\n\n```javascript\n{ id: 553834731,\n  appId: 'com.midasplayer.apps.candycrushsaga',\n\n  // ... like above\n\n  ratings: 652230,\n  histogram: {\n    '1': 7004,\n    '2': 6650,\n    '3': 26848,\n    '4': 140625,\n    '5': 471103\n  }\n}\n```\n\n### list\n\nRetrieves a list of applications from one of the collections at iTunes. Options:\n\n* `collection`: the collection to look up. Defaults to `collection.TOP_FREE_IOS`, available options can be found [here](https://github.com/facundoolano/app-store-scraper/blob/master/lib/constants.js#L3).\n* `category`: the category to look up. This is a number associated with the genre for the application. Defaults to no specific category. Available options can be found [here](https://github.com/facundoolano/app-store-scraper/blob/master/lib/constants.js#L19).\n* `country`: the two letter country code to get the list from. Defaults to `us`.\n* `lang`: language code for the result text. Defaults to undefined, so country specific language should be used automatically.\n* `num`: the amount of elements to retrieve. Defaults to `50`, maximum\n  allowed is `200`.\n* `fullDetail`: If this is set to `true`, an extra request will be\n  made to get extra attributes of the resulting applications (like\n  those returned by the `app` method).\n\nExample:\n\n```js\nvar store = require('app-store-scraper');\n\nstore.list({\n  collection: store.collection.TOP_FREE_IPAD,\n  category: store.category.GAMES_ACTION,\n  num: 2\n})\n.then(console.log)\n.catch(console.log);\n```\n\nReturns:\n\n```js\n[ { id: '1091944550',\n    appId: 'com.hypah.io.slither',\n    title: 'slither.io',\n    icon: 'http://is4.mzstatic.com/image/thumb/Purple30/v4/68/d7/4d/68d74df4-f4e7-d4a4-a8ea-dbab686e5554/mzl.ujmngosn.png/100x100bb-85.png',\n    url: 'https://itunes.apple.com/us/app/slither.io/id1091944550?mt=8\u0026uo=2',\n    price: 0,\n    currency: 'USD',\n    free: true,\n    description: 'Play against other people online! ...',\n    developer: 'Steve Howse',\n    developerUrl: 'https://itunes.apple.com/us/developer/steve-howse/id867992583?mt=8\u0026uo=2',\n    developerId: '867992583',\n    genre: 'Games',\n    genreId: '6014',\n    released: '2016-03-25T10:01:46-07:00' },\n  { id: '1046846443',\n    appId: 'com.ubisoft.hungrysharkworld',\n    title: 'Hungry Shark World',\n    icon: 'http://is5.mzstatic.com/image/thumb/Purple60/v4/08/1a/8d/081a8d06-b4d5-528b-fa8e-f53646b6f797/mzl.ehtjvlft.png/100x100bb-85.png',\n    url: 'https://itunes.apple.com/us/app/hungry-shark-world/id1046846443?mt=8\u0026uo=2',\n    price: 0,\n    currency: 'USD',\n    free: true,\n    description: 'The stunning sequel to Hungry ...',\n    developer: 'Ubisoft',\n    developerUrl: 'https://itunes.apple.com/us/developer/ubisoft/id317644720?mt=8\u0026uo=2',\n    developerId: '317644720',\n    genre: 'Games',\n    genreId: '6014',\n    released: '2016-05-04T09:43:06-07:00' } ]\n```\n\n### search\n\nRetrieves a list of apps that results of searching by the given term. Options:\n\n* `term`: the term to search for (required).\n* `num`: the amount of elements to retrieve. Defaults to `50`.\n* `page`: page of results to retrieve. Defaults to to `1`.\n* `country`: the two letter country code to get the similar apps\n  from. Defaults to `us`.\n* `lang`: language code for the result text. Defaults to `en-us`.\n* `idsOnly`: (optional, defaults to `false`): skip extra lookup request. Search results will contain array of application ids.\n\nExample:\n\n```js\nvar store = require('app-store-scraper');\n\nstore.search({\n  term: 'panda',\n  num: 2,\n  page: 3,\n  country : 'us',\n  lang: 'lang'\n})\n.then(console.log)\n.catch(console.log);\n```\n\nResults:\n\n```js\n[\n  { id: 903990394,\n    appId: 'com.pandarg.pxmobileapp',\n    title: 'Panda Express Chinese Kitchen',\n    (...)\n  },\n  {\n    id: 700970012,\n    appId: 'com.sgn.pandapop',\n    title: 'Panda Pop',\n    (...)\n  }\n]\n```\n\n### developer\nRetrieves a list of applications by the give developer id. Options:\n\n* `devId`: the iTunes \"artistId\" of the developer, for example `284882218` for Facebook.\n* `country`: the two letter country code to get the app details from. Defaults to `us`. Note this also affects the language of the data.\n* `lang`: language code for the result text. Defaults to undefined, so country specific language should be used automatically.\n\nExample:\n\n```javascript\nvar store = require('app-store-scraper');\n\nstore.developer({devId: 284882218}).then(console.log).catch(console.log);\n```\n\nResults:\n\n```js\n[\n  { id: 284882215,\n    appId: 'com.facebook.Facebook',\n    title: 'Facebook',\n    (...)\n  },\n  { id: 454638411,\n    appId: 'com.facebook.Messenger',\n    title: 'Messenger',\n    (...)\n  },\n  (...)\n]\n```\n\n### privacy\n\nRetrieves the ratings for the app. Currently only for US App Store. Options:\n\n* `id`: the iTunes \"trackId\" of the app, for example `553834731` for Candy Crush Saga.\n\nExample:\n\n```js\nvar store = require('app-store-scraper');\n\nstore.privacy({\n  id: 324684580,\n})\n.then(console.log)\n.catch(console.log);\n```\n\nReturns:\n\n```js\n{\n  \"managePrivacyChoicesUrl\": null,\n  \"privacyTypes\": [\n    {\n      \"privacyType\": \"Data Used to Track You\",\n      \"identifier\": \"DATA_USED_TO_TRACK_YOU\",\n      \"description\": \"The following data may be used to track you across apps and websites owned by other companies:\",\n      \"dataCategories\": [\n        {\n          \"dataCategory\": \"Contact Info\",\n          \"identifier\": \"CONTACT_INFO\",\n          \"dataTypes\": [\n            \"Email Address\",\n            \"Phone Number\"\n          ]\n        },\n        ...\n      ],\n      \"purposes\": []\n    },\n    ...\n  ]\n}\n```\n\n### suggest\n\nGiven a string returns up to 50 suggestions to complete a search query term.\nA priority index is also returned which goes from `0` for terms with low traffic\nto `10000` for the most searched terms.\n\nExample:\n\n```js\nvar store = require('app-store-scraper');\n\nstore.suggest({term: 'panda'}).then(console.log).catch(console.log);\n```\n\nResults:\n\n```js\n[\n  { term: 'panda pop' },\n  { term: 'panda pop free' },\n  { term: 'panda' },\n  { term: 'panda express' },\n  { term: 'panda games' },\n  { term: 'panda pop 2' },\n  ...\n]\n```\n\n### similar\nReturns the list of \"customers also bought\" apps shown in the app's detail page. Options:\n\n* `id`: the iTunes \"trackId\" of the app, for example `553834731` for Candy Crush Saga. Either this or the `appId` should be provided.\n* `appId`: the iTunes \"bundleId\" of the app, for example `com.midasplayer.apps.candycrushsaga` for Candy Crush Saga. Either this or the `id` should be provided.\n\nExample:\n\n```js\nvar store = require('app-store-scraper');\n\nstore.similar({id: 553834731}).then(console.log).catch(console.log);\n```\n\nResults:\n\n```js\n[\n  {\n    id: 632285588,\n    appId: 'com.nerdyoctopus.dots',\n    title: 'Dots: A Game About Connecting',\n    (...)\n  },\n  {\n    id: 727296976,\n    appId: 'com.sgn.cookiejam',\n    title: 'Cookie Jam',\n    (...)\n  }\n  (...)\n]\n```\n\n### reviews\n\nRetrieves a page of reviews for the app. Options:\n\n* `id`: the iTunes \"trackId\" of the app, for example `553834731` for Candy Crush Saga. Either this or the `appId` should be provided.\n* `appId`: the iTunes \"bundleId\" of the app, for example `com.midasplayer.apps.candycrushsaga` for Candy Crush Saga. Either this or the `id` should be provided.\n* `country`: the two letter country code to get the reviews from. Defaults to `us`.\n* `page`: the review page number to retrieve. Defaults to `1`, maximum allowed is `10`.\n* `sort`: the review sort order. Defaults to `store.sort.RECENT`, available options are `store.sort.RECENT` and `store.sort.HELPFUL`.\n\nExample:\n\n```js\nvar store = require('app-store-scraper');\n\nstore.reviews({\n  appId: 'com.midasplayer.apps.candycrushsaga',\n  sort: store.sort.HELPFUL,\n  page: 2\n})\n.then(console.log)\n.catch(console.log);\n```\n\nReturns:\n\n```js\n[ { id: '1472864600',\n    userName: 'Linda D. Lopez',\n    userUrl: 'https://itunes.apple.com/us/reviews/id324568166',\n    version: '1.80.1',\n    score: 5,\n    title: 'Great way to pass time or unwind',\n    text: 'I was a fan of Bejeweled many moons ago...',\n    updated: '2021-07-26T18:26:24-07:00',\n    url: 'https://itunes.apple.com/us/review?id=553834731\u0026type=Purple%20Software' },,\n  { id: '1472864708',\n    userName: 'Jennamaxkidd',\n    userUrl: 'https://itunes.apple.com/us/reviews/id223990784',\n    version: '1.80.1',\n    score: 1,\n    title: 'Help! THE PROBLEM IS NOT FIXED!',\n    text: 'STILL HAVING THE SAME ISSUE.  It\\'s happening again...',\n    updated: '2021-07-26T18:04:41-07:00',\n    url: 'https://itunes.apple.com/us/review?id=553834731\u0026type=Purple%20Software' },\n  (...)\n]\n```\n\n### ratings\n\nRetrieves the ratings for the app. Options:\n\n* `id`: the iTunes \"trackId\" of the app, for example `553834731` for Candy Crush Saga. Either this or the `appId` should be provided.\n* `appId`: the iTunes \"bundleId\" of the app, for example `com.midasplayer.apps.candycrushsaga` for Candy Crush Saga. Either this or the `id` should be provided.\n* `country`: the two letter country code to get the reviews from. Defaults to `us`.\n\nExample:\n\n```js\nvar store = require('app-store-scraper');\n\nstore.ratings({\n  appId: 'com.midasplayer.apps.candycrushsaga',\n})\n.then(console.log)\n.catch(console.log);\n```\n\nReturns:\n\n```js\n{\n  ratings: 652719,\n  histogram: {\n    '1': 7012,\n    '2': 6655,\n    '3': 26876,\n    '4': 140680,\n    '5': 471496\n  }\n}\n```\n\n### versionHistory\n\nRetrieves the version history for the app. Options:\n\n* `id`: the iTunes \"trackId\" of the app, for example `553834731` for Candy Crush Saga.\n\nExample:\n\n```js\nvar store = require('app-store-scraper');\n\nstore.versionHistory({\n  id: 324684580,\n})\n.then(console.log)\n.catch(console.log);\n```\n\nReturns:\n\n```js\n[\n  {\n    \"versionDisplay\": \"3.416.0\",\n    \"releaseNotes\": \"• Minor UI enhancements and bug fixes\",\n    \"releaseDate\": \"2024-08-14\",\n    \"releaseTimestamp\": \"2024-08-14T14:52:32Z\"\n  }\n]\n```\n\n### Memoization\n\nSince every library call performs one or multiple requests to\nan iTunes API or web page, sometimes it can be useful to cache the results\nto avoid requesting the same data twice. The `memoized` function returns the\nstore object that caches its results:\n\n``` javascript\nvar store = require('app-store-scraper'); // regular non caching version\nvar memoized = require('app-store-scraper').memoized(); // cache with default options\nvar memoizedCustom = require('app-store-scraper').memoized({ maxAge: 1000 * 60 }); // cache with default options\n\nmemoized.app({id: 553834731}) // will make a request\n  .then(() =\u003e memoized.app({id: 553834731})); // will resolve to the cached value without requesting\n```\n\nThe options available are those supported by the [memoizee](https://github.com/medikoo/memoizee) module.\nBy default up to 1000 values are cached by each method and they expire after 5 minutes.\n","funding_links":["https://github.com/sponsors/facundoolano"],"categories":["JavaScript","JavaScript (485)","[](#table-of-contents) Table of contents"],"sub_categories":["[](#routinedata-extraction-automation)Routine/Data Extraction Automation"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffacundoolano%2Fapp-store-scraper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffacundoolano%2Fapp-store-scraper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffacundoolano%2Fapp-store-scraper/lists"}