ClickYourApp Docs
Back to site

App Comparison

Fetch and compare an app across Apple App Store and Google Play in a single request.

Endpoint

GET /api/insights/comparison/

Query Parameters

ParameterTypeRequiredDescription
appleIdstringConditionalApple app ID (at least one of appleId/googleId required)
googleIdstringConditionalGoogle Play package name
countrystringNoCountry code (default: us)
langstringNoLanguage code (default: en)

Example Request

GET /api/insights/comparison/?appleId=com.spotify.client&googleId=com.spotify.music&country=us

Response

Returns comparison data for both stores, plus fallback screenshots if the Apple listing has none:

{
  "apple": {
    "info": {
      "appId": "com.spotify.client",
      "title": "Spotify: Music and Podcasts",
      "developer": { "name": "Spotify AB" },
      "screenshots": { "phone": [...] },
      ...
    },
    "ratings": { ... },
    "reviews": [...]
  },
  "google": {
    "info": { ... },
    "ratings": { ... },
    "reviews": [...]
  },
  "fallbackScreenshots": []
}

The fallbackScreenshots array is populated when the Apple listing has no screenshots — the API attempts to fetch them from Google Play as a best-effort fallback.

Cache

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

Errors

StatusDescription
400Neither appleId nor googleId provided
500Upstream API failure