{"_id":"@mradex77/google-play-scraper","_rev":"13-7a372e42212762e6246bb14bdd01e500","name":"@mradex77/google-play-scraper","dist-tags":{"latest":"1.6.0"},"versions":{"0.1.1":{"name":"@mradex77/google-play-scraper","version":"0.1.1","keywords":["google-play","google-play-scraper","play-store","scraper","android","app-store","aso","typescript"],"license":"MIT","_id":"@mradex77/google-play-scraper@0.1.1","maintainers":[{"name":"mradex77","email":"mradex77@gmail.com"}],"dist":{"shasum":"d4b282cac052ac4fbbe41ab7a73f292bfaca5d50","tarball":"https://registry.npmjs.org/@mradex77/google-play-scraper/-/google-play-scraper-0.1.1.tgz","fileCount":9,"integrity":"sha512-wBCVVcaw+1D6px2qZkOcBPg+NodfSRTloIVyl2owY9LCDFkjNeqe5GevopAgT3LxMNhIiH1379grdGUaeBF9sQ==","signatures":[{"sig":"MEYCIQDOgMPUEZxloFX6nEyVJTqPqNJXrt2VFgDslV6rd9uWxwIhANJxU5bdZE7O0n+mvlC9DX0uqRXBqxfRfPsc6w4sFvfs","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":592137},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=22.12.0"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}}},"gitHead":"565bda98b2faa8a2a009974947e23d2bf7bc9ea5","scripts":{"lint":"eslint .","test":"vitest run --project unit","build":"tsdown","format":"prettier --write .","example":"tsx examples/all-methods.ts","prepare":"husky","lint:fix":"eslint . --fix","test:e2e":"vitest run --project e2e","typecheck":"tsc --noEmit","test:watch":"vitest --project unit","format:check":"prettier --check .","check:package":"pnpm build && publint && attw --pack .","test:coverage":"vitest run --project unit --coverage","prepublishOnly":"pnpm build","fixtures:update":"tsx scripts/update-fixtures.ts"},"_npmUser":{"name":"mradex77","email":"mradex77@gmail.com"},"_npmVersion":"11.18.0","description":"TypeScript client for scraping public Google Play app data","directories":{},"lint-staged":{"*.ts":["eslint --fix","prettier --write"],"*.{js,json,md,yml,yaml}":["prettier --write"]},"sideEffects":false,"_nodeVersion":"24.14.0","dependencies":{"zod":"^4.4.3","cheerio":"1.2.0","lru-cache":"^11.5.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.10.0","devDependencies":{"tsx":"^4.23.0","husky":"^9.1.7","eslint":"^10.6.0","tsdown":"^0.22.3","vitest":"^4.1.10","publint":"^0.3.21","prettier":"^3.9.4","@eslint/js":"^10","typescript":"^6.0.3","@types/node":"^22.20.0","lint-staged":"^17.0.8","@commitlint/cli":"^21.2.0","typescript-eslint":"^8.62.1","@vitest/coverage-v8":"^4.1.10","@arethetypeswrong/cli":"^0.18.4","eslint-config-prettier":"^10.1.8","@commitlint/config-conventional":"^21.2.0"},"_npmOperationalInternal":{"tmp":"tmp/google-play-scraper_0.1.1_1783505527883_0.2981194460301939","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@mradex77/google-play-scraper","version":"0.2.0","keywords":["google-play","google-play-scraper","google-play-api","play-store","play-store-api","playstore","scraper","web-scraping","android","android-apps","app-store","app-data","app-reviews","reviews","aso","app-store-optimization","market-research","typescript","nodejs","zod"],"author":{"url":"https://github.com/MrAdex77","name":"MrAdex77"},"license":"MIT","_id":"@mradex77/google-play-scraper@0.2.0","maintainers":[{"name":"mradex77","email":"mradex77@gmail.com"}],"homepage":"https://github.com/MrAdex77/google-play-scraper#readme","bugs":{"url":"https://github.com/MrAdex77/google-play-scraper/issues"},"dist":{"shasum":"eb9b47b58e101da677ac2548cfb537f04b23ed68","tarball":"https://registry.npmjs.org/@mradex77/google-play-scraper/-/google-play-scraper-0.2.0.tgz","fileCount":9,"integrity":"sha512-6zA8RGCs4sEyOJtr6Y6JqToOcHDCATcMnBhEaBId1ZCsRVh/MeIU/D77V5pwHORV5uxbpmcmviAuQak3mvOxBA==","signatures":[{"sig":"MEYCIQCV9oTNiA1U7OXDQ4Dg5ntRLd0hX6bNn6QDUvibfwZvWgIhAOc1gpjZcPHrEDFZ8NZ9nvAyWiFJ5Qu5cJnQfF4fWAsV","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mradex77%2fgoogle-play-scraper@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":608577},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=22.12.0"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}}},"gitHead":"d5c78733711bafd96c80073dc9153751f6fb4914","scripts":{"lint":"eslint .","test":"vitest run --project unit","build":"tsdown","format":"prettier --write .","example":"tsx examples/all-methods.ts","prepare":"husky","lint:fix":"eslint . --fix","test:e2e":"vitest run --project e2e","typecheck":"tsc --noEmit","test:watch":"vitest --project unit","format:check":"prettier --check .","check:package":"pnpm build && publint && attw --pack .","test:coverage":"vitest run --project unit --coverage","prepublishOnly":"pnpm build","fixtures:update":"tsx scripts/update-fixtures.ts"},"_npmUser":{"name":"mradex77","email":"mradex77@gmail.com"},"repository":{"url":"git+https://github.com/MrAdex77/google-play-scraper.git","type":"git"},"_npmVersion":"11.16.0","description":"Google Play scraper for Node.js with a fully typed TypeScript API. Fetch app details, search results, top charts, reviews, permissions and data safety from the Play Store.","directories":{},"lint-staged":{"*.ts":["eslint --fix","prettier --write"],"*.{js,json,md,yml,yaml}":["prettier --write"]},"sideEffects":false,"_nodeVersion":"24.18.0","dependencies":{"zod":"^4.4.3","cheerio":"1.2.0","lru-cache":"^11.5.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.10.0","devDependencies":{"tsx":"^4.23.0","husky":"^9.1.7","eslint":"^10.6.0","tsdown":"^0.22.3","vitest":"^4.1.10","publint":"^0.3.21","prettier":"^3.9.4","@eslint/js":"^10","typescript":"^6.0.3","@types/node":"^22.20.0","lint-staged":"^17.0.8","@commitlint/cli":"^21.2.0","typescript-eslint":"^8.62.1","@vitest/coverage-v8":"^4.1.10","@arethetypeswrong/cli":"^0.18.4","eslint-config-prettier":"^10.1.8","@commitlint/config-conventional":"^21.2.0"},"_npmOperationalInternal":{"tmp":"tmp/google-play-scraper_0.2.0_1783515254338_0.11956831109336852","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@mradex77/google-play-scraper","version":"0.3.0","keywords":["google-play","google-play-scraper","google-play-api","play-store","play-store-api","playstore","scraper","web-scraping","android","android-apps","app-store","app-data","app-reviews","reviews","aso","app-store-optimization","market-research","typescript","nodejs","zod"],"author":{"url":"https://github.com/MrAdex77","name":"MrAdex77"},"license":"MIT","_id":"@mradex77/google-play-scraper@0.3.0","maintainers":[{"name":"mradex77","email":"mradex77@gmail.com"}],"homepage":"https://github.com/MrAdex77/google-play-scraper#readme","bugs":{"url":"https://github.com/MrAdex77/google-play-scraper/issues"},"dist":{"shasum":"9532a66cb60303260e7fabccdc48f39e036b4fb7","tarball":"https://registry.npmjs.org/@mradex77/google-play-scraper/-/google-play-scraper-0.3.0.tgz","fileCount":9,"integrity":"sha512-jDaZMazJwuPFZI72SwdmWVGCCtnMfcB46bLlcNsIviCgEBw87qJFspXHHMXYZupcFh0oMrU7l3pA1DabXZjnpQ==","signatures":[{"sig":"MEUCIG56hpeaIXOle7I9GfdItOWtRWp+w+AM2pbyJrptkV2yAiEA0nlKwCffbCgKMoJWRKCJ1OG/OKTqIz/I09R3L8tNiVg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mradex77%2fgoogle-play-scraper@0.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":630161},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=22.12.0"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}}},"gitHead":"e90f2c43c1f106b83a452122cb229d9b38734002","scripts":{"lint":"eslint .","test":"vitest run --project unit","build":"tsdown","format":"prettier --write .","example":"tsx examples/all-methods.ts","prepare":"husky","lint:fix":"eslint . --fix","test:e2e":"vitest run --project e2e","typecheck":"tsc --noEmit","test:watch":"vitest --project unit","format:check":"prettier --check .","check:package":"pnpm build && publint && attw --pack .","test:coverage":"vitest run --project unit --coverage","prepublishOnly":"pnpm build","fixtures:update":"tsx scripts/update-fixtures.ts"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:09f5f2a8-153f-45d3-9ee5-3ddb800678db"}},"repository":{"url":"git+https://github.com/MrAdex77/google-play-scraper.git","type":"git"},"_npmVersion":"11.16.0","description":"Google Play scraper for Node.js with a fully typed TypeScript API. Fetch app details, search results, top charts, reviews, permissions and data safety from the Play Store.","directories":{},"lint-staged":{"*.ts":["eslint --fix","prettier --write"],"*.{js,json,md,yml,yaml}":["prettier --write"]},"sideEffects":false,"_nodeVersion":"24.18.0","dependencies":{"zod":"^4.4.3","cheerio":"1.2.0","lru-cache":"^11.5.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.10.0","devDependencies":{"tsx":"^4.23.0","husky":"^9.1.7","eslint":"^10.6.0","tsdown":"^0.22.3","vitest":"^4.1.10","publint":"^0.3.21","prettier":"^3.9.4","@eslint/js":"^10","typescript":"^6.0.3","@types/node":"^22.20.0","lint-staged":"^17.0.8","@commitlint/cli":"^21.2.0","typescript-eslint":"^8.62.1","@vitest/coverage-v8":"^4.1.10","@arethetypeswrong/cli":"^0.18.4","eslint-config-prettier":"^10.1.8","@commitlint/config-conventional":"^21.2.0"},"_npmOperationalInternal":{"tmp":"tmp/google-play-scraper_0.3.0_1783589513642_0.32646618233662617","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@mradex77/google-play-scraper","version":"0.4.0","keywords":["google-play","google-play-scraper","google-play-api","play-store","play-store-api","playstore","scraper","web-scraping","android","android-apps","app-store","app-data","app-reviews","reviews","aso","app-store-optimization","market-research","typescript","nodejs","zod"],"author":{"url":"https://github.com/MrAdex77","name":"MrAdex77"},"license":"MIT","_id":"@mradex77/google-play-scraper@0.4.0","maintainers":[{"name":"mradex77","email":"mradex77@gmail.com"}],"homepage":"https://github.com/MrAdex77/google-play-scraper#readme","bugs":{"url":"https://github.com/MrAdex77/google-play-scraper/issues"},"dist":{"shasum":"00a3d9719a8ba377b4ab271b38ef95bb3ace8a0e","tarball":"https://registry.npmjs.org/@mradex77/google-play-scraper/-/google-play-scraper-0.4.0.tgz","fileCount":9,"integrity":"sha512-wyS3DuHvb92emtNjNeVEyQdiRqgumb6y9tTG6GXZStj9ZYDXohoif7TJTJJihGSXvahHhEdzJyg9Q3xYHhWTeA==","signatures":[{"sig":"MEYCIQCTD41GvyZ69aMXznuGgkJh7CUbOStcPTJCTOBLJBQKEwIhANT0OZuNEfKyOj8NJdHGozKbk7moTweJCK0qvyFE++Kc","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mradex77%2fgoogle-play-scraper@0.4.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":755022},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=22.12.0"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}}},"gitHead":"6b04ea2013bc0e5c81c196b7bba92675674cd61d","scripts":{"lint":"eslint .","test":"vitest run --project unit","build":"tsdown","format":"prettier --write .","example":"tsx examples/all-methods.ts","prepare":"husky","docs:api":"typedoc","lint:fix":"eslint . --fix","test:e2e":"vitest run --project e2e","typecheck":"tsc --noEmit","test:watch":"vitest --project unit","format:check":"prettier --check .","check:package":"pnpm build && publint && attw --pack .","test:coverage":"vitest run --project unit --coverage","prepublishOnly":"pnpm build","fixtures:update":"tsx scripts/update-fixtures.ts"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:09f5f2a8-153f-45d3-9ee5-3ddb800678db"}},"repository":{"url":"git+https://github.com/MrAdex77/google-play-scraper.git","type":"git"},"_npmVersion":"11.16.0","description":"Google Play scraper for Node.js with a fully typed TypeScript API. Fetch app details, search results, top charts, reviews, permissions and data safety from the Play Store.","directories":{},"lint-staged":{"*.ts":["eslint --fix","prettier --write"],"*.{js,json,md,yml,yaml}":["prettier --write"]},"sideEffects":false,"_nodeVersion":"24.18.0","dependencies":{"zod":"^4.4.3","cheerio":"1.2.0","lru-cache":"^11.5.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.10.0","devDependencies":{"tsx":"^4.23.1","husky":"^9.1.7","eslint":"^10.7.0","tsdown":"^0.22.7","vitest":"^4.1.10","publint":"^0.3.21","typedoc":"^0.28.20","prettier":"^3.9.5","@eslint/js":"^10.0.1","typescript":"^6.0.3","@types/node":"^26.1.1","lint-staged":"^17.0.8","@commitlint/cli":"^21.2.1","typescript-eslint":"^8.64.0","@vitest/coverage-v8":"^4.1.10","@arethetypeswrong/cli":"^0.18.5","eslint-config-prettier":"^10.1.8","@commitlint/config-conventional":"^21.2.0"},"_npmOperationalInternal":{"tmp":"tmp/google-play-scraper_0.4.0_1784106899087_0.6425125414501616","host":"s3://npm-registry-packages-npm-production"}},"0.4.1":{"name":"@mradex77/google-play-scraper","version":"0.4.1","keywords":["google-play","google-play-scraper","google-play-api","play-store","play-store-api","playstore","scraper","web-scraping","android","android-apps","app-store","app-data","app-reviews","reviews","aso","app-store-optimization","market-research","typescript","nodejs","zod"],"author":{"url":"https://github.com/MrAdex77","name":"MrAdex77"},"license":"MIT","_id":"@mradex77/google-play-scraper@0.4.1","maintainers":[{"name":"mradex77","email":"mradex77@gmail.com"}],"homepage":"https://github.com/MrAdex77/google-play-scraper#readme","bugs":{"url":"https://github.com/MrAdex77/google-play-scraper/issues"},"dist":{"shasum":"b203144a99d7591c8be6a2a5148d17f0fbf7f9d2","tarball":"https://registry.npmjs.org/@mradex77/google-play-scraper/-/google-play-scraper-0.4.1.tgz","fileCount":9,"integrity":"sha512-yHO60Q1DfNYgkEEa4Sjf8RsIJ6pdvTH9jAxO57t0QdYy2tEP7AcYt9M0GMz8/Z3jHN48dDpeYoieCzLJEPhkQA==","signatures":[{"sig":"MEMCIEKhNbj4SXMo3aaJ5Wz6obh7AhJLsUOphd7qPxJ9TCkFAh98WQF+qEzD2mIBQu36dxkAt6NME1hpxR/4OFB2iZFH","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mradex77%2fgoogle-play-scraper@0.4.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":755922},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=22.12.0"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}}},"gitHead":"abe8c5331e69687f6ba767281d00c68df1cce52e","scripts":{"lint":"eslint .","test":"vitest run --project unit","build":"tsdown","format":"prettier --write .","example":"tsx examples/all-methods.ts","prepare":"husky","docs:api":"typedoc","lint:fix":"eslint . --fix","test:e2e":"vitest run --project e2e","typecheck":"tsc --noEmit","test:watch":"vitest --project unit","format:check":"prettier --check .","check:package":"pnpm build && publint && attw --pack .","test:coverage":"vitest run --project unit --coverage","prepublishOnly":"pnpm build","fixtures:update":"tsx scripts/update-fixtures.ts"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:09f5f2a8-153f-45d3-9ee5-3ddb800678db"}},"repository":{"url":"git+https://github.com/MrAdex77/google-play-scraper.git","type":"git"},"_npmVersion":"11.16.0","description":"Google Play scraper for Node.js with a fully typed TypeScript API. Fetch app details, search results, top charts, reviews, permissions and data safety from the Play Store.","directories":{},"lint-staged":{"*.ts":["eslint --fix","prettier --write"],"*.{js,json,md,yml,yaml}":["prettier --write"]},"sideEffects":false,"_nodeVersion":"24.18.0","dependencies":{"zod":"^4.4.3","cheerio":"1.2.0","lru-cache":"^11.5.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.10.0","devDependencies":{"tsx":"^4.23.1","husky":"^9.1.7","eslint":"^10.7.0","tsdown":"^0.22.7","vitest":"^4.1.10","publint":"^0.3.21","typedoc":"^0.28.20","prettier":"^3.9.5","@eslint/js":"^10.0.1","typescript":"^6.0.3","@types/node":"^26.1.1","lint-staged":"^17.0.8","@commitlint/cli":"^21.2.1","typescript-eslint":"^8.64.0","@vitest/coverage-v8":"^4.1.10","@arethetypeswrong/cli":"^0.18.5","eslint-config-prettier":"^10.1.8","@commitlint/config-conventional":"^21.2.0"},"_npmOperationalInternal":{"tmp":"tmp/google-play-scraper_0.4.1_1784145647644_0.8512725347091841","host":"s3://npm-registry-packages-npm-production"}},"1.0.0":{"name":"@mradex77/google-play-scraper","version":"1.0.0","keywords":["google-play","google-play-scraper","google-play-api","play-store","play-store-api","playstore","scraper","web-scraping","android","android-apps","app-store","app-data","app-reviews","reviews","aso","app-store-optimization","market-research","typescript","nodejs","zod","cli"],"author":{"url":"https://github.com/MrAdex77","name":"MrAdex77"},"license":"MIT","_id":"@mradex77/google-play-scraper@1.0.0","maintainers":[{"name":"mradex77","email":"mradex77@gmail.com"}],"homepage":"https://github.com/MrAdex77/google-play-scraper#readme","bugs":{"url":"https://github.com/MrAdex77/google-play-scraper/issues"},"bin":{"google-play-scraper":"dist/cli.js"},"dist":{"shasum":"598c72269538fdd8826ec732c2b70bf75274706b","tarball":"https://registry.npmjs.org/@mradex77/google-play-scraper/-/google-play-scraper-1.0.0.tgz","fileCount":11,"integrity":"sha512-uQspjlqG8P6MN2I2b6D2PnLNIq9o1iuE2my8E6V9H6wmlPnFLFGqHboa5/1T+HFPSqzlIOp4A7/j8hTUAT8ExA==","signatures":[{"sig":"MEQCIFtIcD+3z1UT+Gou/HvsRWK8GFheWH6EMPANXLE35+Z1AiBZpb0WzenD6GvyVZgV2nrn7BXUEgeib5+rY52cqXq7Hg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mradex77%2fgoogle-play-scraper@1.0.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":1175112},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=22.12.0"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}}},"gitHead":"f57fed88ee423fc93088d6391675058a91d228c4","scripts":{"lint":"eslint .","test":"vitest run --project unit","bench":"vitest bench --run --project unit","build":"tsdown","format":"prettier --write .","example":"tsx examples/all-methods.ts","prepare":"husky","docs:api":"typedoc","lint:fix":"eslint . --fix","test:e2e":"vitest run --project e2e","typecheck":"tsc --noEmit","test:watch":"vitest --project unit","format:check":"prettier --check .","check:package":"pnpm build && publint && attw --pack .","coverage:live":"tsx scripts/live-coverage-report.ts","test:coverage":"vitest run --project unit --coverage","prepublishOnly":"pnpm build","fixtures:update":"tsx scripts/update-fixtures.ts"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:09f5f2a8-153f-45d3-9ee5-3ddb800678db"}},"repository":{"url":"git+https://github.com/MrAdex77/google-play-scraper.git","type":"git"},"_npmVersion":"11.16.0","description":"Google Play scraper for Node.js with a fully typed TypeScript API. Fetch app details, search results, top charts, reviews, permissions and data safety from the Play Store.","directories":{},"lint-staged":{"*.ts":["eslint --fix","prettier --write"],"*.{js,json,md,yml,yaml}":["prettier --write"]},"sideEffects":false,"_nodeVersion":"24.18.0","dependencies":{"zod":"^4.4.3","lru-cache":"^11.5.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.10.0","devDependencies":{"tsx":"^4.23.1","husky":"^9.1.7","eslint":"^10.7.0","tsdown":"^0.22.7","vitest":"^4.1.10","cheerio":"1.2.0","publint":"^0.3.21","typedoc":"^0.28.20","prettier":"^3.9.5","@eslint/js":"^10.0.1","typescript":"^6.0.3","@types/node":"^26.1.1","lint-staged":"^17.0.8","@commitlint/cli":"^21.2.1","typescript-eslint":"^8.64.0","@vitest/coverage-v8":"^4.1.10","@arethetypeswrong/cli":"^0.18.5","eslint-config-prettier":"^10.1.8","@commitlint/config-conventional":"^21.2.0"},"_npmOperationalInternal":{"tmp":"tmp/google-play-scraper_1.0.0_1784309528004_0.10915230628580908","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@mradex77/google-play-scraper","version":"1.1.0","keywords":["google-play","google-play-scraper","google-play-api","play-store","play-store-api","playstore","scraper","web-scraping","android","android-apps","app-store","app-data","app-reviews","reviews","aso","app-store-optimization","market-research","typescript","nodejs","zod","cli"],"author":{"url":"https://github.com/MrAdex77","name":"MrAdex77"},"license":"MIT","_id":"@mradex77/google-play-scraper@1.1.0","maintainers":[{"name":"mradex77","email":"mradex77@gmail.com"}],"homepage":"https://github.com/MrAdex77/google-play-scraper#readme","bugs":{"url":"https://github.com/MrAdex77/google-play-scraper/issues"},"bin":{"google-play-scraper":"dist/cli.js"},"dist":{"shasum":"6dee9e6316db14140d769adf4df4de1a857874db","tarball":"https://registry.npmjs.org/@mradex77/google-play-scraper/-/google-play-scraper-1.1.0.tgz","fileCount":11,"integrity":"sha512-XQ1HrQRmNHUWFhYF5JT4oZNSWj3yVDR1wfS0dhz7JCi5nvkf/QOoo/c1TOouTj56Va4Pcuh78qSgYvrNU3QoJw==","signatures":[{"sig":"MEYCIQDEd0367s/bJAOAXw9uMyA8ovO2GtmT2wKW5NwbXxUVmgIhAO4Gb2FTUKkRsMsnos4roQMIg2kCZMaMuuTOJSf5He2m","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mradex77%2fgoogle-play-scraper@1.1.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":1341722},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=22.12.0"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}}},"gitHead":"916a61116e27f727e626e5af64414974c44282c3","scripts":{"lint":"eslint .","test":"vitest run --project unit","bench":"vitest bench --run --project unit","build":"tsdown","format":"prettier --write .","example":"tsx examples/all-methods.ts","prepare":"husky","docs:api":"typedoc","lint:fix":"eslint . --fix","test:e2e":"vitest run --project e2e","typecheck":"tsc --noEmit","test:watch":"vitest --project unit","format:check":"prettier --check .","check:package":"pnpm build && publint && attw --pack .","coverage:live":"tsx scripts/live-coverage-report.ts","test:coverage":"vitest run --project unit --coverage","prepublishOnly":"pnpm build","fixtures:update":"tsx scripts/update-fixtures.ts"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:09f5f2a8-153f-45d3-9ee5-3ddb800678db"}},"repository":{"url":"git+https://github.com/MrAdex77/google-play-scraper.git","type":"git"},"_npmVersion":"11.16.0","description":"Google Play scraper for Node.js with a fully typed TypeScript API. Fetch app details, search results, top charts, reviews, permissions and data safety from the Play Store.","directories":{},"lint-staged":{"*.ts":["eslint --fix","prettier --write"],"*.{js,json,md,yml,yaml}":["prettier --write"]},"sideEffects":false,"_nodeVersion":"24.18.0","dependencies":{"zod":"^4.4.3","lru-cache":"^11.5.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.10.0","devDependencies":{"tsx":"^4.23.1","husky":"^9.1.7","eslint":"^10.7.0","tsdown":"^0.22.7","vitest":"^4.1.10","cheerio":"1.2.0","publint":"^0.3.21","typedoc":"^0.28.20","prettier":"^3.9.5","@eslint/js":"^10.0.1","typescript":"^6.0.3","@types/node":"^26.1.1","lint-staged":"^17.0.8","@commitlint/cli":"^21.2.1","typescript-eslint":"^8.64.0","@vitest/coverage-v8":"^4.1.10","@arethetypeswrong/cli":"^0.18.5","eslint-config-prettier":"^10.1.8","@commitlint/config-conventional":"^21.2.0"},"_npmOperationalInternal":{"tmp":"tmp/google-play-scraper_1.1.0_1785494176693_0.3771673358445995","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@mradex77/google-play-scraper","version":"1.2.0","keywords":["google-play","google-play-scraper","google-play-api","play-store","play-store-api","playstore","scraper","web-scraping","android","android-apps","app-store","app-data","app-reviews","reviews","aso","app-store-optimization","market-research","typescript","nodejs","zod","cli"],"author":{"url":"https://github.com/MrAdex77","name":"MrAdex77"},"license":"MIT","_id":"@mradex77/google-play-scraper@1.2.0","maintainers":[{"name":"mradex77","email":"mradex77@gmail.com"}],"homepage":"https://github.com/MrAdex77/google-play-scraper#readme","bugs":{"url":"https://github.com/MrAdex77/google-play-scraper/issues"},"bin":{"google-play-scraper":"dist/cli.js"},"dist":{"shasum":"a3941b09565a425dad270c35bafa3a75a21b765f","tarball":"https://registry.npmjs.org/@mradex77/google-play-scraper/-/google-play-scraper-1.2.0.tgz","fileCount":11,"integrity":"sha512-40zyOcvfatylVJc+Dx7kTOhhe3kCmOzl9+kzlbtdl2xpw8HoO3pdXR+5vVeOA9SWgjoK+C4AfrROTIo/JuPUXQ==","signatures":[{"sig":"MEQCIA2Sp2Ual1XXyScG0X7Nw5009l9d1ZLC9tikSHGkoijFAiBNGqovGmVCkIRZO8VTL7V8pQbC7t/q3kgaINe3CGKr7A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIHj5zykcWIz7U6UrHIwbrgEvZ/1bdEZnw+50/VcwxJ/OAiA1dUXpE7ZJrZC3kCiEoa4Nfu6YuRXMhA2B3kpWbYchWQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mradex77%2fgoogle-play-scraper@1.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":1363289},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=22.12.0"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}}},"gitHead":"61d599b9049514a38ec6af8d8529f8bfa02c5af8","scripts":{"lint":"eslint .","test":"vitest run --project unit","bench":"vitest bench --run --project unit","build":"tsdown","format":"prettier --write .","example":"tsx examples/all-methods.ts","prepare":"husky","docs:api":"typedoc","lint:fix":"eslint . --fix","test:e2e":"vitest run --project e2e","typecheck":"tsc --noEmit","test:watch":"vitest --project unit","format:check":"prettier --check .","check:package":"pnpm build && publint && attw --pack .","coverage:live":"tsx scripts/live-coverage-report.ts","test:coverage":"vitest run --project unit --coverage","prepublishOnly":"pnpm build","fixtures:update":"tsx scripts/update-fixtures.ts"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:09f5f2a8-153f-45d3-9ee5-3ddb800678db"}},"repository":{"url":"git+https://github.com/MrAdex77/google-play-scraper.git","type":"git"},"_npmVersion":"11.19.0","description":"Google Play scraper for Node.js with a fully typed TypeScript API. Fetch app details, search results, top charts, reviews, permissions and data safety from the Play Store.","directories":{},"lint-staged":{"*.ts":["eslint --fix","prettier --write"],"*.{js,json,md,yml,yaml}":["prettier --write"]},"sideEffects":false,"_nodeVersion":"24.20.0","dependencies":{"zod":"^4.4.3","lru-cache":"^11.5.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.10.0","devDependencies":{"tsx":"^4.23.5","husky":"^9.1.7","eslint":"^10.8.0","tsdown":"^0.22.14","vitest":"^4.1.10","cheerio":"1.2.0","publint":"^0.3.22","typedoc":"^0.28.20","prettier":"^3.9.6","@eslint/js":"^10.0.1","typescript":"^6.0.3","@types/node":"^26.1.2","lint-staged":"^17.3.0","@commitlint/cli":"^21.2.1","typescript-eslint":"^8.65.0","@vitest/coverage-v8":"^4.1.10","@arethetypeswrong/cli":"^0.18.5","eslint-config-prettier":"^10.1.8","@commitlint/config-conventional":"^21.2.0"},"_npmOperationalInternal":{"tmp":"tmp/google-play-scraper_1.2.0_1789127135993_0.2872744597340149","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"name":"@mradex77/google-play-scraper","version":"1.3.0","keywords":["google-play","google-play-scraper","google-play-api","play-store","play-store-api","playstore","scraper","web-scraping","android","android-apps","app-store","app-data","app-reviews","reviews","aso","app-store-optimization","market-research","typescript","nodejs","zod","cli"],"author":{"url":"https://github.com/MrAdex77","name":"MrAdex77"},"license":"MIT","_id":"@mradex77/google-play-scraper@1.3.0","maintainers":[{"name":"mradex77","email":"mradex77@gmail.com"}],"homepage":"https://github.com/MrAdex77/google-play-scraper#readme","bugs":{"url":"https://github.com/MrAdex77/google-play-scraper/issues"},"bin":{"google-play-scraper":"dist/cli.js"},"dist":{"shasum":"152fe05eec9be91a430a2ec35164fe47788c0233","tarball":"https://registry.npmjs.org/@mradex77/google-play-scraper/-/google-play-scraper-1.3.0.tgz","fileCount":11,"integrity":"sha512-3cS7Kvq52QqXQt6kn+R45+zN6jNCIgAn29upOgefjfImqmSQIbsNDrw1aIrYBDHLTlgqMsIqHOn18VOEqqHyJw==","signatures":[{"sig":"MEUCIC261R9+BObbCq2ydnuCoQGi3ttjuNEX7mh4weHidd1RAiEAzttqhG+qXLgSo+7NlO8GaBAyHrE6ANPEHq8vx9XI1ug=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQCxPUC3CwIjqyMvSsUp5cHnBP4yb55PTd+O9+sgV+kswgIgLpC2gtpc7AMsTCBcANtsHEporxD9Ordt10S8wSu7mHc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mradex77%2fgoogle-play-scraper@1.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":1432730},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=22.12.0"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}}},"gitHead":"ccac78ac93d525e4e895e43203aaa744de3afaf3","scripts":{"lint":"eslint .","test":"vitest run --project unit","bench":"vitest bench --run --project unit","build":"tsdown","format":"prettier --write .","example":"node examples/all-methods.ts","prepare":"husky","docs:api":"typedoc","lint:fix":"eslint . --fix","test:e2e":"vitest run --project e2e","typecheck":"tsc --noEmit","test:watch":"vitest --project unit","format:check":"prettier --check .","check:package":"pnpm build && publint && attw --pack .","coverage:live":"node scripts/live-coverage-report.ts","test:coverage":"vitest run --project unit --coverage","prepublishOnly":"pnpm build","fixtures:update":"node scripts/update-fixtures.ts"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:09f5f2a8-153f-45d3-9ee5-3ddb800678db"}},"repository":{"url":"git+https://github.com/MrAdex77/google-play-scraper.git","type":"git"},"_npmVersion":"11.19.0","description":"Google Play scraper for Node.js with a fully typed TypeScript API. Fetch app details, search results, top charts, reviews, permissions and data safety from the Play Store.","directories":{},"lint-staged":{"*.ts":["eslint --fix","prettier --write"],"*.{js,json,md,yml,yaml}":["prettier --write"]},"sideEffects":false,"_nodeVersion":"24.21.0","dependencies":{"zod":"^4.4.3","lru-cache":"^11.5.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.10.0","devDependencies":{"husky":"^9.1.7","eslint":"^10.8.0","tsdown":"^0.23.0","vitest":"^4.1.10","cheerio":"1.2.0","publint":"^0.3.22","typedoc":"^0.28.20","prettier":"^3.9.6","@eslint/js":"^10.0.1","typescript":"^6.0.3","@types/node":"^26.1.2","lint-staged":"^17.3.0","@commitlint/cli":"^21.2.1","typescript-eslint":"^8.65.0","@vitest/coverage-v8":"^4.1.10","@arethetypeswrong/cli":"^0.18.5","eslint-config-prettier":"^10.1.8","@commitlint/config-conventional":"^21.2.0"},"_npmOperationalInternal":{"tmp":"tmp/google-play-scraper_1.3.0_1790239078272_0.33663296078807625","host":"s3://npm-registry-packages-npm-production"}},"1.4.0":{"name":"@mradex77/google-play-scraper","version":"1.4.0","keywords":["google-play","google-play-scraper","google-play-api","play-store","play-store-api","playstore","scraper","web-scraping","android","android-apps","app-store","app-data","app-reviews","reviews","aso","app-store-optimization","market-research","typescript","nodejs","zod","cli"],"author":{"url":"https://github.com/MrAdex77","name":"MrAdex77"},"license":"MIT","_id":"@mradex77/google-play-scraper@1.4.0","maintainers":[{"name":"mradex77","email":"mradex77@gmail.com"}],"homepage":"https://github.com/MrAdex77/google-play-scraper#readme","bugs":{"url":"https://github.com/MrAdex77/google-play-scraper/issues"},"bin":{"google-play-scraper":"dist/cli.js"},"dist":{"shasum":"ccb91a5b718058c14d2a721c88f178dbeebf2c8d","tarball":"https://registry.npmjs.org/@mradex77/google-play-scraper/-/google-play-scraper-1.4.0.tgz","fileCount":11,"integrity":"sha512-AUpz5zitcnW8/+gwG01W++Jf/WIGkVhXiQ5n2cadDxVApYPHm4gd32hPjW1lz93TQDQ/ZAwC7szOly1ieuXxew==","signatures":[{"sig":"MEUCIGtOBrxwyOTsYRe831kmZL7aNwF5HUtq7jH7YiB1rN/WAiEA+vyrKxfU4c9OhQHAs2mWJitqHFena45lE/BoXsMbgj8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQDHyL5HeGhiGdT7yyM5UcZ+AIMB37TLrwIjwF6cqgiPUAIhAK00ivTpT72WBisXqZqgkKuYCEl/LpcJ4oMwOOaRscw/","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mradex77%2fgoogle-play-scraper@1.4.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":1504956},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=22.12.0"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}}},"gitHead":"5b381c95e7708d4239c17a86b8a265b7a31e8743","scripts":{"lint":"eslint .","test":"vitest run --project unit","bench":"vitest bench --run --project \"unit (bench)\" --reporter=verbose","build":"tsdown","format":"prettier --write .","example":"node examples/all-methods.ts","prepare":"husky","docs:api":"typedoc","lint:fix":"eslint . --fix","test:e2e":"vitest run --project e2e","typecheck":"tsc --noEmit","test:watch":"vitest --project unit","format:check":"prettier --check .","check:package":"pnpm build && publint && attw --pack .","coverage:live":"node scripts/live-coverage-report.ts","test:coverage":"vitest run --project unit --coverage","prepublishOnly":"pnpm build","fixtures:update":"node scripts/update-fixtures.ts"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"09f5f2a8-153f-45d3-9ee5-3ddb800678db"}},"repository":{"url":"git+https://github.com/MrAdex77/google-play-scraper.git","type":"git"},"_npmVersion":"11.19.0","description":"Google Play scraper for Node.js with a fully typed TypeScript API. Fetch app details, search results, top charts, reviews, permissions and data safety from the Play Store.","directories":{},"lint-staged":{"*.ts":["eslint --fix","prettier --write"],"*.{js,json,md,yml,yaml}":["prettier --write"]},"sideEffects":false,"_nodeVersion":"24.21.0","dependencies":{"zod":"^4.4.3","lru-cache":"^11.5.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.10.0","devDependencies":{"husky":"^9.1.7","eslint":"^10.8.0","tsdown":"^0.23.0","vitest":"^5.0.3","cheerio":"1.2.0","publint":"^0.3.22","typedoc":"^0.28.20","prettier":"^3.9.6","@eslint/js":"^10.0.1","typescript":"^6.0.3","@types/node":"^26.1.2","lint-staged":"^17.3.0","@commitlint/cli":"^21.2.1","typescript-eslint":"^8.65.0","@vitest/coverage-v8":"^5.0.3","@arethetypeswrong/cli":"^0.18.5","eslint-config-prettier":"^10.1.8","@commitlint/config-conventional":"^21.2.0"},"_npmOperationalInternal":{"tmp":"tmp/google-play-scraper_1.4.0_1791198613668_0.41046472521643174","host":"s3://npm-registry-packages-npm-production"}},"1.4.1":{"name":"@mradex77/google-play-scraper","version":"1.4.1","keywords":["google-play","google-play-scraper","google-play-api","play-store","play-store-api","playstore","scraper","web-scraping","android","android-apps","app-store","app-data","app-reviews","reviews","aso","app-store-optimization","market-research","typescript","nodejs","zod","cli"],"author":{"url":"https://github.com/MrAdex77","name":"MrAdex77"},"license":"MIT","_id":"@mradex77/google-play-scraper@1.4.1","maintainers":[{"name":"mradex77","email":"mradex77@gmail.com"}],"homepage":"https://github.com/MrAdex77/google-play-scraper#readme","bugs":{"url":"https://github.com/MrAdex77/google-play-scraper/issues"},"bin":{"google-play-scraper":"dist/cli.js"},"dist":{"shasum":"df82cd12151864280bf4688a73b0b0df6edced9b","tarball":"https://registry.npmjs.org/@mradex77/google-play-scraper/-/google-play-scraper-1.4.1.tgz","fileCount":11,"integrity":"sha512-1GupqbNFZS4f3g+aHlsHljspLyPzZa86vvXjLKx7zKFuEFQSkH/f1MBQy6oiWIpBdSC2vozODinGaavX6enOWA==","signatures":[{"sig":"MEUCIQCnQq7CHvIBv6hbQY+7Dg+nvKeH7eh7SyIp3DQz2pMergIgTlSXZVE7Pn7ZCuWnAqETpGCSu71URp6qJsjUzZsexsg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQCy8WYt8YCDHDauvyTcdNKy5ve/Bj6mB02lIILNt1L6lwIhALGvWfA2ehfCXllDD4mFK7GKWl03a3O/HPISxRKoHxGP","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mradex77%2fgoogle-play-scraper@1.4.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":1490362},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=22.12.0"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}}},"gitHead":"dfe0e46e9d529e8f0ca78f79cc4a8d9a93ad0a21","scripts":{"lint":"eslint .","test":"vitest run --project unit","bench":"vitest bench --run --project \"unit (bench)\" --reporter=verbose","build":"tsdown","format":"prettier --write .","example":"node examples/all-methods.ts","prepare":"husky","docs:api":"typedoc","lint:fix":"eslint . --fix","test:e2e":"vitest run --project e2e","typecheck":"tsc --noEmit","test:watch":"vitest --project unit","format:check":"prettier --check .","check:package":"pnpm build && publint && attw --pack .","coverage:live":"node scripts/live-coverage-report.ts","test:coverage":"vitest run --project unit --coverage","prepublishOnly":"pnpm build","fixtures:update":"node scripts/update-fixtures.ts"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"09f5f2a8-153f-45d3-9ee5-3ddb800678db"}},"repository":{"url":"git+https://github.com/MrAdex77/google-play-scraper.git","type":"git"},"_npmVersion":"11.19.1","description":"Google Play scraper for Node.js with a fully typed TypeScript API. Fetch app details, search results, top charts, reviews, permissions and data safety from the Play Store.","directories":{},"lint-staged":{"*.ts":["eslint --fix","prettier --write"],"*.{js,json,md,yml,yaml}":["prettier --write"]},"sideEffects":false,"_nodeVersion":"24.22.0","dependencies":{"zod":"^4.4.3","lru-cache":"^11.5.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.10.0","devDependencies":{"husky":"^9.1.7","eslint":"^10.8.0","tsdown":"^0.23.0","vitest":"^5.0.3","cheerio":"1.2.0","publint":"^0.3.22","typedoc":"^0.28.20","prettier":"^3.9.6","@eslint/js":"^10.0.1","typescript":"^6.0.3","@types/node":"^26.1.2","lint-staged":"^17.3.0","@commitlint/cli":"^21.2.1","typescript-eslint":"^8.65.0","@vitest/coverage-v8":"^5.0.3","@arethetypeswrong/cli":"^0.18.5","eslint-config-prettier":"^10.1.8","@commitlint/config-conventional":"^21.2.0"},"_npmOperationalInternal":{"tmp":"tmp/google-play-scraper_1.4.1_1792672656245_0.21456631912165225","host":"s3://npm-registry-packages-npm-production"}},"1.5.0":{"name":"@mradex77/google-play-scraper","version":"1.5.0","keywords":["google-play","google-play-scraper","google-play-api","play-store","play-store-api","playstore","scraper","web-scraping","android","android-apps","app-store","app-data","app-reviews","reviews","aso","app-store-optimization","market-research","typescript","nodejs","cloudflare-workers","zod","cli"],"author":{"url":"https://github.com/MrAdex77","name":"MrAdex77"},"license":"MIT","_id":"@mradex77/google-play-scraper@1.5.0","maintainers":[{"name":"mradex77","email":"mradex77@gmail.com"}],"homepage":"https://github.com/MrAdex77/google-play-scraper#readme","bugs":{"url":"https://github.com/MrAdex77/google-play-scraper/issues"},"bin":{"google-play-scraper":"dist/cli.js"},"dist":{"shasum":"d3298583dba29abc17e9fb3fb32a8c480787b35c","tarball":"https://registry.npmjs.org/@mradex77/google-play-scraper/-/google-play-scraper-1.5.0.tgz","fileCount":11,"integrity":"sha512-aqz2Fq+jbP18hOSEZy1QhGw0eEAHgw7mysfkxwhVy5YoVVIKx95uD2fQRRjYUFVUhAuMBw5cyUyCurLHwuwxZw==","signatures":[{"sig":"MEYCIQCEJQZphSb1u/jzGpDrVMRNMUMV2o4ZxSdYsoUJAUTSWAIhAM/+Ba50KKkbG92PuQJatMht/15yDoz5fDViGHASUfRG","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQDK7LgVTG6D3lxDhBZW1YnzxBZ/PZuxL9ybb3fRonf60QIgATpOG7wGcxnTCbjcJdWDMkTPQUq3vsm1O+FobOJR6GQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mradex77%2fgoogle-play-scraper@1.5.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":1496788},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=22.12.0"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}}},"gitHead":"1b8f957aaacc026edfa62a05cdc7633b208bd060","scripts":{"lint":"eslint .","test":"vitest run --project unit","bench":"vitest bench --run --project \"unit (bench)\" --reporter=verbose","build":"tsdown","format":"prettier --write .","example":"node examples/all-methods.ts","prepare":"husky","docs:api":"typedoc","lint:fix":"eslint . --fix","test:e2e":"vitest run --project e2e","typecheck":"tsc --noEmit","test:watch":"vitest --project unit","format:check":"prettier --check .","test:workers":"pnpm build && vitest run --project workers","check:package":"pnpm build && publint && attw --pack .","coverage:live":"node scripts/live-coverage-report.ts","test:coverage":"vitest run --project unit --coverage","prepublishOnly":"pnpm build","fixtures:update":"node scripts/update-fixtures.ts"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"09f5f2a8-153f-45d3-9ee5-3ddb800678db"}},"repository":{"url":"git+https://github.com/MrAdex77/google-play-scraper.git","type":"git"},"_npmVersion":"11.19.1","description":"Google Play scraper for Node.js and Cloudflare Workers with a fully typed TypeScript API. Fetch app details, search results, top charts, reviews, permissions and data safety from the Play Store.","directories":{},"lint-staged":{"*.ts":["eslint --fix","prettier --write"],"*.{js,json,md,yml,yaml}":["prettier --write"]},"sideEffects":false,"_nodeVersion":"24.22.1","dependencies":{"zod":"^4.4.3","lru-cache":"^11.5.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.10.0","devDependencies":{"husky":"^9.1.7","eslint":"^10.8.0","tsdown":"^0.23.0","vitest":"^5.0.3","cheerio":"1.2.0","esbuild":"^0.28.2","publint":"^0.3.22","typedoc":"^0.28.20","prettier":"^3.9.6","miniflare":"^4.20260730.0","@eslint/js":"^10.0.1","typescript":"^6.0.3","@types/node":"^26.1.2","lint-staged":"^17.3.0","@commitlint/cli":"^21.2.1","typescript-eslint":"^8.65.0","@vitest/coverage-v8":"^5.0.3","@arethetypeswrong/cli":"^0.18.5","eslint-config-prettier":"^10.1.8","@commitlint/config-conventional":"^21.2.0"},"_npmOperationalInternal":{"tmp":"tmp/google-play-scraper_1.5.0_1793311842824_0.5585160660724746","host":"s3://npm-registry-packages-npm-production"}},"1.6.0":{"_id":"@mradex77/google-play-scraper@1.6.0","bin":{"google-play-scraper":"dist/cli.js"},"bugs":{"url":"https://github.com/MrAdex77/google-play-scraper/issues"},"dist":{"shasum":"683d0a251e8998d4db08d516b2261802cf94a347","tarball":"https://registry.npmjs.org/@mradex77/google-play-scraper/-/google-play-scraper-1.6.0.tgz","fileCount":11,"integrity":"sha512-a+/qZvRxPJb3rEm0C8/6RAS+syqrc/pNdBAz5d6Lrr8fxtCp3m5TlS/eloue1Dr5oi7TLHuHkKyd/t1nlLWblg==","signatures":[{"sig":"MEUCIQD40fg971PcLDD233kp2SedFeNeaT5B4jQnofDhWRXhBQIgWeXuSbaxcIIhyea9AUrovd4VICSIEEAZ9+lc6MsidP8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDQ07w1vF4lo6Cqgiz2xOO2RQd9N1qFFPOS5QsBBKeM+QIhAL/WiwQHhshgDEXeozT5RmuNMGDDlB4AsIRqMeXFSDQK"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mradex77%2fgoogle-play-scraper@1.6.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":1538868},"main":"./dist/index.cjs","name":"@mradex77/google-play-scraper","type":"module","types":"./dist/index.d.ts","author":{"url":"https://github.com/MrAdex77","name":"MrAdex77"},"module":"./dist/index.js","engines":{"node":">=22.12.0"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}}},"funding":{"url":"https://github.com/sponsors/MrAdex77","type":"github"},"gitHead":"72acf0a78f0d2ad742fb89e6c2f66d3355f167a3","license":"MIT","scripts":{"lint":"eslint .","test":"vitest run --project unit","bench":"vitest bench --run --project \"unit (bench)\" --reporter=verbose","build":"tsdown","format":"prettier --write .","example":"node examples/all-methods.ts","prepare":"husky","docs:api":"typedoc","lint:fix":"eslint . --fix","test:e2e":"vitest run --project e2e","typecheck":"tsc --noEmit","test:watch":"vitest --project unit","format:check":"prettier --check .","test:workers":"pnpm build && vitest run --project workers","check:package":"pnpm build && publint && attw --pack .","coverage:live":"node scripts/live-coverage-report.ts","test:coverage":"vitest run --project unit --coverage","prepublishOnly":"pnpm build","fixtures:update":"node scripts/update-fixtures.ts"},"version":"1.6.0","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"09f5f2a8-153f-45d3-9ee5-3ddb800678db"}},"homepage":"https://github.com/MrAdex77/google-play-scraper#readme","keywords":["google-play","google-play-scraper","google-play-api","play-store","play-store-api","playstore","scraper","web-scraping","android","android-apps","app-store","app-data","app-reviews","reviews","aso","app-store-optimization","market-research","typescript","nodejs","cloudflare-workers","zod","cli"],"repository":{"url":"git+https://github.com/MrAdex77/google-play-scraper.git","type":"git"},"_npmVersion":"11.19.1","description":"Google Play scraper for Node.js and Cloudflare Workers with a fully typed TypeScript API. Fetch app details, search results, top charts, reviews, permissions and data safety from the Play Store.","directories":{},"lint-staged":{"*.ts":["eslint --fix","prettier --write"],"*.{js,json,md,yml,yaml}":["prettier --write"]},"maintainers":[{"name":"mradex77","email":"mradex77@gmail.com"}],"sideEffects":false,"_nodeVersion":"24.22.2","dependencies":{"zod":"^4.4.3","lru-cache":"^11.5.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.10.0","devDependencies":{"husky":"^9.1.7","eslint":"^10.8.0","tsdown":"^0.23.0","vitest":"^5.0.3","cheerio":"1.2.0","esbuild":"^0.28.2","publint":"^0.3.22","typedoc":"^0.28.20","prettier":"^3.9.6","miniflare":"^4.20260730.0","@eslint/js":"^10.0.1","typescript":"^6.0.3","@types/node":"^26.1.2","lint-staged":"^17.3.0","@commitlint/cli":"^21.2.1","typescript-eslint":"^8.65.0","@vitest/coverage-v8":"^5.0.3","@arethetypeswrong/cli":"^0.18.5","eslint-config-prettier":"^10.1.8","@commitlint/config-conventional":"^21.2.0"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/google-play-scraper_1.6.0_1793972482848_0.18861028783654954"}}},"time":{"created":"2026-07-08T10:12:07.615Z","modified":"2026-11-06T13:41:23.322Z","0.1.1":"2026-07-08T10:12:08.043Z","0.2.0":"2026-07-08T12:54:14.493Z","0.3.0":"2026-07-09T09:31:53.795Z","0.4.0":"2026-07-15T09:14:59.267Z","0.4.1":"2026-07-15T20:00:47.813Z","1.0.0":"2026-07-17T17:32:08.180Z","1.1.0":"2026-07-31T10:36:16.840Z","1.2.0":"2026-09-11T11:45:36.099Z","1.3.0":"2026-09-24T08:37:58.349Z","1.4.0":"2026-10-05T11:10:13.820Z","1.4.1":"2026-10-22T12:37:36.411Z","1.5.0":"2026-10-29T22:10:42.926Z","1.6.0":"2026-11-06T13:41:22.973Z"},"bugs":{"url":"https://github.com/MrAdex77/google-play-scraper/issues"},"author":{"url":"https://github.com/MrAdex77","name":"MrAdex77"},"license":"MIT","homepage":"https://github.com/MrAdex77/google-play-scraper#readme","keywords":["google-play","google-play-scraper","google-play-api","play-store","play-store-api","playstore","scraper","web-scraping","android","android-apps","app-store","app-data","app-reviews","reviews","aso","app-store-optimization","market-research","typescript","nodejs","cloudflare-workers","zod","cli"],"repository":{"url":"git+https://github.com/MrAdex77/google-play-scraper.git","type":"git"},"description":"Google Play scraper for Node.js and Cloudflare Workers with a fully typed TypeScript API. Fetch app details, search results, top charts, reviews, permissions and data safety from the Play Store.","maintainers":[{"name":"mradex77","email":"mradex77@gmail.com"}],"readme":"# google-play-scraper\n\n[![npm version](https://img.shields.io/npm/v/@mradex77/google-play-scraper.svg)](https://www.npmjs.com/package/@mradex77/google-play-scraper)\n[![npm downloads](https://img.shields.io/npm/dm/@mradex77/google-play-scraper.svg)](https://www.npmjs.com/package/@mradex77/google-play-scraper)\n[![CI](https://github.com/MrAdex77/google-play-scraper/actions/workflows/ci.yml/badge.svg)](https://github.com/MrAdex77/google-play-scraper/actions/workflows/ci.yml)\n[![Live contract tests](https://github.com/MrAdex77/google-play-scraper/actions/workflows/e2e.yml/badge.svg)](https://github.com/MrAdex77/google-play-scraper/actions/workflows/e2e.yml)\n[![coverage](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/MrAdex77/5aa7b737d6fb2adae68cb61693cfa123/raw/google-play-scraper-coverage.json)](https://github.com/MrAdex77/google-play-scraper/actions/workflows/ci.yml)\n[![node](https://img.shields.io/node/v/@mradex77/google-play-scraper.svg)](https://nodejs.org)\n[![license](https://img.shields.io/npm/l/@mradex77/google-play-scraper.svg)](LICENSE)\n\n**Scrape Google Play app data in Node.js and Cloudflare Workers with a fully typed TypeScript API.** Fetch app details, search results, top charts, developer pages, similar apps, reviews, permissions and data safety reports straight from the Play Store, validated at runtime and returned as typed objects.\n\nThis is a TypeScript rewrite of the unmaintained [`google-play-scraper`](https://github.com/facundoolano/google-play-scraper) package. Thanks to [facundoolano](https://github.com/facundoolano) for the years of work on the original: without it this library would not exist. Method names, options and constants match the original, so most migrations are an import swap.\n\n[API reference](https://mradex77.github.io/google-play-scraper/) · [Examples](https://github.com/MrAdex77/google-play-scraper/tree/main/examples) · [Changelog](CHANGELOG.md) · [Migration guide](#migrating-from-google-play-scraper)\n\nIf you need a hosted ASO tool rather than a library, [AsoBeast](https://asobeast.com) tracks keyword ranks daily on Google Play and the App Store, watches competitor listings and alerts on changes, audits store listings with keyword ideas, and exposes a REST API and an MCP server. It is open source and self-hostable.\n\n## Highlights\n\n- Typed results. Every method returns a TypeScript type derived from the [zod](https://zod.dev) schema that validates the scraped data at runtime.\n- No HTTP dependency. Runs on the native `fetch` of Node.js 22.12 and newer and of [Cloudflare Workers](#cloudflare-workers).\n- Survives layout changes. Every Google Play array path sits behind ordered fallback paths, so one moved index does not break a call.\n- Checked against live Google Play daily. Contract tests run in CI on a schedule and open a labeled issue when Google changes its layout.\n- Typed errors. Branch on `NotFoundError`, `RateLimitError` or `SpecError` instead of parsing message strings.\n- Throttling, retries and caching built in. Rate limiting, exponential backoff with `Retry-After` support and an optional memoized client.\n- ESM and CommonJS builds with type declarations from a single package.\n\n## Comparison with the original\n\n| Capability           | @mradex77/google-play-scraper      | facundoolano/google-play-scraper           |\n| -------------------- | ---------------------------------- | ------------------------------------------ |\n| Language             | TypeScript in strict mode          | JavaScript                                 |\n| Type definitions     | Generated from zod schemas         | Community typings                          |\n| Runtime validation   | zod/mini on every input and output | None                                       |\n| Error handling       | Typed error classes                | Plain `Error`                              |\n| Module formats       | ESM and CommonJS with `.d.ts`      | ESM only                                   |\n| Runtime dependencies | `zod`, `lru-cache`                 | `cheerio`, `got`, `memoizee`, `ramda`, ... |\n| Breakage detection   | Daily live contract tests in CI    | None                                       |\n| Maintenance          | Active                             | Unmaintained                               |\n\n## Sponsors\n\nSponsorship funds the maintenance of this library: the daily live contract tests, and the fixes that ship when Google changes the Play Store.\n\nCompanies get their logo and a short description here and on the npm page, in front of developers who collect Google Play data at scale. [Become a sponsor](https://github.com/sponsors/MrAdex77).\n\n## Table of contents\n\n- [Installation](#installation)\n- [Quick start](#quick-start)\n- [CLI](#cli)\n- [Common options](#common-options)\n- [Shared client](#shared-client)\n- [Methods](#methods)\n- [Streaming and bulk reads](#streaming-and-bulk-reads)\n- [Constants](#constants)\n- [Error handling](#error-handling)\n- [Throttling and requestOptions](#throttling-and-requestoptions)\n- [Cloudflare Workers](#cloudflare-workers)\n- [Resilience](#resilience)\n- [Monitoring drift](#monitoring-drift)\n- [Versioning and API stability](#versioning-and-api-stability)\n- [Migrating from google-play-scraper](#migrating-from-google-play-scraper)\n- [FAQ](#faq)\n- [Related projects](#related-projects)\n- [Contributing](#contributing)\n- [Disclaimer](#disclaimer)\n- [License](#license)\n\n## Installation\n\n```sh\nnpm install @mradex77/google-play-scraper\n```\n\nRequires Node.js 22.12 or newer, or a [Cloudflare Worker](#cloudflare-workers).\n\n## Quick start\n\nThe package exposes named exports and an aggregate default export. Use whichever style you prefer.\n\n```typescript\nimport gplay from '@mradex77/google-play-scraper';\n\nconst app = await gplay.app({ appId: 'com.google.android.apps.translate' });\nconsole.log(app.title, app.score);\n```\n\n```typescript\nimport { app, type App } from '@mradex77/google-play-scraper';\n\nconst details: App = await app({ appId: 'com.google.android.apps.translate' });\nconsole.log(details.installs);\n```\n\nCommonJS works too:\n\n```javascript\nconst gplay = require('@mradex77/google-play-scraper').default;\n\ngplay.search({ term: 'panda' }).then((results) => {\n  console.log(results.length);\n});\n```\n\nMore runnable examples live in [examples/](https://github.com/MrAdex77/google-play-scraper/tree/main/examples).\n\n## CLI\n\nEvery method with a JSON-friendly surface is also available from the command line, no install required:\n\n```sh\nnpx @mradex77/google-play-scraper app com.spotify.music\nnpx @mradex77/google-play-scraper search \"sleep tracker\" --num 5 --country de\nnpx @mradex77/google-play-scraper reviews com.mojang.minecraftpe --sort rating --num 20\nnpx @mradex77/google-play-scraper reviews com.whatsapp --score 1 --device tablet --num 50\nnpx @mradex77/google-play-scraper availability com.adex77.WhereAmI --countries us,pl,de\n```\n\n| Command                | Positional              | Own flags                                                                        |\n| ---------------------- | ----------------------- | -------------------------------------------------------------------------------- |\n| `app <appId>`          | app id                  |                                                                                  |\n| `apps <appIds>`        | comma-separated app ids | `--concurrency`                                                                  |\n| `search <term>`        | search term             | `--num`, `--price`, `--full-detail`                                              |\n| `suggest <term>`       | search term             |                                                                                  |\n| `list`                 |                         | `--collection`, `--category`, `--age`, `--num`, `--full-detail`                  |\n| `developer <devId>`    | developer id            | `--num`, `--full-detail`                                                         |\n| `similar <appId>`      | app id                  | `--full-detail`                                                                  |\n| `reviews <appId>`      | app id                  | `--num`, `--sort`, `--score`, `--device`, `--page-size`, `--paginate`, `--token` |\n| `permissions <appId>`  | app id                  | `--short`                                                                        |\n| `data-safety <appId>`  | app id                  |                                                                                  |\n| `categories`           |                         |                                                                                  |\n| `availability <appId>` | app id                  | `--countries` (comma-separated, required), `--concurrency`                       |\n\nEvery command also accepts `--lang <code>`, `--country <code>` and `--throttle <requestsPerSecond>`, plus `--help`/`-h` (global or per command) and the global `--version`.\n\nResults are pretty-printed JSON on stdout, so the output pipes into `jq`:\n\n```sh\nnpx @mradex77/google-play-scraper app com.spotify.music | jq '{title, score, installs}'\n```\n\nExit codes: `0` success, `1` scrape failure (not found, rate limited, blocked, network), `2` usage error (unknown command or flag, missing argument, invalid option value). A malformed app id (see [App ids](#app-ids)) exits `2` with the usage line and sends no request. `apps` is the exception: it prints the malformed entry as `rejected` and exits `0`, as it does for a missing app. Whitespace around the commas in `apps` is trimmed before validation, so `apps \"com.whatsapp, com.spotify.music\"` works.\n\n## Common options\n\nEvery method accepts a single options object. These options are available on all of them:\n\n| Option             | Type       | Default | Description                                                                                            |\n| ------------------ | ---------- | ------- | ------------------------------------------------------------------------------------------------------ |\n| `lang`             | `string`   | `'en'`  | Two letter language code used to fetch the page.                                                       |\n| `country`          | `string`   | `'us'`  | Two letter country code. Needed for apps available only in some regions.                               |\n| `throttle`         | `number`   | none    | Maximum requests per second across a single call.                                                      |\n| `requestOptions`   | `object`   | none    | HTTP overrides. See [Throttling and requestOptions](#throttling-and-requestoptions).                   |\n| `onDegradation`    | `function` | none    | Called when a call degrades gracefully. See [Monitoring drift](#monitoring-drift).                     |\n| `onIntegrityEvent` | `function` | none    | Called when routing, parsing or pagination needs attention. See [Monitoring drift](#monitoring-drift). |\n\n## Shared client\n\nEach top-level function builds its own HTTP client, so a `throttle` passed to one call only limits the requests made inside that call, such as the pagination pages of one `search()`. Ten parallel `app()` calls with `throttle: 1` each get their own limiter and still reach Google Play at the same time.\n\n`createClient` shares one rate limiter, one set of request options and one pair of `lang`/`country` defaults across every method of the client:\n\n```typescript\nimport { createClient } from '@mradex77/google-play-scraper';\n\nconst client = createClient({ country: 'pl', lang: 'pl', throttle: 5 });\n\nconst ids = ['com.foo', 'com.bar', 'com.baz'];\nconst details = await Promise.all(ids.map((appId) => client.app({ appId })));\n```\n\nThat batch never exceeds five requests per second in total, including the `fullDetail` app lookups made by `search`, `list`, `developer` and `similar`.\n\nPrecedence rules:\n\n1. A client-level `throttle` is one shared limiter for every call, including pagination pages and `fullDetail` lookups.\n2. A per-call `throttle` on a client method is superseded by the client limiter. Without a client `throttle`, it creates a call-scoped limiter, as on the top-level functions.\n3. `requestOptions` merge shallowly, with per-call keys winning: `{ ...client, ...call }`.\n4. Per-call `lang` and `country` win over the client defaults; the built-in `en`/`us` defaults apply last.\n5. A client-level `onDegradation` or `onIntegrityEvent` applies to every call, including the lookups the client makes for you. A per-call callback replaces it for that call; callbacks do not chain.\n\nEvery method from the [reference below](#methods) is available on the client, alongside the exported constants. Two clients never share a limiter. [`memoized`](#memoized) accepts the same options and adds an LRU cache on top.\n\n## Methods\n\n- [app](#app): full detail of a single application\n- [apps](#apps): full detail of many applications in one call\n- [availability](#availability): the countries an app is published in\n- [search](#search): apps matching a search term\n- [suggest](#suggest): search term autocompletions\n- [list](#list): a ranked collection of apps\n- [developer](#developer): other apps by the same developer\n- [similar](#similar): apps related to a given app\n- [reviews](#reviews): user reviews for an app\n- [permissions](#permissions): permissions an app requests\n- [dataSafety](#datasafety): the data safety section of an app\n- [categories](#categories): the Google Play category taxonomy\n- [memoized](#memoized): a shared client that caches equivalent calls\n\n### App ids\n\nEvery `appId` is validated before any request, on every method, iterator, client and CLI command. It must be an Android package name: at least two dot-separated segments, each starting with a letter and containing only letters, digits and underscores, at most 255 characters in total. Case is significant (`com.adex77.WhereAmI` and `com.adex77.whereami` are different ids on Google Play), so ids are never lowercased. Leading or trailing whitespace is rejected rather than trimmed, so the id you pass is the id that is requested and echoed back. The rule follows the [Android application ID rules](https://developer.android.com/build/configure-app-module).\n\nA malformed id throws `ValidationError` without reaching Google Play. The one exception is [`apps`](#apps), which reports that entry as `rejected` with a `ValidationError`, the same way it reports a missing app, and sends no request for it. An empty string in `appIds` still fails validation of the whole call.\n\n```typescript\nimport { app, ValidationError } from '@mradex77/google-play-scraper';\n\ntry {\n  await app({ appId: 'com.whatsapp ' });\n} catch (error) {\n  if (error instanceof ValidationError) {\n    console.error(error.message);\n  }\n}\n```\n\n### Return types\n\n`list`, `search`, `developer` and `similar` return their item type, or `App[]` when `fullDetail` is `true`. `permissions` returns `AppPermission[]`, or `string[]` when `short` is `true`. TypeScript follows the flag on every entry point (the named exports, the default export, `createClient()` and `memoized()`): pass the literal `true` and the result is typed `App[]` (or `string[]`), leave the flag out or pass `false` and it is the item type, so no cast is needed. A flag held in a `boolean` variable gives the union of both types, because the shape then depends on its value at runtime. The same happens to an options object stored in a variable before the call, since TypeScript widens its `true` to `boolean`; write the object inline or declare it `as const` to keep the narrow type.\n\n```typescript\nimport { list, permissions } from '@mradex77/google-play-scraper';\n\nconst detailed = await list({ num: 5, fullDetail: true });\nconst firstDescription = detailed[0]?.description;\n\nconst names = await permissions({ appId: 'com.whatsapp', short: true });\nconst upper = names.map((name) => name.toUpperCase());\n```\n\n### app\n\nRetrieves the full detail of an application.\n\n| Option  | Type     | Default  | Description                                                             |\n| ------- | -------- | -------- | ----------------------------------------------------------------------- |\n| `appId` | `string` | required | The Google Play id (the `?id=` url parameter), see [App ids](#app-ids). |\n\n```typescript\nimport { app } from '@mradex77/google-play-scraper';\n\nconst details = await app({ appId: 'com.google.android.apps.translate' });\n```\n\nReturns an `App` with 59 fields. Trimmed:\n\n```javascript\n{\n  title: 'Google Translate',\n  description: 'Translate between up to 133 languages...',\n  descriptionHTML: 'Translate between up to 133 languages...<br>...',\n  summary: 'Instantly translate text, speech and images in over 100 languages',\n  summaryHTML: 'Instantly translate text, speech and images in over 100 languages',\n  installs: '1,000,000,000+',\n  minInstalls: 1000000000,\n  score: 4.48,\n  scoreText: '4.5',\n  ratings: 8765432,\n  reviews: 5678901,\n  histogram: { '1': 123456, '2': 45678, '3': 90123, '4': 234567, '5': 4567890 },\n  price: 0,\n  free: true,\n  currency: 'USD',\n  priceText: 'Free',\n  available: true,\n  offersIAP: false,\n  androidVersion: '8.0',\n  androidVersionText: '8.0 and up',\n  developer: 'Google LLC',\n  developerId: '5700313618786177705',\n  developerEmail: 'apps-help@google.com',\n  developerWebsite: 'http://support.google.com/translate',\n  genre: 'Tools',\n  genreId: 'TOOLS',\n  categories: [{ name: 'Tools', id: 'TOOLS' }],\n  icon: 'https://play-lh.googleusercontent.com/...',\n  screenshots: ['https://play-lh.googleusercontent.com/...'],\n  contentRating: 'Everyone',\n  adSupported: false,\n  updated: 1719878400000,\n  version: 'Varies with device',\n  recentChanges: 'Bug fixes and improvements.\\nNew offline languages',\n  recentChangesHTML: 'Bug fixes and improvements.<br>New offline languages',\n  comments: [],\n  appId: 'com.google.android.apps.translate',\n  url: 'https://play.google.com/store/apps/details?id=com.google.android.apps.translate'\n}\n```\n\n`description`, `summary` and `recentChanges` are plain text: tags are removed, the entities Google uses (`&amp;`, `&lt;`, `&gt;`, `&quot;`, `&apos;`, `&nbsp;` and numeric references) are decoded and each `<br>` becomes a newline. Escape these fields like any other text before inserting them into HTML.\n\nEach of them has a markup twin read from the same Google cell: `descriptionHTML`, `summaryHTML` and `recentChangesHTML` keep the tags and entities as Google serves them (control characters removed), and a twin is present exactly when its plain text field is. The markup is written by the app developer and filtered by Google, so pass it through your own HTML sanitizer before inserting it into a page.\n\nA listing that has not been released yet carries no offer. For those apps `preregister` is `true`, and `price`, `free` and `priceText` fall back to `0`, `false` and `'Free'` without describing a real offer. Rating, install and release fields are absent too. Read `preregister` before trusting any price field:\n\n```ts\nconst details = await app({ appId: 'com.ironhidegames.android.kingdomrush6.genesis' });\n\nif (details.preregister) {\n  console.log(`${details.title} has no price yet`);\n}\n```\n\nA `search()` row for an unreleased app is returned with `price: 0` and `free: false` in the same way, so a `price: 'free'` filter will not match it.\n\n### apps\n\nFetches the full detail of many apps in one call, with a concurrency limit and per-id failure capture. One missing app never rejects the whole batch, and results stay aligned with the input order. Only library failures are captured: a [cancelled](#cancellation) call rejects with your abort reason, and a throwing callback rejects with its own error.\n\n| Option        | Type       | Default  | Description                                                                        |\n| ------------- | ---------- | -------- | ---------------------------------------------------------------------------------- |\n| `appIds`      | `string[]` | required | Between `1` and `250` Google Play ids, see [App ids](#app-ids) for malformed ones. |\n| `concurrency` | `number`   | `5`      | Maximum number of app lookups in flight at once, from `1` to `20`.                 |\n\n```typescript\nimport { apps } from '@mradex77/google-play-scraper';\n\nconst result = await apps({\n  appIds: ['com.whatsapp', 'com.spotify.music', 'com.gone.app'],\n  concurrency: 5,\n});\n```\n\nEach entry is a discriminated union keyed on `status`; narrow on it to read the parsed `App` or the typed error:\n\n```typescript\nfor (const entry of result) {\n  if (entry.status === 'fulfilled') {\n    console.log(entry.appId, entry.app.title);\n  } else {\n    console.error(entry.appId, entry.error.name);\n  }\n}\n```\n\n```typescript\ntype AppsEntry =\n  | { appId: string; status: 'fulfilled'; app: App }\n  | { appId: string; status: 'rejected'; error: GooglePlayError };\n```\n\n`apps` does not deduplicate `appIds`: a list with the same id twice fetches it twice. Use a [`memoized`](#memoized) client to serve repeated ids from cache.\n\n`concurrency` and a client [`throttle`](#throttling-and-requestoptions) are independent limits: `concurrency` bounds the lookups in flight, `throttle` bounds how many requests start per second. With `createClient({ throttle: 2 }).apps({ appIds, concurrency: 5 })`, up to five lookups can be in flight while at most two requests start per second.\n\n### availability\n\nAnswers \"in which countries is this app published?\" by probing the Google Play details page once per country. Each probe is a plain `GET` whose HTTP status is the whole answer, so the body is never parsed and a probe costs far less than an `app` lookup.\n\n| Option        | Type       | Default  | Description                                                      |\n| ------------- | ---------- | -------- | ---------------------------------------------------------------- |\n| `appId`       | `string`   | required | The Google Play id to probe, see [App ids](#app-ids).            |\n| `countries`   | `string[]` | required | Between `1` and `50` ISO 3166-1 alpha-2 codes, case insensitive. |\n| `lang`        | `string`   | `'en'`   | The `hl` language of each probe.                                 |\n| `concurrency` | `number`   | `5`      | Maximum number of probes in flight at once, from `1` to `20`.    |\n\n```typescript\nimport { availability } from '@mradex77/google-play-scraper';\n\nconst result = await availability({\n  appId: 'com.adex77.WhereAmI',\n  countries: ['us', 'pl', 'de', 'jp'],\n});\n```\n\n```javascript\n{\n  appId: 'com.adex77.WhereAmI',\n  countries: {\n    us: { status: 'available' },\n    pl: { status: 'available' },\n    de: { status: 'available' },\n    jp: { status: 'unavailable' },\n  },\n}\n```\n\nEach country resolves to one of three statuses:\n\n- `available`: the probe returned `200`; the app is published in that storefront.\n- `unavailable`: the probe returned `404`; the app is not published there.\n- `error`: the probe could not tell. A block (consent wall or captcha), a rate limit, any other HTTP failure or a network error, with the original `message` preserved.\n\nA [cancelled](#cancellation) call rejects with your abort reason instead of reporting countries as `error`. `error` is never collapsed into `unavailable`: a blocked or rate-limited probe means \"could not determine\", which must not read as \"not published\" in data used for release decisions. Country codes are returned lowercased, duplicates (ignoring case) are rejected, and a single call probes at most `50` countries.\n\nGoogle Play geoblocking depends on the caller's IP as much as on the `gl` parameter, so pair `availability` with [`createCountryFetch`](#routing-by-country). Each probe carries `gl=<country>`, so a per-country route sends the `us` probe through a US proxy and the `de` probe through a German one.\n\n### search\n\nRetrieves apps that match a search term.\n\n| Option       | Type                        | Default  | Description                                                                  |\n| ------------ | --------------------------- | -------- | ---------------------------------------------------------------------------- |\n| `term`       | `string`                    | required | The search query.                                                            |\n| `num`        | `number`                    | `20`     | Number of results, up to `250`. Best-effort above the first page, see below. |\n| `price`      | `'all' \\| 'free' \\| 'paid'` | `'all'`  | Filter results by price.                                                     |\n| `fullDetail` | `boolean`                   | `false`  | When `true`, fetch and return the full `App` for each result.                |\n\n```typescript\nimport { search } from '@mradex77/google-play-scraper';\n\nconst results = await search({ term: 'panda', num: 5 });\n```\n\nReturns `SearchResult[]`, or `App[]` when `fullDetail` is `true` (see [Return types](#return-types)). Trimmed:\n\n```javascript\n[\n  {\n    title: 'Panda VPN',\n    appId: 'com.example.pandavpn',\n    url: 'https://play.google.com/store/apps/details?id=com.example.pandavpn',\n    icon: 'https://play-lh.googleusercontent.com/...',\n    developer: 'Panda Labs',\n    currency: 'USD',\n    price: 0,\n    free: true,\n    summary: 'Fast and secure VPN',\n    summaryHTML: 'Fast and secure VPN',\n    scoreText: '4.3',\n    score: 4.3,\n  },\n];\n```\n\nFirst page results have no `developerId`, except the exact match entry that Google shows first for a term naming an app. Results from a continuation page carry the id of the developer link Google serves with them, and keep `developerId` undefined when that link is missing, see [Migrating from google-play-scraper](#migrating-from-google-play-scraper).\n\nThe `summary` of a search result, like the `summary` of every `list`, `developer` and `similar` item, is plain text. Google fills that cell with the app description markup (often thousands of characters), and the library strips the tags, decodes the entities and turns each `<br>` into a newline. `summaryHTML` carries the same cell with its markup, for callers that render HTML (sanitize it first, as for [app](#app)).\n\nGoogle Play serves a first result page of roughly 20 to 30 apps (50 for single character terms), and fewer for narrow terms. For a minority of queries it also serves a continuation token (verified October 2026: single character terms and digits, and some app names such as `minecraft` or `reddit`), and `search()` and `searchIterator()` follow it until Google ends the results, measured at no more than 250 in total. Continuation results are looser matches than the first page and carry `currency` only for paid apps. For every other term the first page is all Google serves, so a `num` above it is best-effort: the returned array may be shorter than requested, never longer, and never repeats an app.\n\n### suggest\n\nGiven a partial term, returns up to five search completions.\n\n| Option | Type     | Default  | Description               |\n| ------ | -------- | -------- | ------------------------- |\n| `term` | `string` | required | The partial search query. |\n\n```typescript\nimport { suggest } from '@mradex77/google-play-scraper';\n\nconst suggestions = await suggest({ term: 'pand' });\n```\n\nReturns `string[]`:\n\n```javascript\n['panda', 'pandora', 'panda vpn', 'panda pop', 'pandora music'];\n```\n\n### list\n\nRetrieves a ranked collection of apps, optionally scoped to a category and an age bracket.\n\n| Option       | Type         | Default                | Description                                              |\n| ------------ | ------------ | ---------------------- | -------------------------------------------------------- |\n| `collection` | `Collection` | `collection.TOP_FREE`  | One of `TOP_FREE`, `TOP_PAID`, `GROSSING`.               |\n| `category`   | `Category`   | `category.APPLICATION` | Any [category](#constants) constant.                     |\n| `age`        | `Age`        | none                   | One of `age.FIVE_UNDER`, `age.SIX_EIGHT`, `age.NINE_UP`. |\n| `num`        | `number`     | `500`                  | Number of results.                                       |\n| `fullDetail` | `boolean`    | `false`                | When `true`, return the full `App` for each result.      |\n\n```typescript\nimport { list, collection, category } from '@mradex77/google-play-scraper';\n\nconst items = await list({\n  collection: collection.TOP_FREE,\n  category: category.GAME,\n  num: 5,\n});\n```\n\nReturns `ListItem[]`, or `App[]` when `fullDetail` is `true` (see [Return types](#return-types)), each item shaped like a [search](#search) result.\n\nGoogle Play serves at most roughly 200 list items per request (verified July 2026), so a `num` above that ceiling, including the default `500`, returns fewer items than requested.\n\n### developer\n\nReturns other apps published by the same developer. The `devId` is either the numeric developer id or the developer name, exactly as it appears on Google Play.\n\n| Option       | Type      | Default  | Description                                         |\n| ------------ | --------- | -------- | --------------------------------------------------- |\n| `devId`      | `string`  | required | Numeric developer id or developer name.             |\n| `num`        | `number`  | `60`     | Number of results.                                  |\n| `fullDetail` | `boolean` | `false`  | When `true`, return the full `App` for each result. |\n\n```typescript\nimport { developer } from '@mradex77/google-play-scraper';\n\nconst apps = await developer({ devId: '5700313618786177705' });\n```\n\nReturns `DeveloperApp[]`, or `App[]` when `fullDetail` is `true` (see [Return types](#return-types)), each item shaped like a [search](#search) result. Items past the first page carry `developerId` when Google serves a developer link with them (it stays undefined otherwise), and items on the first page have none, as in the original. For a developer Google links by number it is the numeric id, even when `devId` was the name (`Google LLC` items carry `5700313618786177705`). Pass `fullDetail: true` to get it for every item.\n\nThe `developerId` that [app](#app) returns (and the one a [search](#search) exact match or a continuation item of `search`, `developer` or `similar` carries) is already in this form, so it can be passed straight back: a numeric id for developers Google links by number, otherwise the plain developer name such as `WhatsApp LLC`, `H&M` or `Moon+`. It is the decoded name, never the form encoded query value (`WhatsApp+LLC`, `H%26M`) that the Google Play link holds; the library encodes it again when it builds the request.\n\n```typescript\nimport { app, developer } from '@mradex77/google-play-scraper';\n\nconst whatsapp = await app({ appId: 'com.whatsapp' });\nconst catalogue = await developer({ devId: whatsapp.developerId });\n```\n\n### similar\n\nReturns apps related to a given app.\n\n| Option       | Type      | Default  | Description                                                       |\n| ------------ | --------- | -------- | ----------------------------------------------------------------- |\n| `appId`      | `string`  | required | The Google Play id of the reference app, see [App ids](#app-ids). |\n| `fullDetail` | `boolean` | `false`  | When `true`, return the full `App` for each result.               |\n\n```typescript\nimport { similar } from '@mradex77/google-play-scraper';\n\nconst apps = await similar({ appId: 'com.google.android.apps.translate' });\n```\n\nReturns `SimilarApp[]`, or `App[]` when `fullDetail` is `true` (see [Return types](#return-types)), each item shaped like a [search](#search) result. Items past the first page carry `developerId` when Google serves a developer link with them (it stays undefined otherwise), and items on the first page have none, as in the original. Pass `fullDetail: true` to get it for every item.\n\n### reviews\n\nRetrieves reviews for an app. Reviews always come back inside a `{ data, nextPaginationToken }` envelope so paging is uniform.\n\n| Option                | Type       | Default       | Description                                                                                                      |\n| --------------------- | ---------- | ------------- | ---------------------------------------------------------------------------------------------------------------- |\n| `appId`               | `string`   | required      | The Google Play id of the app, see [App ids](#app-ids).                                                          |\n| `sort`                | `Sort`     | `sort.NEWEST` | One of `sort.NEWEST`, `sort.RATING`, `sort.HELPFULNESS`.                                                         |\n| `num`                 | `number`   | `150`         | Number of reviews to fetch.                                                                                      |\n| `paginate`            | `boolean`  | `false`       | When `true`, fetch a single page and return its token.                                                           |\n| `nextPaginationToken` | `string`   | none          | Continue from a token returned by a previous call. A token outside the base64 alphabet throws `ValidationError`. |\n| `score`               | `1` to `5` | none          | Server-side star filter. Only reviews with this score are served.                                                |\n| `device`              | `Device`   | none          | Server-side device filter: `device.MOBILE`, `device.TABLET`, `device.WATCH`, `device.CHROMEBOOK`, `device.TV`.   |\n| `pageSize`            | `number`   | see below     | Maximum reviews per RPC call, `1` to `4500`.                                                                     |\n\n```typescript\nimport { reviews, sort } from '@mradex77/google-play-scraper';\n\nconst first = await reviews({\n  appId: 'com.google.android.apps.translate',\n  sort: sort.NEWEST,\n  paginate: true,\n});\n\nif (first.nextPaginationToken) {\n  const next = await reviews({\n    appId: 'com.google.android.apps.translate',\n    sort: sort.NEWEST,\n    paginate: true,\n    nextPaginationToken: first.nextPaginationToken,\n  });\n}\n```\n\nWithout `paginate`, `reviews` keeps requesting until it holds `num` reviews and always returns `nextPaginationToken: null`. Only a `paginate: true` call hands back a token to continue from.\n\nFilters are applied by Google Play, so a filtered call downloads only the reviews it returns. Both filters can be combined and both are kept on every continuation request:\n\n```typescript\nimport { device, reviews } from '@mradex77/google-play-scraper';\n\nconst angryTabletUsers = await reviews({\n  appId: 'com.whatsapp',\n  score: 1,\n  device: device.TABLET,\n  num: 50,\n});\n```\n\nThe device filter selects the form factor the review was written on. `device.WATCH` reaches Wear OS reviews, which can be a large share of a watch face or fitness listing; Google also files some reviews from 2011 to 2013, before Wear OS existed, under that value. Apps built for a single form factor, such as an Android TV launcher, return the same set for every device value, and reviews from a form factor without a `device` value appear only in the unfiltered stream, so the device sets do not add up to the unfiltered total.\n\nWhen the library knows how many reviews you want, it asks Google for exactly that many, up to 4500 per request: `num: 10` costs one request of ten reviews and `num: 5000` costs two requests. A manual `paginate: true` page or an open-ended `reviewsIterator` requests 150 per page. `pageSize` overrides either default. Google serves an empty payload above `4500`, so larger values are rejected as a `ValidationError`.\n\n`reviews` with `num` and `reviewsAll` with `maxReviews` carry a request budget of twice the ideal request count. If Google keeps serving tokens without filling pages, the call returns what it collected and emits `request-budget-exhausted` through `onIntegrityEvent` with context `reviews`. A walk of full pages never exhausts the budget.\n\nA pagination token is a position cursor: it encodes where the previous page ended, not the filters or page size that produced it, so pass the same `score`, `device` and `pageSize` on every page of one walk. Replaying a token under a different `sort` restarts from the first page of that sort.\n\nReturns `ReviewsResult`. Trimmed:\n\n```javascript\n{\n  data: [\n    {\n      id: 'gp:AOqpTOH...',\n      userName: 'Ada Lovelace',\n      userImage: 'https://play-lh.googleusercontent.com/...',\n      date: '2026-06-30T12:00:00.000Z',\n      score: 5,\n      scoreText: '5',\n      url: 'https://play.google.com/store/apps/details?id=com.google.android.apps.translate&reviewId=gp%3AAOqpTOH...',\n      title: null,\n      text: 'Works offline and the camera translation is great.',\n      thumbsUp: 42,\n      version: '8.9.0',\n      criterias: []\n    }\n  ],\n  nextPaginationToken: 'CqYBCqMB...'\n}\n```\n\n`score` is the star rating from `1` to `5`. A few legacy reviews from the early years of Google Play carry no star rating and come back with `score: 0`, matching the original `google-play-scraper`. The `score` filter never serves them.\n\n`scoreText` is the same score as a string (`'0'` for those legacy reviews). `url` is the review's link on Google Play, built from the requested `appId` and the review `id`; the id is percent encoded (the original inserts it as is), so read it back with `new URL(review.url).searchParams.get('reviewId')` instead of comparing strings.\n\n### permissions\n\nReturns the permissions an app requests, one entry per permission group that lists it.\n\n| Option  | Type      | Default  | Description                                                                         |\n| ------- | --------- | -------- | ----------------------------------------------------------------------------------- |\n| `appId` | `string`  | required | The Google Play id of the app, see [App ids](#app-ids).                             |\n| `short` | `boolean` | `false`  | When `true`, return a flat `string[]` of common permission names, each listed once. |\n\n```typescript\nimport { permissions } from '@mradex77/google-play-scraper';\n\nconst detailed = await permissions({ appId: 'com.google.android.apps.translate' });\nconst names = await permissions({ appId: 'com.google.android.apps.translate', short: true });\n```\n\nReturns `AppPermission[]`, or `string[]` when `short` is `true` (see [Return types](#return-types)):\n\n```javascript\n[\n  { permission: 'read the contents of your USB storage', type: 0, group: 'Photos/Media/Files' },\n  { permission: 'read the contents of your USB storage', type: 0, group: 'Storage' },\n  { permission: 'take pictures and videos', type: 0, group: 'Camera' },\n  { permission: 'view network connections', type: 1, group: 'Other' },\n];\n```\n\nThe `type` is `permission.COMMON` (`0`) or `permission.OTHER` (`1`).\n\nThe `group` is the name of the permission group Google Play files the permission under, in the language of the requested `lang`, or an empty string when Google Play omits the name. A few legacy permissions belong to two groups (the USB storage permissions sit under both `Photos/Media/Files` and `Storage`), so the detailed list repeats such a permission once per group. To list each permission once, drop the group:\n\n```typescript\nconst unique = [...new Set(detailed.map((entry) => entry.permission))];\n```\n\nThe `short` list already does this for the common permissions, in the order Google Play serves them.\n\n### dataSafety\n\nReturns the data safety section of an app.\n\n| Option  | Type     | Default  | Description                                             |\n| ------- | -------- | -------- | ------------------------------------------------------- |\n| `appId` | `string` | required | The Google Play id of the app, see [App ids](#app-ids). |\n\n```typescript\nimport { dataSafety } from '@mradex77/google-play-scraper';\n\nconst safety = await dataSafety({ appId: 'com.google.android.apps.translate' });\n```\n\n`lang` localizes the labels and `country` selects the storefront. Most reports are identical across countries, but a storefront can add regional entries (the Indian storefront adds a \"UPI payments verified\" security practice to payment apps). An app that Google Play withholds from a country has no report there and resolves with the empty report described under [Failure behavior](#failure-behavior). An app that does not exist resolves the same way in every language.\n\nReturns `DataSafety`. Trimmed:\n\n```javascript\n{\n  sharedData: [\n    { data: 'Approximate location', optional: false, purpose: 'App functionality', type: 'Location' }\n  ],\n  collectedData: [\n    { data: 'Email address', optional: false, purpose: 'Account management', type: 'Personal info' }\n  ],\n  securityPractices: [\n    {\n      practice: 'Data is encrypted in transit',\n      description: 'Your data is transferred over a secure connection',\n      descriptionHTML: 'Your data is transferred over a secure connection'\n    }\n  ],\n  privacyPolicyUrl: 'https://policies.google.com/privacy'\n}\n```\n\nEvery string in the report except `descriptionHTML` is plain text. Google ends some practice descriptions with a link to the Play Families Policy or to the App Defense Alliance security standard; the library removes the tag and keeps its text, so the description reads `...against a global security standard. See details`. `descriptionHTML` keeps the description as Google serves it, link included.\n\n### categories\n\nReturns the Google Play category taxonomy as a list of category ids.\n\n| Option           | Type     | Default | Description                            |\n| ---------------- | -------- | ------- | -------------------------------------- |\n| `throttle`       | `number` | none    | See [common options](#common-options). |\n| `requestOptions` | `object` | none    | See [common options](#common-options). |\n\n```typescript\nimport { categories } from '@mradex77/google-play-scraper';\n\nconst ids = await categories();\n```\n\nReturns `string[]`:\n\n```javascript\n[\n  'APPLICATION',\n  'ANDROID_WEAR',\n  'ART_AND_DESIGN',\n  'AUTO_AND_VEHICLES',\n  'GAME',\n  'GAME_ACTION',\n  'FAMILY',\n];\n```\n\n### memoized\n\nReturns a [shared client](#shared-client) whose promise-returning methods share an in-memory LRU cache, so equivalent calls made within the TTL resolve from cache. It accepts every `createClient` option plus the two cache bounds:\n\n| Option             | Type       | Default  | Description                                                                                                                                  |\n| ------------------ | ---------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------- |\n| `lang`             | `string`   | `'en'`   | Language default applied to every call that does not set its own.                                                                            |\n| `country`          | `string`   | `'us'`   | Country default applied to every call that does not set its own.                                                                             |\n| `throttle`         | `number`   | none     | One shared limiter for every request the client makes, cache misses included.                                                                |\n| `requestOptions`   | `object`   | none     | Client-level HTTP overrides, merged under per-call ones. See [requestOptions](#throttling-and-requestoptions).                               |\n| `onDegradation`    | `function` | none     | Client-level degradation callback. See [Monitoring drift](#monitoring-drift).                                                                |\n| `onIntegrityEvent` | `function` | none     | Client-level integrity callback. See [Monitoring drift](#monitoring-drift).                                                                  |\n| `maxAgeMs`         | `number`   | `300000` | Time to live per cache entry, in milliseconds, counted from the moment the filling request completes. A positive integer up to `2147483647`. |\n| `max`              | `number`   | `1000`   | Maximum number of cached entries. A positive integer up to `1000000`.                                                                        |\n\n`max` counts entries, not bytes. A `list`, `search`, `developer` or `similar` result keeps every item summary twice (`summary` and `summaryHTML`), and Google fills that cell with the whole description, so one entry for 100 items holds roughly 0.5 MB of text. Size `max` for the result shapes you cache.\n\n```typescript\nimport { memoized } from '@mradex77/google-play-scraper';\n\nconst client = memoized({ country: 'pl', lang: 'pl', throttle: 5, maxAgeMs: 60000, max: 500 });\n\nawait client.app({ appId: 'com.google.android.apps.translate' });\nawait client.app({ appId: 'com.google.android.apps.translate' });\n```\n\nInvalid options throw `ValidationError` before any cache or HTTP state exists.\n\nEntries are keyed by the options after validation and defaulting, so `{}` and `{ lang: 'en', country: 'us' }`, `country: 'US'` and `country: 'us'`, and the same options in any property order share one entry. `lang`, `country`, every feature option, and the `headers`, `timeoutMs`, `retries`, `fetchImpl` and `signal` fields of `requestOptions` separate entries. `fetchImpl` and `signal` are compared by identity: callers that share a signal share an entry and its cancellation, callers with distinct signals use separate entries, and a fresh signal on every call never hits, so prefer `timeoutMs` for per-call deadlines. `throttle`, `concurrency` and every callback are ignored by the key, so inline callbacks are fine.\n\nThe cached methods are `app`, `availability`, `search`, `suggest`, `list`, `categories`, `developer`, `similar`, `reviews`, `permissions` and `dataSafety`. Concurrent equivalent calls share one in-flight request, a hit resolves to the same object the filling call returned (treat it as read-only), and a rejected call is never cached. `apps` and the `fullDetail` lookups of `search`, `list`, `developer` and `similar` are served from the `app` entries they warm. The iterators, `reviewsAll` and `apps` are not cached themselves; they share the client's defaults, limiter and request options.\n\nCache hits replay their events. Degradation and integrity events recorded while an entry was fetched are delivered again, in order, to the callbacks of every call that hits it; lifecycle hooks are not, because a hit performs no request. A replayed callback that throws rejects only its own call. Events recorded before a shared request fails still reach every caller that shared it. Events from the app lookups a `fullDetail` call or an `apps` batch makes belong to that outer call: they reach its callbacks, and a cached `fullDetail` result replays them with its entry.\n\nThe client exposes cache controls without global state:\n\n```typescript\nclient.cache.size;\nclient.cache.invalidate('app', { appId: 'com.google.android.apps.translate' });\nclient.cache.clear();\n```\n\n`invalidate` takes a method name and the options you would pass to it, applies the client defaults and validation (throwing `ValidationError` for options the method would reject), drops the matching entry and returns whether one existed. `size` counts live entries.\n\n## Streaming and bulk reads\n\n`reviews()`, `search()` and `developer()` collect a fixed `num` of items before they resolve. To walk results lazily and stop when you have seen enough, use the async iterators. They fetch nothing until the first `for await` and stop fetching the moment the consumer `break`s, so \"first ten reviews then stop\" costs one page request. Open-ended streams request 150 reviews per page unless you pass `pageSize`, and `score` and `device` filters are honoured on every page.\n\nThe iterators are available as standalone functions and as methods on [`createClient`](#shared-client), where they share the client's limiter and defaults.\n\n### reviewsIterator\n\nStreams reviews one at a time across pages.\n\n```typescript\nimport { reviewsIterator } from '@mradex77/google-play-scraper';\n\nfor await (const review of reviewsIterator({ appId: 'com.whatsapp' })) {\n  if (review.score < 3) {\n    break;\n  }\n  console.log(review.userName, review.score);\n}\n```\n\nPass `nextPaginationToken` to resume a stream where a previous run left off. The token comes from a prior `reviews({ paginate: true })` call or from persisted state:\n\n```typescript\nconst page = await reviews({ appId: 'com.whatsapp', paginate: true });\n\nconst resumed = reviewsIterator({\n  appId: 'com.whatsapp',\n  nextPaginationToken: page.nextPaginationToken ?? undefined,\n});\n```\n\n### reviewsAll\n\nDrains `reviewsIterator` into an array. Popular apps hold millions of reviews, so pass `maxReviews` to cap the read. Requests are sized to the remaining count, up to 4500 per request, so `maxReviews: 2000` costs one request. A capped read carries the same request budget as `reviews` and reports `request-budget-exhausted` when it runs out. Combine it with a client `throttle` to stay within Google Play's rate limits.\n\n```typescript\nimport { createClient } from '@mradex77/google-play-scraper';\n\nconst client = createClient({ throttle: 5 });\nconst recent = await client.reviewsAll({ appId: 'com.whatsapp', maxReviews: 2000 });\n```\n\nWithout `maxReviews`, `reviewsAll` walks the entire review history.\n\n### searchIterator and developerIterator\n\n```typescript\nimport { searchIterator, developerIterator } from '@mradex77/google-play-scraper';\n\nfor await (const result of searchIterator({ term: 'geography quiz' })) {\n  console.log(result.appId);\n}\n\nfor await (const item of developerIterator({ devId: 'Google LLC' })) {\n  console.log(item.title);\n}\n```\n\n### Non-goals\n\n- There is no `listIterator`. `list()` sends a single batchexecute RPC that returns up to `num` items in one response, with no server-side pagination token to iterate.\n- Iterators do not accept `fullDetail` or `num`. Streaming consumers call `client.app()` per item when they need full details and control the end by breaking. Use `reviewsAll({ maxReviews })` for the bounded case.\n\n## Constants\n\nThe library exports the same constant sets as the original, frozen and typed.\n\n| Constant     | Values                                                                                                                                     |\n| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------ |\n| `category`   | All app and game categories plus the `FAMILY` set (e.g. `APPLICATION`, `TOOLS`, `GAME`, `GAME_PUZZLE`, `FAMILY`).                          |\n| `collection` | `TOP_FREE`, `TOP_PAID`, `GROSSING`.                                                                                                        |\n| `sort`       | `NEWEST` (`2`), `RATING` (`3`), `HELPFULNESS` (`1`).                                                                                       |\n| `device`     | `MOBILE` (`'mobile'`), `TABLET` (`'tablet'`), `WATCH` (`'watch'`), `CHROMEBOOK` (`'chromebook'`), `TV` (`'tv'`), the review device filter. |\n| `age`        | `FIVE_UNDER` (`'AGE_RANGE1'`), `SIX_EIGHT` (`'AGE_RANGE2'`), `NINE_UP` (`'AGE_RANGE3'`).                                                   |\n| `permission` | `COMMON` (`0`), `OTHER` (`1`).                                                                                                             |\n\n```typescript\nimport { category, collection, sort, age, permission } from '@mradex77/google-play-scraper';\n```\n\n## Error handling\n\nEvery failure the library raises is a typed subclass of `GooglePlayError`, so you can branch on the cause instead of parsing message strings. Two rejections come from your own code instead: a [cancelled](#cancellation) call rejects with the reason you passed to `abort()`, and an `onDegradation` or `onIntegrityEvent` callback that throws surfaces its own error.\n\n| Error             | Extends           | Thrown when                                                                                 |\n| ----------------- | ----------------- | ------------------------------------------------------------------------------------------- |\n| `GooglePlayError` | `Error`           | Base class for every error the library throws.                                              |\n| `ValidationError` | `GooglePlayError` | The options you passed fail their zod schema, including a malformed `appId`.                |\n| `HttpError`       | `GooglePlayError` | A request fails with an unsuccessful status or a network error. Carries `status` and `url`. |\n| `NotFoundError`   | `HttpError`       | Google Play responds `404`, e.g. a well-formed `appId` that no listing uses.                |\n| `RateLimitError`  | `HttpError`       | Google Play responds `429` after retries are exhausted.                                     |\n| `BlockedError`    | `GooglePlayError` | A consent wall redirect, or a captcha challenge redirect that retries cannot clear.         |\n| `ParseError`      | `GooglePlayError` | A batchexecute response cannot be parsed.                                                   |\n| `SpecError`       | `ParseError`      | Extraction fails; lists every failing field and the paths that were tried.                  |\n\n```typescript\nimport { app, NotFoundError, SpecError } from '@mradex77/google-play-scraper';\n\ntry {\n  const details = await app({ appId: 'com.does.not.exist' });\n} catch (error) {\n  if (error instanceof NotFoundError) {\n    console.error('No such app');\n  } else if (error instanceof SpecError) {\n    console.error('Google Play changed its layout:', error.failures);\n  } else {\n    throw error;\n  }\n}\n```\n\n### Failure behavior\n\nA malformed `appId` never reaches Google Play: it throws `ValidationError` on every method, except that `apps` reports it as a rejected entry (see [App ids](#app-ids)). An unknown but well-formed `appId` or `devId` does not fail the same way everywhere, because Google Play itself does not: HTML details surfaces respond `404`, while report surfaces serve an empty payload. Both behaviors are pinned by the live test suite.\n\n| Behavior for a missing app        | Methods                                                                                                                                                        |\n| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| Throws `NotFoundError`            | `app`, `apps` (per entry, as a `rejected` `AppsEntry` carrying the error), `similar`, `developer`                                                              |\n| Resolves with a typed empty value | `search` and `suggest` (`[]`), `reviews` (`{ data: [], nextPaginationToken: null }`), `permissions` (`[]`), `dataSafety` (empty arrays, no `privacyPolicyUrl`) |\n| Maps the throw to a status        | `availability` reports `unavailable`                                                                                                                           |\n\n`dataSafety` recognizes a missing app from the structure of the error page Google Play serves, so the empty report is the same whichever `lang` you ask for. The same empty report comes back when the app is withheld from the requested `country`.\n\nTyped empties are limited to the documented response shapes above and other schema-backed empty variants. A structurally missing or malformed response root throws `ParseError`; a missing required field inside a valid root throws `SpecError`. Neither case is converted into an empty result, `0`, `false`, `Free` or `VARY` unless that exact fallback is part of the documented field contract.\n\n## Throttling and requestOptions\n\nPass `throttle` to cap requests per second, and `requestOptions` to override the HTTP layer:\n\n| requestOptions field | Type                             | Description                                                                                                                                                               |\n| -------------------- | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `headers`            | `Record<string, string>`         | Extra headers merged into every request.                                                                                                                                  |\n| `fetchImpl`          | `typeof fetch`                   | A custom `fetch` implementation, useful for proxies and tests. Combine with [`createCountryFetch`](#routing-by-country) to route each storefront country separately.      |\n| `timeoutMs`          | `number`                         | Timeout per request, up to `120000`. Default `30000`.                                                                                                                     |\n| `retries`            | `number`                         | Retry count for `429`, `5xx` and captcha challenge redirects, `0` to `5`. Default `2`.                                                                                    |\n| `signal`             | `AbortSignal`                    | Cancels the call at once, including an in-flight request, a body read, retry backoff, a `Retry-After` wait and a queued throttle slot. See [Cancellation](#cancellation). |\n| `onRequest`          | `(event: RequestEvent) => void`  | Called before every attempt, including retries. See [Request lifecycle hooks](#request-lifecycle-hooks).                                                                  |\n| `onResponse`         | `(event: ResponseEvent) => void` | Called for each settled response, after the body is read on success, with `status` and `durationMs`.                                                                      |\n| `onRetry`            | `(event: RetryEvent) => void`    | Called when a retry is scheduled, with `delayMs` and `reason`.                                                                                                            |\n\n```typescript\nimport { app } from '@mradex77/google-play-scraper';\n\nconst details = await app({\n  appId: 'com.google.android.apps.translate',\n  throttle: 5,\n  requestOptions: {\n    timeoutMs: 15000,\n    retries: 3,\n    headers: { 'Accept-Language': 'de' },\n    fetchImpl: myProxiedFetch,\n  },\n});\n```\n\nRetries use exponential backoff with jitter. A well-formed `Retry-After` header (seconds or an HTTP date, as RFC 9110 allows) overrides the backoff up to a fixed ceiling of 60 seconds. A longer wait is not honoured: the call ends at once with `RateLimitError` for a `429` or `BlockedError` for a captcha challenge redirect, independent of `timeoutMs`, which bounds a single attempt. A malformed, past or negative value is ignored.\n\n### Request lifecycle hooks\n\nThe three `on*` callbacks expose request telemetry at every level (direct calls, `createClient` and `memoized`), including what a wrapping `fetchImpl` cannot see: retries and backoff decisions.\n\n```typescript\nimport { app } from '@mradex77/google-play-scraper';\n\nconst details = await app({\n  appId: 'com.google.android.apps.translate',\n  requestOptions: {\n    onRequest: (event) => log.debug('gplay request', event),\n    onResponse: (event) => metrics.timing('gplay.latency', event.durationMs),\n    onRetry: (event) => metrics.increment('gplay.retry', { reason: event.reason }),\n  },\n});\n```\n\nEvery event carries `url`, `method` and a 1-based `attempt`: the first try is attempt 1, a `RetryEvent` carries the number of the attempt that failed, and the next `RequestEvent` is that attempt plus one. `ResponseEvent` adds `status` and `durationMs`, measured from immediately before the fetch (throttle wait excluded) and, on success, through the transfer of the full body. `RetryEvent` adds the scheduled `delayMs`, a `reason` of `'status'` or `'network'`, and the HTTP `status` when the reason is a retryable status. A retry-free happy path emits one `RequestEvent` and one `ResponseEvent`.\n\nHooks are telemetry only. A hook that throws or returns a rejecting promise is swallowed and the request proceeds unchanged, unlike [`onDegradation` and `onIntegrityEvent`](#monitoring-drift), which rethrow because they are data-integrity signals. When a client-level and a call-level `requestOptions` set the same hook, the call-level one replaces it for that call; hooks do not chain.\n\n### Routing requests through a proxy\n\nThe native `fetch` of Node.js ignores the `HTTP_PROXY` and `HTTPS_PROXY` environment variables by default. On Node.js 24 and newer, opt in when launching your process:\n\n```sh\nNODE_USE_ENV_PROXY=1 node app.js\n```\n\nFor per-call control, or on Node.js 22, inject a proxied `fetch` from [undici](https://github.com/nodejs/undici) through `fetchImpl`:\n\n```typescript\nimport { ProxyAgent, fetch as proxiedFetch, type RequestInit } from 'undici';\nimport { app } from '@mradex77/google-play-scraper';\n\nconst dispatcher = new ProxyAgent('http://user:password@proxy.example.com:8080');\n\nconst fetchImpl = ((input: string | URL, init?: RequestInit) =>\n  proxiedFetch(input, { ...init, dispatcher })) as unknown as typeof fetch;\n\nconst details = await app({\n  appId: 'com.google.android.apps.translate',\n  requestOptions: { fetchImpl },\n});\n```\n\n`ProxyAgent` also accepts an options object when the proxy needs more configuration, such as a `token` carrying a preformatted `Proxy-Authorization` header or TLS settings for the proxy connection.\n\n### Rotating proxies when blocked\n\nGoogle answers a burst of requests from one IP address with a redirect to its captcha challenge at `www.google.com/sorry`. The client retries that redirect like a `429`, and most challenges clear on the next attempt. When they keep coming until retries run out, or the challenge asks to wait longer than the `Retry-After` ceiling, the call rejects with a `BlockedError` whose message names the cause (`captcha challenge` or `consent wall`). That is the signal to slow down or switch to another exit IP:\n\n```typescript\nimport { ProxyAgent, fetch as undiciFetch, type RequestInit } from 'undici';\nimport { BlockedError, createClient } from '@mradex77/google-play-scraper';\n\nconst throughProxy = (proxyUrl: string): typeof fetch => {\n  const dispatcher = new ProxyAgent(proxyUrl);\n  return ((input: string | URL, init?: RequestInit) =>\n    undiciFetch(input, { ...init, dispatcher })) as unknown as typeof fetch;\n};\n\nconst routes = [\n  'http://user:password@proxy-1.example.com:8080',\n  'http://user:password@proxy-2.example.com:8080',\n].map((proxyUrl) =>\n  createClient({ throttle: 2, requestOptions: { fetchImpl: throughProxy(proxyUrl) } }),\n);\n\nasync function searchWithRotation(term: string) {\n  for (const client of routes) {\n    try {\n      return await client.search({ term });\n    } catch (error) {\n      if (!(error instanceof BlockedError)) {\n        throw error;\n      }\n    }\n  }\n  throw new Error('Every proxy is blocked');\n}\n```\n\nThe challenge is driven by request rate per IP, so each route gets its own `createClient` whose limiter spans every call through that proxy, concurrent ones included, which prevents most blocks before rotation is needed. Detection reads only the final response URL, never page text, so a search term or review that quotes a captcha message is returned as data.\n\n### Routing by country\n\n`createCountryFetch` builds a `fetch` implementation that picks a route per storefront country. It reads the `gl` query parameter that Google Play requests carry, matches it against `perCountry` (ISO 3166-1 alpha-2, case insensitive), and falls back to `fallback` or the global `fetch` when no route matches:\n\n```typescript\nimport { ProxyAgent, fetch as undiciFetch, type RequestInit } from 'undici';\nimport { app, createCountryFetch } from '@mradex77/google-play-scraper';\n\nconst throughProxy = (proxyUrl: string): typeof fetch => {\n  const dispatcher = new ProxyAgent(proxyUrl);\n  return ((input: string | URL, init?: RequestInit) =>\n    undiciFetch(input, { ...init, dispatcher })) as unknown as typeof fetch;\n};\n\nconst fetchImpl = createCountryFetch({\n  perCountry: {\n    us: throughProxy('http://us-proxy.internal:8080'),\n    de: throughProxy('http://user:password@de-proxy.internal:8080'),\n  },\n  fallback: throughProxy('http://default-proxy.internal:8080'),\n});\n\nconst details = await app({\n  appId: 'com.google.android.apps.translate',\n  country: 'de',\n  requestOptions: { fetchImpl },\n});\n```\n\nRoutes accept any `typeof fetch`, so the same helper also works for per-country rate limiting, logging or fixtures in tests. Omit `fallback` to send unmatched countries through a direct connection.\n\n### Cancellation\n\nPass an `AbortSignal` to cancel long running calls, such as a `reviews` fetch that walks many pages. An aborted call rejects with the signal's reason and is never retried:\n\n```typescript\nimport { reviews } from '@mradex77/google-play-scraper';\n\nconst controller = new AbortController();\nsetTimeout(() => controller.abort(), 10000);\n\nconst result = await reviews({\n  appId: 'com.google.android.apps.translate',\n  num: 5000,\n  requestOptions: { signal: controller.signal },\n});\n```\n\nWith a `fetchImpl` that honors `init.signal`, as the native `fetch` does, cancellation is immediate at every point in the request lifecycle:\n\n| Where the abort lands                        | What happens                                                                              |","readmeFilename":"README.md"}