In the interest of transparency and to enable developers in the community to make data driven decisions, the Joomla project offers this API for retrieving statistics data gathered from Joomla installations.

API Information

The statistics API is hosted at https://developer.joomla.org/stats and is the base URL for all API calls.  At this time, there is no rate limiting of the API.

Data Structure

All API endpoints return a JSON string representing an array of the requested data.  Each endpoint returns two top level keys; data and total.  For all data groups, the returned data structure is a grouping of the data into logical containers and this is returned in the data key.  For example, the PHP version is grouped based on the minor release branch.  The value of each key is represented as a percentage of the overall number of installations that have reported data.  The total key of all API returns is the total number of installations that have reported data.

API Endpoints

GET /

Retrieve all available data from the API.

GET /cms_version

Retrieve the CMS version data from the API.

GET /db_type

Retrieve the database engine data from the API.

GET /db_version

Retrieve the data version data from the API.
NOTE: At this time, the version data is returned without the corresponding database engine. An additional API endpoint for the combined database engine and version is planned.

GET /php_version

Retrieve the PHP version data from the API.

GET /server_os

Retrieve the server operating system data from the API.

POST /submit

Submit an installation's metrics to the API.