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

ParameterRequiredDescription
storeYesapple or google
bundleIdYesApp bundle identifier (e.g. com.spotify.client)

Query Parameters

ParameterTypeDefaultDescription
countrystringSmart fallbackCountry code
langstringenLanguage (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

HeaderValue
s-maxage86400 (24 hours)
max-age3600 (1 hour)
stale-while-revalidate7200 (2 hours)

Errors

StatusDescription
400Missing/invalid store or bundleId
404App not found
500Upstream API failure