Project statistics API
- Tier: Free, Premium, Ultimate
- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
Every API call to project statistics must be authenticated. Retrieving these statistics requires read access to the repository.
For use with a personal access token,
use a token with read_api
scope. For a group access token,
you can use Reporter role and read_api
scope.
This API retrieves the number of times the project is either cloned or pulled with the HTTP method. SSH fetches are not included.
Get the statistics of the last 30 days
Get the clone and pull statistics for a project for the last 30 days.
GET /projects/:id/statistics
Supported attributes:
Attribute | Type | Required | Description |
---|---|---|---|
id | integer or string | Yes | ID or URL-encoded path of the project. |
If successful, returns 200 OK
and the
following response attributes:
Attribute | Type | Description |
---|---|---|
fetches | object | Fetch statistics for the project. |
fetches.days | array | Array of daily fetch statistics. |
fetches.days[].count | integer | Number of fetches for the specific date. |
fetches.days[].date | string | Date in ISO format (YYYY-MM-DD ). |
fetches.total | integer | Total number of fetches for the last 30 days. |
Example request:
curl --header "PRIVATE-TOKEN: <your_access_token>" \
--url "https://gitlab.example.com/api/v4/projects/42/statistics"
Example response:
{
"fetches": {
"total": 50,
"days": [
{
"count": 10,
"date": "2018-01-10"
},
{
"count": 10,
"date": "2018-01-09"
},
{
"count": 10,
"date": "2018-01-08"
},
{
"count": 10,
"date": "2018-01-07"
},
{
"count": 10,
"date": "2018-01-06"
}
]
}
}