Events by group

Purpose

The get events Count by group API provides flexible event analytics with customizable grouping and aggregation capabilities. This endpoint allows you to analyze event data across multiple dimensions simultaneously, creating hierarchical breakdowns of event counts based on specified grouping criteria. The API requires a date range and grouping configuration, with optional filtering by platform, group name, and event name. The unique grouping system enables multi-dimensional analysis by combining up to three grouping entities such as device type, platform, bundle, date, app version, country, and event type. The response structure dynamically adapts to match your grouping configuration, creating nested JSON hierarchies that reflect the specified group order. For example, grouping by "platform,country,devicetype" returns data organized first by platform, then by country within each platform, and finally by device type within each country. This flexible structure supports complex analytical queries and enables detailed segmentation analysis.

OAuth scope : JProxy.jmobileapi.ALL

Request body (JSON)

Parameter	Data type	Allowed values	Description
startdate (mandatory)	string	Date	Beginning of date range for data retrieval, required format - dd-MM-yyyy
enddate (mandatory)	string	Date	End of date range for data retrieval, required format - dd-MM-yyy
group (mandatory)	string		Comma-separated list of grouping entities (devicetype, platform, bundle, date, appversion, country, event). Maximum 3 groups. Response structure follows the specified group order in nested JSON format.
groupname	string		Group Name of an Event to Filter. Need to be used in combination with eventname param.
platform	string	iOS, Android, Windows, macOS, tvOS,watchOS	Platform to filter Events (iOS, Android, Windows, tvOS, watchOS, macOS). Default - all platforms.
eventname	string		A specific Event to filter. Need to be used in combination with groupname param.
limit	string	number	Number of results per page. Default and maximum: 500. Use smaller values to limit response size.
offset	string	number	Starting position for result pagination (default - 0). Increment by limit value for next page (e.g., 501, 1001).

Request example

Copiedcurl --request GET \
  --url 'https://apptics.zoho.com/cx/api/v1/event/multigroup?startdate=02-08-2025&enddate=24-08-2025&group=platform%2Cdevicetype' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
  --header 'projectid: 12345689' \
  --header 'zsoid: 10234695'

Response example

Copied{
    "result": {
        "iOS": {
            "iPhone": 155248,
            "iPad": 3496
        },
        "Android": {
            "Phone": 40011,
            "Tablet": 1110,
            "Foldables": 1186
        }
    },
    "status": "success"
}