Quick Start
The API server runs on http://localhost:5003
Retrieve comprehensive JSON data for any Android or iOS app:
GET /json?id={APP_ID}[&gl={COUNTRY_CODE}]
Android Apps (Google Play Store)
Use the package name (e.g., com.company.app)
http://localhost:5003/json?id=com.dd.doordash
iOS Apps (Apple App Store)
Use the numeric app ID (e.g., 310633997)
http://localhost:5003/json?id=310633997
Sample JSON Response
{
"appId": "com.dd.doordash",
"title": "DoorDash - Food Delivery",
"developer": "DoorDash",
"score": 4.6,
"reviews": 4299422,
"installs": "50,000,000+",
"version": "15.156.24",
"updated": 1711670400000,
"released": "2015-03-26",
"genre": "Food & Drink",
"price": 0,
"free": true,
"currency": "USD",
"priceText": "Free",
"description": "Delivery anywhere you are...",
"screenshots": [...],
"icon": "https://play-lh.googleusercontent.com/...",
"headerImage": "https://play-lh.googleusercontent.com/...",
"developerId": "DoorDash",
"developerEmail": "support@doordash.com",
"developerWebsite": "https://www.doordash.com/",
"privacyPolicy": "https://www.doordash.com/privacy/",
"categories": [{"id": "FOOD_AND_DRINK", "name": "Food & Drink"}],
"contentRating": "Everyone",
"adSupported": false,
"offersIAP": true,
"url": "https://play.google.com/store/apps/details?id=com.dd.doordash"
}
Additional Endpoints
Shields.io Badges
Get specific app data formatted for Shields.io badges:
GET /:attribute?id={APP_ID}[&gl={COUNTRY_CODE}]
Example: http://localhost:5003/score?id=com.dd.doordash
Prometheus Metrics
View API performance metrics:
GET /metrics
Available at: http://localhost:5004/metrics
Known Issues
- Google Play Store ratings are region-specific. Use the
glparameter to get ratings for specific countries (e.g.,&gl=INfor India) - Some iOS app data may require fallback scraping methods
- Rate limiting may apply when making frequent requests
Example with country code:
http://localhost:5003/json?id=com.dd.doordash&gl=IN
Tech Stack
- Runtime: Node.js with ES Modules
- Web Framework: Express.js
- Scraping: google-play-scraper, app-store-scraper, cheerio
- Caching: In-memory cache with TTL
- Metrics: Prometheus client
- Development: Nodemon for auto-restart
License
Find the license here.