v1

latestOpenAPI 3.1.02026-07-2414103.5 MB

App Sessions (iOS) - New

Returns the estimated Sessions Per User, Average Session Time, and Total Sessions Time Per User for a given app from the respective app store. Historical data goes back 37 months, depending on your subscription.

get/apple/sessions

Query parameters

api_keystring

Your Similarweb API key

app_idstring

Enter an app ID. How to find App IDs

start_datestring

Start month (format: YYYY-MM)

end_datestring

End month (format: YYYY-MM)

countrystring

Country filter, as a 2-letter ISO country code. To see the country filters you have access to, please refer to the Check Capabilities endpoint.

granularitystring

Set the granularity for the returned values. Can be 'daily', 'weekly' or 'monthly'.

formatstring

[optional] Format in which the reply should be returned. Possible values: 'json' (default) or 'xml'.

mtdboolean

Overrides the end_date and includes data up to the most recent date available (applicable only for “daily” and “weekly” granularities). “Monthly” granularity is not supported and will result in an error.

metricsstring

Limit the metrics for which you would like to retrieve data for, separated by commas. Possible values: "sessions_per_users", "average_session_time", "total_sessions_times"

Response

200

Example response

{
  "meta": {
    "request": {
      "store": "Apple",
      "granularity": "Daily",
      "start_date": "2024-01",
      "end_date": "2024-03",
      "app_id": "284882215",
      "format": "json",
      "country": "us"
    },
    "status": "Success",
    "last_updated": "2025-03-31"
  },
  "data": [
    {
      "date": "2024-01-01",
      "sessions_per_user": 11.489075476533275,
      "average_session_time": 248.6635765,
      "total_sessions_times": 2856.9145995
    }
  ]
}