App Details
Fetch detailed information about a single app by bundle ID.
Endpoint
GET /api/insights/{store}/app/{bundleId}/
Path Parameters
| Parameter |
Required |
Description |
store |
Yes |
apple or google |
bundleId |
Yes |
App bundle identifier (e.g. com.spotify.client) |
Query Parameters
| Parameter |
Type |
Default |
Description |
country |
string |
Smart fallback |
Country code |
lang |
string |
en |
Language (Google only) |
Example Request
GET /api/insights/google/app/com.spotify.music/?country=us&lang=en
Response
Returns a normalized app details object:
{
"appId": "com.spotify.music",
"title": "Spotify: Music and Podcasts",
"description": "With Spotify, you can listen to...",
"developer": {
"name": "Spotify AB",
"id": "Spotify+AB",
"url": "https://..."
},
"icon": "https://...",
"rating": 4.3,
"ratingCount": 15234567,
"price": "Free",
"currency": "USD",
"screenshots": {
"phone": ["https://...", "..."],
"tablet": ["https://...", "..."]
},
"genre": "Music & Audio",
"version": "8.9.42",
"size": "45M",
"contentRating": "Rated for 12+",
"releaseDate": "2014-03-05",
"lastUpdated": "2025-02-20",
"url": "https://..."
}
Fields vary between Apple and Google. The normalizer ensures a consistent shape.
Cache
| Header |
Value |
s-maxage |
86400 (24 hours) |
max-age |
3600 (1 hour) |
stale-while-revalidate |
7200 (2 hours) |
Errors
| Status |
Description |
| 400 |
Missing/invalid store or bundleId |
| 404 |
App not found |
| 500 |
Upstream API failure |