gplay-scraper


Namegplay-scraper JSON
Version 1.0.5 PyPI version JSON
download
home_pagehttps://github.com/mohammedcha/gplay-scraper
SummaryπŸš€ Advanced Google Play Store Scraper - Extract 65+ app fields, reviews, ratings, ASO data, developer info, top charts, search results with 7 HTTP clients & unlimited pagination support
upload_time2025-10-18 17:32:21
maintainerMohammed Cha
docs_urlNone
authorMohammed Cha
requires_python>=3.8
licenseNone
keywords google-play-scraper playstore-scraper android-scraper gplay-scraper google-play-store play-store-api app-data-extraction app-analytics mobile-analytics aso-tools app-store-optimization mobile-seo app-marketing keyword-research competitor-analysis market-research app-reviews user-reviews review-scraper rating-analysis sentiment-analysis developer-tools api-scraping web-scraping data-mining python-scraper automation-tools business-intelligence market-intelligence competitive-intelligence app-monitoring trend-analysis performance-tracking install-tracking revenue-analysis
VCS
bugtrack_url
requirements requests beautifulsoup4 curl-cffi tls-client urllib3 cloudscraper aiohttp httpx pytest sphinx sphinx-rtd-theme
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Google Play Scraper - Python Library πŸ“±

[![PyPI version](https://badge.fury.io/py/gplay-scraper.svg)](https://badge.fury.io/py/gplay-scraper)
[![Python](https://img.shields.io/badge/python-3.7+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Downloads](https://pepy.tech/badge/gplay-scraper)](https://pepy.tech/project/gplay-scraper)
[![GitHub stars](https://img.shields.io/github/stars/Mohammedcha/gplay-scraper.svg)](https://github.com/Mohammedcha/gplay-scraper/stargazers)
[![GitHub issues](https://img.shields.io/github/issues/Mohammedcha/gplay-scraper.svg)](https://github.com/Mohammedcha/gplay-scraper/issues)

**GPlay Scraper** is a powerful Python library for extracting comprehensive data from the Google Play Store. Built for developers, data analysts, and researchers, it provides easy access to app information, user reviews, search results, top charts, and market intelligenceβ€”all without requiring API keys.

## 🎯 What Can You Scrape?

**App Data (65+ Fields)**
- Basic info: title, developer, description, category, genre
- Ratings & reviews: score, ratings count, histogram, user reviews
- Install metrics: install count ranges, download statistics
- Pricing: free/paid status, price, in-app purchases, currency
- Media: icon, screenshots, video, header image URLs
- Technical: version, size, Android version, release date, last update
- Content: age rating, privacy policy, developer contact info
- Features: permissions, what's new, developer website

**Search & Discovery**
- Search apps by keyword with filtering and pagination
- Get search suggestions and autocomplete terms
- Find similar/competitor apps for any app
- Access top charts (free, paid, grossing) across 54 categories

**Developer Intelligence**
- Get complete app portfolio for any developer
- Track developer's app performance and ratings
- Analyze developer's market presence

**User Reviews**
- Extract reviews with ratings, text, and timestamps
- Get reviewer names and helpful vote counts
- Filter by newest, most relevant, or highest rated
- Track app versions mentioned in reviews

**Market Research**
- Multi-language support (100+ languages)
- Multi-region data (150+ countries)
- Localized pricing and availability
- Competitive analysis and benchmarking

## πŸ†• **What's New in v1.0.5** 

**βœ… Publisher Country Detection:**
- **Automatic Country Detection** - Detects developer's country from phone number and address
- **International Phone Prefixes** - Uses phone number prefixes to identify countries
- **Address Parsing** - Analyzes developer addresses for country information
- **Multi-Country Support** - Handles cases where phone and address differ (e.g., "United States/Germany")
- **Enhanced Developer Intelligence** - Adds `publisherCountry` field to app data

**βœ… Enhanced Error Handling:**
- **Better HTTP Client Fallback** - Improved reliability when requests fail
- **Robust JSON Parsing** - Multiple fallback strategies for malformed responses
- **Network Timeout Handling** - Better handling of connection errors
- **Automatic Retry Logic** - Exponential backoff for rate limiting
- **Error Recovery** - Better recovery from temporary network issues

**βœ… Removed Features:**
- **Removed updatedTimestamp** - Removed deprecated timestamp field that was causing confusion

**βœ… 7 Method Types:**
- **App Methods** - Extract 65+ data fields from any app (ratings, installs, pricing, permissions, etc.)
- **Search Methods** - Search Google Play Store apps with comprehensive filtering
- **Reviews Methods** - Extract user reviews with ratings, timestamps, and detailed feedback
- **Developer Methods** - Get all apps published by a specific developer
- **List Methods** - Access top charts (top free, top paid, top grossing) by category
- **Similar Methods** - Find similar/competitor apps for market research
- **Suggest Methods** - Get search suggestions and autocomplete for ASO

## ⚑ Key Features

**Powerful & Flexible**
- **7 HTTP clients with automatic fallback** - requests, curl_cffi, tls_client, httpx, urllib3, cloudscraper, aiohttp
- **42 functions across 7 method types** - analyze(), get_field(), get_fields(), print_field(), print_fields(), print_all()
- **No API keys required** - Direct scraping from Google Play Store
- **Multi-language & multi-region** - 100+ languages, 150+ countries

**Reliable & Safe**
- **Built-in rate limiting** - Prevents blocking with automatic delays
- **Automatic HTTP client fallback** - Ensures maximum reliability
- **Error handling** - Graceful failures with informative messages
- **Retry logic** - Automatic retries for failed requests

**Developer Friendly**
- **Simple API** - Intuitive method names and parameters
- **Comprehensive documentation** - Examples for every use case
- **Type hints** - Full IDE autocomplete support
- **Flexible output** - Get data as dict/list or print as JSON

## πŸ“‹ Requirements

- Python 3.7+
- requests (default HTTP client)
- Optional: curl-cffi, tls-client, httpx, urllib3, cloudscraper, aiohttp (for advanced HTTP clients)

## πŸš€ Installation

```bash
# Install from PyPI
pip install gplay-scraper

# Or install in development mode
pip install -e .
```

## πŸ“– Quick Start

```python
from gplay_scraper import GPlayScraper

# Initialize with HTTP client (curl_cffi recommended for best performance)
scraper = GPlayScraper(http_client="curl_cffi")

# Get app details with different image sizes
app_id = "com.whatsapp"
scraper.app_print_all(app_id, lang="en", country="us", assets="LARGE")

# Get high-quality app data
data = scraper.app_analyze(app_id, assets="ORIGINAL")  # Maximum image quality
icon_small = scraper.app_get_field(app_id, "icon", assets="SMALL")  # 512px icon

# Print specific fields with custom image sizes
scraper.app_print_field(app_id, "icon", assets="LARGE")  # Print large icon URL
scraper.app_print_fields(app_id, ["icon", "screenshots"], assets="ORIGINAL")  # Print multiple fields

# Search for apps
scraper.search_print_all("social media", count=10, lang="en", country="us")

# Get reviews
scraper.reviews_print_all(app_id, count=50, sort="NEWEST", lang="en", country="us")

# Get developer apps
scraper.developer_print_all("5700313618786177705", count=20, lang="en", country="us")

# Get top charts
scraper.list_print_all("TOP_FREE", "GAME", count=20, lang="en", country="us")

# Get similar apps
scraper.similar_print_all(app_id, count=30, lang="en", country="us")

# Get search suggestions
scraper.suggest_print_all("fitness", count=5, lang="en", country="us")
```

## 🎯 7 Method Types

GPlay Scraper provides 7 method types with 42 functions to interact with Google Play Store data:

### 1. [App Methods](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/APP_METHODS.md) - Extract app details (65+ fields)
### 2. [Search Methods](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/SEARCH_METHODS.md) - Search for apps by keyword
### 3. [Reviews Methods](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/REVIEWS_METHODS.md) - Get user reviews and ratings
### 4. [Developer Methods](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/DEVELOPER_METHODS.md) - Get all apps from a developer
### 5. [List Methods](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/LIST_METHODS.md) - Get top charts (free, paid, grossing)
### 6. [Similar Methods](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/SIMILAR_METHODS.md) - Find similar/related apps
### 7. [Suggest Methods](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/SUGGEST_METHODS.md) - Get search suggestions/autocomplete

Each method type has 6 functions:
- `analyze()` - Get all data as dictionary/list
- `get_field()` - Get single field value
- `get_fields()` - Get multiple fields
- `print_field()` - Print single field to console
- `print_fields()` - Print multiple fields to console
- `print_all()` - Print all data as JSON

## 🎯 Method Examples

### 1. [App Methods](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/APP_METHODS.md) - Get App Details
Extract comprehensive information about any app including ratings, installs, pricing, and 65+ data fields.

πŸ“– **[View detailed documentation β†’](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/APP_METHODS.md)**

```python
from gplay_scraper import GPlayScraper

scraper = GPlayScraper(http_client="curl_cffi")

# Print all app data as JSON
scraper.app_print_all("com.whatsapp", lang="en", country="us")
```

**What you get:** Complete app profile with title, developer, ratings, install counts, pricing, screenshots, permissions, and more.

πŸ“„ **[View JSON example β†’](https://github.com/Mohammedcha/gplay-scraper/blob/main/output/app_example.json)**

---

### 2. [Search Methods](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/SEARCH_METHODS.md) - Find Apps by Keyword
Search the Play Store by keyword, app name, or category to discover apps.

πŸ“– **[View detailed documentation β†’](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/SEARCH_METHODS.md)**

```python
from gplay_scraper import GPlayScraper

scraper = GPlayScraper(http_client="curl_cffi")

# Print all search results as JSON
scraper.search_print_all("fitness tracker", count=20, lang="en", country="us")
```

**What you get:** List of apps matching your search with titles, developers, ratings, prices, and Play Store URLs.

πŸ“„ **[View JSON example β†’](https://github.com/Mohammedcha/gplay-scraper/blob/main/output/search_example.json)**

---

### 3. [Reviews Methods](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/REVIEWS_METHODS.md) - Extract User Reviews
Get user reviews with ratings, comments, timestamps, and helpful votes for sentiment analysis.

πŸ“– **[View detailed documentation β†’](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/REVIEWS_METHODS.md)**

```python
from gplay_scraper import GPlayScraper

scraper = GPlayScraper(http_client="curl_cffi")

# Print all reviews as JSON
scraper.reviews_print_all("com.whatsapp", count=100, sort="NEWEST", lang="en", country="us")
```

**What you get:** User reviews with names, ratings (1-5 stars), review text, timestamps, app versions, and helpful vote counts.

πŸ“„ **[View JSON example β†’](https://github.com/Mohammedcha/gplay-scraper/blob/main/output/reviews_example.json)**

---

### 4. [Developer Methods](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/DEVELOPER_METHODS.md) - Get Developer's Apps
Retrieve all apps published by a specific developer using their developer ID.

πŸ“– **[View detailed documentation β†’](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/DEVELOPER_METHODS.md)**

```python
from gplay_scraper import GPlayScraper

scraper = GPlayScraper(http_client="curl_cffi")

# Print all developer apps as JSON
scraper.developer_print_all("5700313618786177705", count=50, lang="en", country="us")
```

**What you get:** Complete portfolio of apps from a developer with titles, ratings, prices, and descriptions.

πŸ“„ **[View JSON example β†’](https://github.com/Mohammedcha/gplay-scraper/blob/main/output/developer_example.json)**

---

### 5. [List Methods](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/LIST_METHODS.md) - Get Top Charts
Access Play Store top charts including top free, top paid, and top grossing apps by category.

πŸ“– **[View detailed documentation β†’](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/LIST_METHODS.md)**

```python
from gplay_scraper import GPlayScraper

scraper = GPlayScraper(http_client="curl_cffi")

# Print top free games as JSON
scraper.list_print_all("TOP_FREE", "GAME", count=50, lang="en", country="us")
```

**What you get:** Top-ranked apps with titles, developers, ratings, install counts, prices, and screenshots.

πŸ“„ **[View JSON example β†’](https://github.com/Mohammedcha/gplay-scraper/blob/main/output/list_example.json)**

---

### 6. [Similar Methods](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/SIMILAR_METHODS.md) - Find Related Apps
Discover apps similar to a reference app for competitive analysis and market research.

πŸ“– **[View detailed documentation β†’](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/SIMILAR_METHODS.md)**

```python
from gplay_scraper import GPlayScraper

scraper = GPlayScraper(http_client="curl_cffi")

# Print similar apps as JSON
scraper.similar_print_all("com.whatsapp", count=30, lang="en", country="us")
```

**What you get:** List of similar/competitor apps with titles, developers, ratings, and pricing information.

πŸ“„ **[View JSON example β†’](https://github.com/Mohammedcha/gplay-scraper/blob/main/output/similar_example.json)**

---

### 7. [Suggest Methods](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/SUGGEST_METHODS.md) - Get Search Suggestions
Get autocomplete suggestions and keyword ideas for ASO and market research.

πŸ“– **[View detailed documentation β†’](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/SUGGEST_METHODS.md)**

```python
from gplay_scraper import GPlayScraper

scraper = GPlayScraper(http_client="curl_cffi")

# Print search suggestions as JSON
scraper.suggest_print_all("photo editor", count=10, lang="en", country="us")
```

**What you get:** List of popular search terms related to your keyword for ASO and keyword research.

πŸ“„ **[View JSON example β†’](https://github.com/Mohammedcha/gplay-scraper/blob/main/output/suggest_example.json)**

---

## 🀝 Contributing

1. Fork the repository
2. Create your feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

## πŸ“„ License

This project is licensed under the MIT License.

---

**Happy Analyzing! πŸš€**

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/mohammedcha/gplay-scraper",
    "name": "gplay-scraper",
    "maintainer": "Mohammed Cha",
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": "contact@mohammedcha.com",
    "keywords": "google-play-scraper, playstore-scraper, android-scraper, gplay-scraper, google-play-store, play-store-api, app-data-extraction, app-analytics, mobile-analytics, aso-tools, app-store-optimization, mobile-seo, app-marketing, keyword-research, competitor-analysis, market-research, app-reviews, user-reviews, review-scraper, rating-analysis, sentiment-analysis, developer-tools, api-scraping, web-scraping, data-mining, python-scraper, automation-tools, business-intelligence, market-intelligence, competitive-intelligence, app-monitoring, trend-analysis, performance-tracking, install-tracking, revenue-analysis",
    "author": "Mohammed Cha",
    "author_email": "contact@mohammedcha.com",
    "download_url": "https://files.pythonhosted.org/packages/f4/0e/8681d959cbe129771e8dc336941d019cc0aa6b6528cc75f6057829cb88be/gplay_scraper-1.0.5.tar.gz",
    "platform": "any",
    "description": "# Google Play Scraper - Python Library \ud83d\udcf1\r\n\r\n[![PyPI version](https://badge.fury.io/py/gplay-scraper.svg)](https://badge.fury.io/py/gplay-scraper)\r\n[![Python](https://img.shields.io/badge/python-3.7+-blue.svg)](https://www.python.org/downloads/)\r\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\r\n[![Downloads](https://pepy.tech/badge/gplay-scraper)](https://pepy.tech/project/gplay-scraper)\r\n[![GitHub stars](https://img.shields.io/github/stars/Mohammedcha/gplay-scraper.svg)](https://github.com/Mohammedcha/gplay-scraper/stargazers)\r\n[![GitHub issues](https://img.shields.io/github/issues/Mohammedcha/gplay-scraper.svg)](https://github.com/Mohammedcha/gplay-scraper/issues)\r\n\r\n**GPlay Scraper** is a powerful Python library for extracting comprehensive data from the Google Play Store. Built for developers, data analysts, and researchers, it provides easy access to app information, user reviews, search results, top charts, and market intelligence\u2014all without requiring API keys.\r\n\r\n## \ud83c\udfaf What Can You Scrape?\r\n\r\n**App Data (65+ Fields)**\r\n- Basic info: title, developer, description, category, genre\r\n- Ratings & reviews: score, ratings count, histogram, user reviews\r\n- Install metrics: install count ranges, download statistics\r\n- Pricing: free/paid status, price, in-app purchases, currency\r\n- Media: icon, screenshots, video, header image URLs\r\n- Technical: version, size, Android version, release date, last update\r\n- Content: age rating, privacy policy, developer contact info\r\n- Features: permissions, what's new, developer website\r\n\r\n**Search & Discovery**\r\n- Search apps by keyword with filtering and pagination\r\n- Get search suggestions and autocomplete terms\r\n- Find similar/competitor apps for any app\r\n- Access top charts (free, paid, grossing) across 54 categories\r\n\r\n**Developer Intelligence**\r\n- Get complete app portfolio for any developer\r\n- Track developer's app performance and ratings\r\n- Analyze developer's market presence\r\n\r\n**User Reviews**\r\n- Extract reviews with ratings, text, and timestamps\r\n- Get reviewer names and helpful vote counts\r\n- Filter by newest, most relevant, or highest rated\r\n- Track app versions mentioned in reviews\r\n\r\n**Market Research**\r\n- Multi-language support (100+ languages)\r\n- Multi-region data (150+ countries)\r\n- Localized pricing and availability\r\n- Competitive analysis and benchmarking\r\n\r\n## \ud83c\udd95 **What's New in v1.0.5** \r\n\r\n**\u2705 Publisher Country Detection:**\r\n- **Automatic Country Detection** - Detects developer's country from phone number and address\r\n- **International Phone Prefixes** - Uses phone number prefixes to identify countries\r\n- **Address Parsing** - Analyzes developer addresses for country information\r\n- **Multi-Country Support** - Handles cases where phone and address differ (e.g., \"United States/Germany\")\r\n- **Enhanced Developer Intelligence** - Adds `publisherCountry` field to app data\r\n\r\n**\u2705 Enhanced Error Handling:**\r\n- **Better HTTP Client Fallback** - Improved reliability when requests fail\r\n- **Robust JSON Parsing** - Multiple fallback strategies for malformed responses\r\n- **Network Timeout Handling** - Better handling of connection errors\r\n- **Automatic Retry Logic** - Exponential backoff for rate limiting\r\n- **Error Recovery** - Better recovery from temporary network issues\r\n\r\n**\u2705 Removed Features:**\r\n- **Removed updatedTimestamp** - Removed deprecated timestamp field that was causing confusion\r\n\r\n**\u2705 7 Method Types:**\r\n- **App Methods** - Extract 65+ data fields from any app (ratings, installs, pricing, permissions, etc.)\r\n- **Search Methods** - Search Google Play Store apps with comprehensive filtering\r\n- **Reviews Methods** - Extract user reviews with ratings, timestamps, and detailed feedback\r\n- **Developer Methods** - Get all apps published by a specific developer\r\n- **List Methods** - Access top charts (top free, top paid, top grossing) by category\r\n- **Similar Methods** - Find similar/competitor apps for market research\r\n- **Suggest Methods** - Get search suggestions and autocomplete for ASO\r\n\r\n## \u26a1 Key Features\r\n\r\n**Powerful & Flexible**\r\n- **7 HTTP clients with automatic fallback** - requests, curl_cffi, tls_client, httpx, urllib3, cloudscraper, aiohttp\r\n- **42 functions across 7 method types** - analyze(), get_field(), get_fields(), print_field(), print_fields(), print_all()\r\n- **No API keys required** - Direct scraping from Google Play Store\r\n- **Multi-language & multi-region** - 100+ languages, 150+ countries\r\n\r\n**Reliable & Safe**\r\n- **Built-in rate limiting** - Prevents blocking with automatic delays\r\n- **Automatic HTTP client fallback** - Ensures maximum reliability\r\n- **Error handling** - Graceful failures with informative messages\r\n- **Retry logic** - Automatic retries for failed requests\r\n\r\n**Developer Friendly**\r\n- **Simple API** - Intuitive method names and parameters\r\n- **Comprehensive documentation** - Examples for every use case\r\n- **Type hints** - Full IDE autocomplete support\r\n- **Flexible output** - Get data as dict/list or print as JSON\r\n\r\n## \ud83d\udccb Requirements\r\n\r\n- Python 3.7+\r\n- requests (default HTTP client)\r\n- Optional: curl-cffi, tls-client, httpx, urllib3, cloudscraper, aiohttp (for advanced HTTP clients)\r\n\r\n## \ud83d\ude80 Installation\r\n\r\n```bash\r\n# Install from PyPI\r\npip install gplay-scraper\r\n\r\n# Or install in development mode\r\npip install -e .\r\n```\r\n\r\n## \ud83d\udcd6 Quick Start\r\n\r\n```python\r\nfrom gplay_scraper import GPlayScraper\r\n\r\n# Initialize with HTTP client (curl_cffi recommended for best performance)\r\nscraper = GPlayScraper(http_client=\"curl_cffi\")\r\n\r\n# Get app details with different image sizes\r\napp_id = \"com.whatsapp\"\r\nscraper.app_print_all(app_id, lang=\"en\", country=\"us\", assets=\"LARGE\")\r\n\r\n# Get high-quality app data\r\ndata = scraper.app_analyze(app_id, assets=\"ORIGINAL\")  # Maximum image quality\r\nicon_small = scraper.app_get_field(app_id, \"icon\", assets=\"SMALL\")  # 512px icon\r\n\r\n# Print specific fields with custom image sizes\r\nscraper.app_print_field(app_id, \"icon\", assets=\"LARGE\")  # Print large icon URL\r\nscraper.app_print_fields(app_id, [\"icon\", \"screenshots\"], assets=\"ORIGINAL\")  # Print multiple fields\r\n\r\n# Search for apps\r\nscraper.search_print_all(\"social media\", count=10, lang=\"en\", country=\"us\")\r\n\r\n# Get reviews\r\nscraper.reviews_print_all(app_id, count=50, sort=\"NEWEST\", lang=\"en\", country=\"us\")\r\n\r\n# Get developer apps\r\nscraper.developer_print_all(\"5700313618786177705\", count=20, lang=\"en\", country=\"us\")\r\n\r\n# Get top charts\r\nscraper.list_print_all(\"TOP_FREE\", \"GAME\", count=20, lang=\"en\", country=\"us\")\r\n\r\n# Get similar apps\r\nscraper.similar_print_all(app_id, count=30, lang=\"en\", country=\"us\")\r\n\r\n# Get search suggestions\r\nscraper.suggest_print_all(\"fitness\", count=5, lang=\"en\", country=\"us\")\r\n```\r\n\r\n## \ud83c\udfaf 7 Method Types\r\n\r\nGPlay Scraper provides 7 method types with 42 functions to interact with Google Play Store data:\r\n\r\n### 1. [App Methods](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/APP_METHODS.md) - Extract app details (65+ fields)\r\n### 2. [Search Methods](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/SEARCH_METHODS.md) - Search for apps by keyword\r\n### 3. [Reviews Methods](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/REVIEWS_METHODS.md) - Get user reviews and ratings\r\n### 4. [Developer Methods](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/DEVELOPER_METHODS.md) - Get all apps from a developer\r\n### 5. [List Methods](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/LIST_METHODS.md) - Get top charts (free, paid, grossing)\r\n### 6. [Similar Methods](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/SIMILAR_METHODS.md) - Find similar/related apps\r\n### 7. [Suggest Methods](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/SUGGEST_METHODS.md) - Get search suggestions/autocomplete\r\n\r\nEach method type has 6 functions:\r\n- `analyze()` - Get all data as dictionary/list\r\n- `get_field()` - Get single field value\r\n- `get_fields()` - Get multiple fields\r\n- `print_field()` - Print single field to console\r\n- `print_fields()` - Print multiple fields to console\r\n- `print_all()` - Print all data as JSON\r\n\r\n## \ud83c\udfaf Method Examples\r\n\r\n### 1. [App Methods](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/APP_METHODS.md) - Get App Details\r\nExtract comprehensive information about any app including ratings, installs, pricing, and 65+ data fields.\r\n\r\n\ud83d\udcd6 **[View detailed documentation \u2192](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/APP_METHODS.md)**\r\n\r\n```python\r\nfrom gplay_scraper import GPlayScraper\r\n\r\nscraper = GPlayScraper(http_client=\"curl_cffi\")\r\n\r\n# Print all app data as JSON\r\nscraper.app_print_all(\"com.whatsapp\", lang=\"en\", country=\"us\")\r\n```\r\n\r\n**What you get:** Complete app profile with title, developer, ratings, install counts, pricing, screenshots, permissions, and more.\r\n\r\n\ud83d\udcc4 **[View JSON example \u2192](https://github.com/Mohammedcha/gplay-scraper/blob/main/output/app_example.json)**\r\n\r\n---\r\n\r\n### 2. [Search Methods](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/SEARCH_METHODS.md) - Find Apps by Keyword\r\nSearch the Play Store by keyword, app name, or category to discover apps.\r\n\r\n\ud83d\udcd6 **[View detailed documentation \u2192](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/SEARCH_METHODS.md)**\r\n\r\n```python\r\nfrom gplay_scraper import GPlayScraper\r\n\r\nscraper = GPlayScraper(http_client=\"curl_cffi\")\r\n\r\n# Print all search results as JSON\r\nscraper.search_print_all(\"fitness tracker\", count=20, lang=\"en\", country=\"us\")\r\n```\r\n\r\n**What you get:** List of apps matching your search with titles, developers, ratings, prices, and Play Store URLs.\r\n\r\n\ud83d\udcc4 **[View JSON example \u2192](https://github.com/Mohammedcha/gplay-scraper/blob/main/output/search_example.json)**\r\n\r\n---\r\n\r\n### 3. [Reviews Methods](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/REVIEWS_METHODS.md) - Extract User Reviews\r\nGet user reviews with ratings, comments, timestamps, and helpful votes for sentiment analysis.\r\n\r\n\ud83d\udcd6 **[View detailed documentation \u2192](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/REVIEWS_METHODS.md)**\r\n\r\n```python\r\nfrom gplay_scraper import GPlayScraper\r\n\r\nscraper = GPlayScraper(http_client=\"curl_cffi\")\r\n\r\n# Print all reviews as JSON\r\nscraper.reviews_print_all(\"com.whatsapp\", count=100, sort=\"NEWEST\", lang=\"en\", country=\"us\")\r\n```\r\n\r\n**What you get:** User reviews with names, ratings (1-5 stars), review text, timestamps, app versions, and helpful vote counts.\r\n\r\n\ud83d\udcc4 **[View JSON example \u2192](https://github.com/Mohammedcha/gplay-scraper/blob/main/output/reviews_example.json)**\r\n\r\n---\r\n\r\n### 4. [Developer Methods](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/DEVELOPER_METHODS.md) - Get Developer's Apps\r\nRetrieve all apps published by a specific developer using their developer ID.\r\n\r\n\ud83d\udcd6 **[View detailed documentation \u2192](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/DEVELOPER_METHODS.md)**\r\n\r\n```python\r\nfrom gplay_scraper import GPlayScraper\r\n\r\nscraper = GPlayScraper(http_client=\"curl_cffi\")\r\n\r\n# Print all developer apps as JSON\r\nscraper.developer_print_all(\"5700313618786177705\", count=50, lang=\"en\", country=\"us\")\r\n```\r\n\r\n**What you get:** Complete portfolio of apps from a developer with titles, ratings, prices, and descriptions.\r\n\r\n\ud83d\udcc4 **[View JSON example \u2192](https://github.com/Mohammedcha/gplay-scraper/blob/main/output/developer_example.json)**\r\n\r\n---\r\n\r\n### 5. [List Methods](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/LIST_METHODS.md) - Get Top Charts\r\nAccess Play Store top charts including top free, top paid, and top grossing apps by category.\r\n\r\n\ud83d\udcd6 **[View detailed documentation \u2192](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/LIST_METHODS.md)**\r\n\r\n```python\r\nfrom gplay_scraper import GPlayScraper\r\n\r\nscraper = GPlayScraper(http_client=\"curl_cffi\")\r\n\r\n# Print top free games as JSON\r\nscraper.list_print_all(\"TOP_FREE\", \"GAME\", count=50, lang=\"en\", country=\"us\")\r\n```\r\n\r\n**What you get:** Top-ranked apps with titles, developers, ratings, install counts, prices, and screenshots.\r\n\r\n\ud83d\udcc4 **[View JSON example \u2192](https://github.com/Mohammedcha/gplay-scraper/blob/main/output/list_example.json)**\r\n\r\n---\r\n\r\n### 6. [Similar Methods](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/SIMILAR_METHODS.md) - Find Related Apps\r\nDiscover apps similar to a reference app for competitive analysis and market research.\r\n\r\n\ud83d\udcd6 **[View detailed documentation \u2192](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/SIMILAR_METHODS.md)**\r\n\r\n```python\r\nfrom gplay_scraper import GPlayScraper\r\n\r\nscraper = GPlayScraper(http_client=\"curl_cffi\")\r\n\r\n# Print similar apps as JSON\r\nscraper.similar_print_all(\"com.whatsapp\", count=30, lang=\"en\", country=\"us\")\r\n```\r\n\r\n**What you get:** List of similar/competitor apps with titles, developers, ratings, and pricing information.\r\n\r\n\ud83d\udcc4 **[View JSON example \u2192](https://github.com/Mohammedcha/gplay-scraper/blob/main/output/similar_example.json)**\r\n\r\n---\r\n\r\n### 7. [Suggest Methods](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/SUGGEST_METHODS.md) - Get Search Suggestions\r\nGet autocomplete suggestions and keyword ideas for ASO and market research.\r\n\r\n\ud83d\udcd6 **[View detailed documentation \u2192](https://github.com/Mohammedcha/gplay-scraper/blob/main/README/SUGGEST_METHODS.md)**\r\n\r\n```python\r\nfrom gplay_scraper import GPlayScraper\r\n\r\nscraper = GPlayScraper(http_client=\"curl_cffi\")\r\n\r\n# Print search suggestions as JSON\r\nscraper.suggest_print_all(\"photo editor\", count=10, lang=\"en\", country=\"us\")\r\n```\r\n\r\n**What you get:** List of popular search terms related to your keyword for ASO and keyword research.\r\n\r\n\ud83d\udcc4 **[View JSON example \u2192](https://github.com/Mohammedcha/gplay-scraper/blob/main/output/suggest_example.json)**\r\n\r\n---\r\n\r\n## \ud83e\udd1d Contributing\r\n\r\n1. Fork the repository\r\n2. Create your feature branch\r\n3. Make your changes\r\n4. Test thoroughly\r\n5. Submit a pull request\r\n\r\n## \ud83d\udcc4 License\r\n\r\nThis project is licensed under the MIT License.\r\n\r\n---\r\n\r\n**Happy Analyzing! \ud83d\ude80**\r\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "\ud83d\ude80 Advanced Google Play Store Scraper - Extract 65+ app fields, reviews, ratings, ASO data, developer info, top charts, search results with 7 HTTP clients & unlimited pagination support",
    "version": "1.0.5",
    "project_urls": {
        "Bug Reports": "https://github.com/mohammedcha/gplay-scraper/issues",
        "Changelog": "https://github.com/mohammedcha/gplay-scraper/blob/main/CHANGELOG.md",
        "Documentation": "https://mohammedcha.github.io/gplay-scraper/",
        "Download": "https://github.com/mohammedcha/gplay-scraper/archive/v1.0.5.tar.gz",
        "Examples": "https://github.com/mohammedcha/gplay-scraper/tree/main/examples",
        "Feature Requests": "https://github.com/mohammedcha/gplay-scraper/issues",
        "Homepage": "https://github.com/mohammedcha/gplay-scraper",
        "PyPI": "https://pypi.org/project/gplay-scraper/",
        "Source Code": "https://github.com/mohammedcha/gplay-scraper"
    },
    "split_keywords": [
        "google-play-scraper",
        " playstore-scraper",
        " android-scraper",
        " gplay-scraper",
        " google-play-store",
        " play-store-api",
        " app-data-extraction",
        " app-analytics",
        " mobile-analytics",
        " aso-tools",
        " app-store-optimization",
        " mobile-seo",
        " app-marketing",
        " keyword-research",
        " competitor-analysis",
        " market-research",
        " app-reviews",
        " user-reviews",
        " review-scraper",
        " rating-analysis",
        " sentiment-analysis",
        " developer-tools",
        " api-scraping",
        " web-scraping",
        " data-mining",
        " python-scraper",
        " automation-tools",
        " business-intelligence",
        " market-intelligence",
        " competitive-intelligence",
        " app-monitoring",
        " trend-analysis",
        " performance-tracking",
        " install-tracking",
        " revenue-analysis"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "a4d0531317dff243e10a37de5ee962cf4fa1e4734013c7f582a52f7ff5d486f6",
                "md5": "0677d9add7caf9943a26cc38a19aee1e",
                "sha256": "2a5f84d37cc6c841573f4f47cec911b2d01d13f570e60c63abff755cf852bd3e"
            },
            "downloads": -1,
            "filename": "gplay_scraper-1.0.5-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "0677d9add7caf9943a26cc38a19aee1e",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 52002,
            "upload_time": "2025-10-18T17:32:20",
            "upload_time_iso_8601": "2025-10-18T17:32:20.140549Z",
            "url": "https://files.pythonhosted.org/packages/a4/d0/531317dff243e10a37de5ee962cf4fa1e4734013c7f582a52f7ff5d486f6/gplay_scraper-1.0.5-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "f40e8681d959cbe129771e8dc336941d019cc0aa6b6528cc75f6057829cb88be",
                "md5": "cd375789de5c23edbca01d9df4095b1b",
                "sha256": "b4d03589e811e431e69e0125206a527997a3001448cf7552b68baf6b47ec8f4a"
            },
            "downloads": -1,
            "filename": "gplay_scraper-1.0.5.tar.gz",
            "has_sig": false,
            "md5_digest": "cd375789de5c23edbca01d9df4095b1b",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 64866,
            "upload_time": "2025-10-18T17:32:21",
            "upload_time_iso_8601": "2025-10-18T17:32:21.815303Z",
            "url": "https://files.pythonhosted.org/packages/f4/0e/8681d959cbe129771e8dc336941d019cc0aa6b6528cc75f6057829cb88be/gplay_scraper-1.0.5.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-10-18 17:32:21",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "mohammedcha",
    "github_project": "gplay-scraper",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [
        {
            "name": "requests",
            "specs": [
                [
                    ">=",
                    "2.25.0"
                ]
            ]
        },
        {
            "name": "beautifulsoup4",
            "specs": [
                [
                    ">=",
                    "4.9.0"
                ]
            ]
        },
        {
            "name": "curl-cffi",
            "specs": [
                [
                    ">=",
                    "0.5.0"
                ]
            ]
        },
        {
            "name": "tls-client",
            "specs": [
                [
                    ">=",
                    "1.0.0"
                ]
            ]
        },
        {
            "name": "urllib3",
            "specs": [
                [
                    ">=",
                    "1.26.0"
                ]
            ]
        },
        {
            "name": "cloudscraper",
            "specs": [
                [
                    ">=",
                    "1.2.0"
                ]
            ]
        },
        {
            "name": "aiohttp",
            "specs": [
                [
                    ">=",
                    "3.8.0"
                ]
            ]
        },
        {
            "name": "httpx",
            "specs": [
                [
                    ">=",
                    "0.24.0"
                ]
            ]
        },
        {
            "name": "pytest",
            "specs": [
                [
                    ">=",
                    "6.0.0"
                ]
            ]
        },
        {
            "name": "sphinx",
            "specs": [
                [
                    ">=",
                    "4.0.0"
                ]
            ]
        },
        {
            "name": "sphinx-rtd-theme",
            "specs": [
                [
                    ">=",
                    "1.0.0"
                ]
            ]
        }
    ],
    "lcname": "gplay-scraper"
}
        
Elapsed time: 2.41170s