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 |