Charts Listing

Fetch top app charts (free, paid, grossing) for a given store and country.

Endpoint

GET /api/insights/{store}/charts/

Path Parameters

Parameter	Required	Values	Description
`store`	Yes	`apple`, `google`	App store to query

Query Parameters

Parameter	Type	Default	Description
`country`	string	`us` / `US`	Country code
`lang`	string	`en`	Language for localized app names
`limit`	number	`100`	Apps per chart section (max 200)

Example Request

GET /api/insights/apple/charts/?country=de&limit=50&lang=de

Response

Returns an array of chart sections, each containing an array of normalized apps:

[
  {
    "type": "free",
    "title": "Top Free Apps",
    "apps": [
      {
        "rank": 1,
        "appId": "com.example.app",
        "title": "Example App",
        "developer": "Example Inc.",
        "icon": "https://...",
        "rating": 4.5,
        "price": "Free",
        "url": "https://..."
      }
    ]
  },
  {
    "type": "paid",
    "title": "Top Paid Apps",
    "apps": [...]
  },
  {
    "type": "grossing",
    "title": "Top Grossing Apps",
    "apps": [...]
  }
]

Cache

Header	Value
`s-maxage`	3600 (1 hour)
`max-age`	3600 (1 hour)
`stale-while-revalidate`	7200 (2 hours)

Errors

Status	Description
400	Missing or invalid `store` parameter
500	Upstream API failure