# Pontos de extremidade da API REST para estatísticas do repositório

Utilize a API REST para buscar os dados que o GitHub usa para exibir diferentes tipos de atividades do repositório.

## Sobre estatísticas do repositório

Use a API REST para buscar os dados que o GitHub usa para exibir diferentes tipos de atividade do repositório.

### Melhores práticas de armazenamento em cache

Computar as estatísticas do repositório é uma operação cara. Por esse motivo, tentamos retornar dados armazenados em cache sempre que possível. Se os dados não forem armazenados em cache ao consultar as estatísticas de um repositório, você receberá uma resposta `202`. Um trabalho em segundo plano também é disparado para iniciar a compilação dessas estatísticas. Você deve aguardar um breve momento até que o trabalho seja concluído e, em seguida, enviar novamente a solicitação. Se o trabalho for concluído, essa solicitação receberá uma resposta `200` com as estatísticas no corpo da resposta.

As estatísticas do repositório são armazenadas em cache pelo SHA do branch-padrão do repositório; fazer push para o branch-padrão redefine o armazenamento em cache de estatísticas.

### As estatísticas excluem alguns tipos de commits

As estatísticas expostas pela API correspondem às estatísticas mostradas por [diferentes grafos de repositório](/pt/enterprise-server@3.22/repositories/viewing-activity-and-data-for-your-repository/about-repository-graphs).

Para resumir:

* Todas as estatísticas excluem commits de merge.
* As estatísticas do contribuidor também excluem commits vazios.

> \[!NOTE]
> Most endpoints use `Authorization: Bearer <YOUR-TOKEN>` and `Accept: application/vnd.github+json` headers, plus `X-GitHub-Api-Version: 2026-03-10`. Curl examples below omit these standard headers for brevity.

## Get the weekly commit activity

```
GET /repos/{owner}/{repo}/stats/code_frequency
```

Returns a weekly aggregate of the number of additions and deletions pushed to a repository.

### Parameters

#### Headers

* **`accept`** (string)
  Setting to `application/vnd.github+json` is recommended.

#### Path and query parameters

* **`owner`** (string) (required)
  The account owner of the repository. The name is not case sensitive.

* **`repo`** (string) (required)
  The name of the repository without the .git extension. The name is not case sensitive.

### HTTP response status codes

* **200** - Returns a weekly aggregate of the number of additions and deletions pushed to a repository.

* **202** - Accepted

* **204** - A header with no content is returned.

### Code examples

#### Example

**Request:**

```curl
curl -L \
  -X GET \
  http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/stats/code_frequency
```

**Response schema (Status: 200):**

Array of array

## Get the last year of commit activity

```
GET /repos/{owner}/{repo}/stats/commit_activity
```

Returns the last year of commit activity grouped by week. The days array is a group of commits per day, starting on Sunday.

### Parameters

#### Headers

* **`accept`** (string)
  Setting to `application/vnd.github+json` is recommended.

#### Path and query parameters

* **`owner`** (string) (required)
  The account owner of the repository. The name is not case sensitive.

* **`repo`** (string) (required)
  The name of the repository without the .git extension. The name is not case sensitive.

### HTTP response status codes

* **200** - OK

* **202** - Accepted

* **204** - A header with no content is returned.

### Code examples

#### Example

**Request:**

```curl
curl -L \
  -X GET \
  http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/stats/commit_activity
```

**Response schema (Status: 200):**

Array of `Commit Activity`:

* `days`: required, array of integer
* `total`: required, integer
* `week`: required, integer

## Get all contributor commit activity

```
GET /repos/{owner}/{repo}/stats/contributors
```

Returns the total number of commits authored by the contributor. In addition, the response includes a Weekly Hash (weeks array) with the following information:

w - Start of the week, given as a Unix timestamp.
a - Number of additions
d - Number of deletions
c - Number of commits

### Parameters

#### Headers

* **`accept`** (string)
  Setting to `application/vnd.github+json` is recommended.

#### Path and query parameters

* **`owner`** (string) (required)
  The account owner of the repository. The name is not case sensitive.

* **`repo`** (string) (required)
  The name of the repository without the .git extension. The name is not case sensitive.

### HTTP response status codes

* **200** - OK

* **202** - Accepted

* **204** - A header with no content is returned.

### Code examples

#### Example

**Request:**

```curl
curl -L \
  -X GET \
  http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/stats/contributors
```

**Response schema (Status: 200):**

Array of `Contributor Activity`:

* `author`: required, any of:
  * **null**
  * **Simple User**
    * `name`: string or null
    * `email`: string or null
    * `login`: required, string
    * `id`: required, integer, format: int64
    * `node_id`: required, string
    * `avatar_url`: required, string, format: uri
    * `gravatar_id`: required, string or null
    * `url`: required, string, format: uri
    * `html_url`: required, string, format: uri
    * `followers_url`: required, string, format: uri
    * `following_url`: required, string
    * `gists_url`: required, string
    * `starred_url`: required, string
    * `subscriptions_url`: required, string, format: uri
    * `organizations_url`: required, string, format: uri
    * `repos_url`: required, string, format: uri
    * `events_url`: required, string
    * `received_events_url`: required, string, format: uri
    * `type`: required, string
    * `site_admin`: required, boolean
    * `starred_at`: string
    * `user_view_type`: string
* `total`: required, integer
* `weeks`: required, array of objects:
  * `w`: integer
  * `a`: integer
  * `d`: integer
  * `c`: integer

## Get the weekly commit count

```
GET /repos/{owner}/{repo}/stats/participation
```

Returns the total commit counts for the owner and total commit counts in all. all is everyone combined, including the owner in the last 52 weeks. If you'd like to get the commit counts for non-owners, you can subtract owner from all.
The array order is oldest week (index 0) to most recent week.
The most recent week is seven days ago at UTC midnight to today at UTC midnight.

### Parameters

#### Headers

* **`accept`** (string)
  Setting to `application/vnd.github+json` is recommended.

#### Path and query parameters

* **`owner`** (string) (required)
  The account owner of the repository. The name is not case sensitive.

* **`repo`** (string) (required)
  The name of the repository without the .git extension. The name is not case sensitive.

### HTTP response status codes

* **200** - The array order is oldest week (index 0) to most recent week.

* **404** - Resource not found

### Code examples

#### Example

**Request:**

```curl
curl -L \
  -X GET \
  http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/stats/participation
```

**Response schema (Status: 200):**

* `all`: required, array of integer
* `owner`: required, array of integer

## Get the hourly commit count for each day

```
GET /repos/{owner}/{repo}/stats/punch_card
```

Each array contains the day number, hour number, and number of commits:

0-6: Sunday - Saturday
0-23: Hour of day
Number of commits

For example, \[2, 14, 25] indicates that there were 25 total commits, during the 2:00pm hour on Tuesdays. All times are based on the time zone of individual commits.

### Parameters

#### Headers

* **`accept`** (string)
  Setting to `application/vnd.github+json` is recommended.

#### Path and query parameters

* **`owner`** (string) (required)
  The account owner of the repository. The name is not case sensitive.

* **`repo`** (string) (required)
  The name of the repository without the .git extension. The name is not case sensitive.

### HTTP response status codes

* **200** - For example, \[2, 14, 25] indicates that there were 25 total commits, during the 2:00pm hour on Tuesdays. All times are based on the time zone of individual commits.

* **204** - A header with no content is returned.

### Code examples

#### Example

**Request:**

```curl
curl -L \
  -X GET \
  http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/stats/punch_card
```

**Response schema (Status: 200):**

Same response schema as [Get the weekly commit activity](#get-the-weekly-commit-activity).