Insights API Overview

REST API for app store charts, app details, ratings, reviews, and AI-powered analysis.

The Insights API provides read-only access to Apple App Store and Google Play data. All endpoints return JSON and require no authentication.

Base URL

https://clickyourapp.com/api/insights/

Most endpoints accept these query parameters:

Parameter	Type	Default	Description
`country`	string	`us` (Apple) / `US` (Google)	ISO 3166-1 alpha-2 country code
`lang`	string	`en`	Language code for localized content

If country is omitted, the API uses a smart fallback: query param > Cloudflare CF-IPCountry header > bundle ID prefix inference > default.

All successful responses return the data directly as the JSON body:

[{ "type": "free", "title": "Top Free Apps", "apps": [...] }]

Error responses use this format:

{ "error": "Error description" }

Responses include Cache-Control headers for Cloudflare edge caching:

Charts: s-maxage=3600 (1 hour edge cache)
App details, ratings, reviews, comparison: s-maxage=86400 (24 hour edge cache)
Analysis: private, max-age=7200 (2 hour server-side only)

All cacheable endpoints include stale-while-revalidate=7200 — stale content is served instantly while the edge revalidates in the background.

The {store} path parameter accepts: