# GitHub Repository Releases

Returns the releases of a repository including the full release notes body, the tag and target commit, author, publish and created dates, prerelease and draft flags, and every downloadable asset with its size and download count.

- **Documentation:** [https://scrappa.co/docs/github-api/github_repository_releases](https://scrappa.co/docs/github-api/github_repository_releases)
- **API group:** GitHub API
- **Endpoint:** `GET https://scrappa.co/api/github/repository/releases`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `owner` | string | Yes | Repository owner login or organization, e.g. laravel. |
| `repo` | string | Yes | Repository name without the owner, e.g. framework. |
| `page` | integer | No | Page number. Pagination is explicit and per request; pages are never fetched for you. |
| `per_page` | integer | No | Rows per page, 1-100. GitHub caps most list routes at 100. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/github/repository/releases?owner=laravel&repo=framework"
```

## Example response

```json
{
    "search_parameters": {
        "engine": "github_repository_releases",
        "owner": "laravel",
        "repo": "framework"
    },
    "releases": [
        {
            "tag_name": "v13.0.0",
            "name": "Laravel 13",
            "body": "Release notes",
            "prerelease": false,
            "draft": false,
            "assets": []
        }
    ],
    "result_count": 1
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter failed validation. |
| 404 | Not Found | GitHub has no public resource at that address. For a repository this also covers a private or renamed repository, which is indistinguishable anonymously. |
| 503 | GitHub Upstream Unavailable | The upstream service is temporarily unavailable. Please retry shortly. |
| 500 | Parser Drift | GitHub returned a response shape this parser does not recognise. The incident has been reported; retrying will return the same result. |
| 406 | Not Acceptable Upstream | GitHub has no JSON representation for this route, or rejected the request headers. Never charged. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)