Performance Reports (CSV)

You can access your application's pre-generated monthly performance reports via the Aptoide Connect Developer Console or programmatically through this API endpoint.

Each entry describes one report and includes a downloadUrl you can use to download the CSV file. For every month, the response contains a chart report (time series) and top breakdowns by country and by partner.

Reports are generated during the first days of the following month, so the most recent full month becomes available a few days after it ends.

Endpoint

Method	URL
GET	https://ws.catappult.io/api/applications/{applicationName}/statistics/csvs

Authentication

To access this API, you need to have an active account subscription on Aptoide Connect and authenticate with an API key (check here how to generate one).

⚠️

Account type required

Performance reports can only be retrieved by accounts of type Developer.

Headers

Header	Type	Required	Description
Api-Key	string	Required	Used to authenticate your API requests. The value is your Aptoide Connect API key.

Path Parameters

Parameter	Type	Description
applicationName	string	The unique package name of the application (e.g., com.example.test).

Query Parameters

Parameter	Type	Required	Description
type	string	Required	Filters the reports by type. Possible values: revenue, installs, or downloads. The types available depend on the application.

Response

Success

If the API call returns an HTTP 200 status code, the request was successful and it returns a JSON array of available report objects, each with a download URL. type is the report kind (chart or top); subType further qualifies top reports (countries or partners) and is null for chart reports.

Example Response

[
  {
    "startDate": "2026-07-01",
    "endDate": "2026-07-31",
    "type": "chart",
    "subType": null,
    "downloadUrl": "https://.../com.example.test/statistics-sales-chart-2026-07.csv?..."
  },
  {
    "startDate": "2026-07-01",
    "endDate": "2026-07-31",
    "type": "top",
    "subType": "countries",
    "downloadUrl": "https://.../com.example.test/statistics-sales-top-countries-2026-07.csv?..."
  },
  {
    "startDate": "2026-07-01",
    "endDate": "2026-07-31",
    "type": "top",
    "subType": "partners",
    "downloadUrl": "https://.../com.example.test/statistics-sales-top-partners-2026-07.csv?..."
  }
]

CSV file structure

Each report is a CSV file. The leading column(s) identify the report's dimension, followed by the metric columns for the requested type.

Dimension columns

Report (type / subType)	Leading columns
chart	date
top / countries	countryCode, countryName
top / partners	partnerUid, partnerName

Metric columns

Requested type	Columns
revenue	netRevenue, grossRevenue, revenue, transactions, uniqueUsers, arppu, arpt
installs, downloads	volume

arppu is the average revenue per paying user and arpt the average revenue per transaction.

Example (type=revenue, chart)

date,netRevenue,grossRevenue,revenue,transactions,uniqueUsers,arppu,arpt
"2026-07-02","0.19","0.23","0.1425","1","1","0.23","0.23"
"2026-07-03","","","","","","",""