ClickYourApp Docs
Back to site

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