# GitHub Releases API. Releases, page by page.

Release notes, files and exact download counts. We handle the proxies, blocks and platform changes.

[Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dgithub.releases)

[In your agent: **GitHub MCP server** →](https://socialtap.dev/mcp/github/index.md)

## GitHub Releases API at a glance

Returns a public GitHub repository's releases, newest first, from its link or owner/name. Each release has its tag, title, release notes in Markdown, author, pre-release flag and publish date, every file with its size, SHA-256 and exact download count, the source code archives, and its reactions. A repository with no releases returns an empty list.

GET `/v1/github/releases`

[Read the API reference](https://socialtap.dev/docs/reference/github/releases/index.md)

- **1 credit** per page, $0.75–$1.97 per 1,000 pages
- **15 typed fields** null when unknown
- **10** releases per page, newest first, as GitHub orders them: releases of the same day are not always in the order they were published
- **`url`** is all it needs, e.g. `https://github.com/cli/cli`

## Send one request. Get up to 10 releases back.

Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free.

`$ npm install socialtap`

`url = https://github.com/cli/cli`

[Open in playground](https://socialtap.dev/playground/?endpoint=github.releases)

cURL:

```shell
curl -G 'https://socialtap.dev/v1/github/releases' \
  --data-urlencode 'url=https://github.com/cli/cli' \
  -H "x-api-key: $SOCIALTAP_API_KEY"
```

TypeScript SDK:

```typescript
import { SocialTap } from "socialtap";

const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY

const res = await client.github.releases.list({ url: "https://github.com/cli/cli" });
console.log(res.data);
console.log(res.credits.charged, res.meta.request_id);
```

Node.js (fetch):

```javascript
const params = new URLSearchParams({
  url: "https://github.com/cli/cli",
});
const res = await fetch(`https://socialtap.dev/v1/github/releases?${params}`, {
  headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" },
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
const { data, page, meta } = body;
console.log(data, meta.credits_charged);
```

Python (requests):

```python
import os

import requests

res = requests.get(
    "https://socialtap.dev/v1/github/releases",
    params={"url": "https://github.com/cli/cli"},
    headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]},
)
body = res.json()
if not res.ok:
    raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
data, page, meta = body["data"], body["page"], body["meta"]
print(data, meta["credits_charged"])
```

Go (net/http):

```go
package main

import (
	"encoding/json"
	"fmt"
	"log"
	"net/http"
	"net/url"
	"os"
)

func main() {
	q := url.Values{}
	q.Set("url", "https://github.com/cli/cli")
	req, err := http.NewRequest("GET", "https://socialtap.dev/v1/github/releases?"+q.Encode(), nil)
	if err != nil {
		log.Fatal(err)
	}
	req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY"))
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		log.Fatal(err)
	}
	defer res.Body.Close()
	var body struct {
		Data  json.RawMessage `json:"data"`
		Page  json.RawMessage `json:"page"`
		Meta  map[string]any  `json:"meta"`
		Error *struct {
			Code    string `json:"code"`
			Message string `json:"message"`
		} `json:"error"`
	}
	if err := json.NewDecoder(res.Body).Decode(&body); err != nil {
		log.Fatal(err)
	}
	if body.Error != nil {
		log.Fatalf("%s: %s", body.Error.Code, body.Error.Message)
	}
	fmt.Println(string(body.Data), body.Meta["credits_charged"])
}
```

200 OK:

```json
{
  "data": [
    {
      "approximate_fields": [],
      "assets": [
        {
          "metrics": {
            "download_count": 3803
          },
          "name": "gh_2.104.0_checksums.txt",
          "sha256": "180df77fb931591d5d65e33f02a76c9ade314d1c335569af73cc6c8fcb365d2c",
          "size_bytes": 1971,
          "url": "https://github.com/cli/cli/releases/download/v2.104.0/gh_2.104.0_checksums.txt"
        },
        {
          "metrics": {
            "download_count": 28
          },
          "name": "gh_2.104.0_linux_386.deb",
          "sha256": "d3b90c66a71249ef1ff38450d1644708071d091388804411cd45ce66de2c5ed6",
          "size_bytes": 14127242,
          "url": "https://github.com/cli/cli/releases/download/v2.104.0/gh_2.104.0_linux_386.deb"
        },
        {
          "metrics": {
            "download_count": 29
          },
          "name": "gh_2.104.0_linux_386.rpm",
          "sha256": "207f175dcf5318390560fbc0b9e501e81a60d03e93b6e56eed689dec424ce95c",
          "size_bytes": 14631570,
          "url": "https://github.com/cli/cli/releases/download/v2.104.0/gh_2.104.0_linux_386.rpm"
        }
      ],
      "author": {
        "avatar_url": "https://avatars.githubusercontent.com/in/15368?v=4",
        "display_name": null,
        "id": "41898282",
        "is_verified": null,
        "url": "https://github.com/apps/github-actions",
        "username": "github-actions[bot]"
      },
      "id": "443387629",
      "is_prerelease": false,
      "metrics": {
        "download_count": 38707
      },
      "notes": "## Protect private forks when deleting repositories\r\n\r\n`gh repo delete` now warns when deleting a private or internal repository will also delete its forks. The additional confirmation is required even with `--yes`.\r\n\r\nNon-interactive workflows and agents must explicitly accept t…",
      "platform": "github",
      "platform_specific": {
        "github": {
          "created_at": "2026-11-12T18:24:58Z",
          "discussion_url": null,
          "is_immutable": true,
          "mention_count": 7,
          "node_id": "RE_kwDODKw3uc4abY7t",
          "reaction_count": 4,
          "reactions": {
            "confused_count": 0,
            "eyes_count": 0,
            "heart_count": 0,
            "hooray_count": 1,
            "laugh_count": 0,
            "rocket_count": 1,
            "thumbs_down_count": 0,
            "thumbs_up_count": 2
          },
          "target_commitish": "3d5a9e355a837f2f5ee78d7484c118cc1342ad1a",
          "updated_at": "2026-11-12T19:05:11Z"
        }
      },
      "published_at": "2026-11-12T19:03:51Z",
      "tag": "v2.104.0",
      "tarball_url": "https://github.com/cli/cli/archive/refs/tags/v2.104.0.tar.gz",
      "title": "GitHub CLI 2.104.0",
      "unknown_fields": [],
      "url": "https://github.com/cli/cli/releases/tag/v2.104.0",
      "zipball_url": "https://github.com/cli/cli/archive/refs/tags/v2.104.0.zip"
    },
    {
      "approximate_fields": [],
      "assets": [
        {
          "metrics": {
            "download_count": 213936
          },
          "name": "gh_2.103.3_checksums.txt",
          "sha256": "f756e7859d90dbb5e85aae5194206c37da220bec9bac23d3d659078a8e766fdc",
          "size_bytes": 1971,
          "url": "https://github.com/cli/cli/releases/download/v2.103.3/gh_2.103.3_checksums.txt"
        },
        {
          "metrics": {
            "download_count": 527
          },
          "name": "gh_2.103.3_linux_386.deb",
          "sha256": "5b3b310d80e6bdb144d256b4c3794f01eac0cf3f6df44e893e5c85573f1138e5",
          "size_bytes": 14148728,
          "url": "https://github.com/cli/cli/releases/download/v2.103.3/gh_2.103.3_linux_386.deb"
        },
        {
          "metrics": {
            "download_count": 227
          },
          "name": "gh_2.103.3_linux_386.rpm",
          "sha256": "156bc68c9efb10bbb5c0c633174e88d4b69df154a6b5bb7e50cfe766ff094b59",
          "size_bytes": 14670638,
          "url": "https://github.com/cli/cli/releases/download/v2.103.3/gh_2.103.3_linux_386.rpm"
        }
      ],
      "author": {
        "avatar_url": "https://avatars.githubusercontent.com/in/15368?v=4",
        "display_name": null,
        "id": "41898282",
        "is_verified": null,
        "url": "https://github.com/apps/github-actions",
        "username": "github-actions[bot]"
      },
      "id": "424663522",
      "is_prerelease": false,
      "metrics": {
        "download_count": 2500192
      },
      "notes": "## What's Changed\r\n### 🐛 Fixes\r\n\r\n* fix(gh auth status): explain expired expiring tokens with `--no-refresh` by @babakks in [#14815](https://github.com/cli/cli/pull/14815)\r\n\r\n\r\n**Full Changelog**: https://github.com/cli/cli/compare/v2.103.2...v2.103.3",
      "platform": "github",
      "platform_specific": {
        "github": {
          "created_at": "2026-10-26T18:02:47Z",
          "discussion_url": null,
          "is_immutable": true,
          "mention_count": 1,
          "node_id": "RE_kwDODKw3uc4ZT9ni",
          "reaction_count": 45,
          "reactions": {
            "confused_count": 0,
            "eyes_count": 0,
            "heart_count": 8,
            "hooray_count": 0,
            "laugh_count": 8,
            "rocket_count": 15,
            "thumbs_down_count": 0,
            "thumbs_up_count": 14
          },
          "target_commitish": "63837fb778d6a39f02be0ce76ff89f2bc8d74bdc",
          "updated_at": "2026-10-26T19:24:06Z"
        }
      },
      "published_at": "2026-10-26T19:20:08Z",
      "tag": "v2.103.3",
      "tarball_url": "https://github.com/cli/cli/archive/refs/tags/v2.103.3.tar.gz",
      "title": "GitHub CLI 2.103.3",
      "unknown_fields": [],
      "url": "https://github.com/cli/cli/releases/tag/v2.103.3",
      "zipball_url": "https://github.com/cli/cli/archive/refs/tags/v2.103.3.zip"
    },
    {
      "approximate_fields": [],
      "assets": [
        {
          "metrics": {
            "download_count": 50142
          },
          "name": "gh_2.103.2_checksums.txt",
          "sha256": "414d6009dc7f9f936d70831af818d1a32aa0ff07a77646861efd207356a36b2d",
          "size_bytes": 1971,
          "url": "https://github.com/cli/cli/releases/download/v2.103.2/gh_2.103.2_checksums.txt"
        },
        {
          "metrics": {
            "download_count": 134
          },
          "name": "gh_2.103.2_linux_386.deb",
          "sha256": "48e9e71d6f8daa87aef42b3df31d83023ece357cfb5321396c65cce2f56edc38",
          "size_bytes": 14147026,
          "url": "https://github.com/cli/cli/releases/download/v2.103.2/gh_2.103.2_linux_386.deb"
        },
        {
          "metrics": {
            "download_count": 60
          },
          "name": "gh_2.103.2_linux_386.rpm",
          "sha256": "acd73ca5af786cc559a00dc7619cb658b830727d7ad5a055464bd1699a647ecd",
          "size_bytes": 14668588,
          "url": "https://github.com/cli/cli/releases/download/v2.103.2/gh_2.103.2_linux_386.rpm"
        }
      ],
      "author": {
        "avatar_url": "https://avatars.githubusercontent.com/in/15368?v=4",
        "display_name": null,
        "id": "41898282",
        "is_verified": null,
        "url": "https://github.com/apps/github-actions",
        "username": "github-actions[bot]"
      },
      "id": "422277825",
      "is_prerelease": false,
      "metrics": {
        "download_count": 661417
      },
      "notes": "### 🐛 Fixes\r\n\r\n* Allow server to arbitrate which GitHub App installation tokens can attach files by @martinajir in [#14804](https://github.com/cli/cli/pull/14804)\r\n* Defer `--attach` credential checks to the upload endpoint by @BagToad in [#14805](https://github.com/cli/cli/pull/…",
      "platform": "github",
      "platform_specific": {
        "github": {
          "created_at": "2026-10-23T20:08:01Z",
          "discussion_url": null,
          "is_immutable": true,
          "mention_count": 2,
          "node_id": "RE_kwDODKw3uc4ZK3LB",
          "reaction_count": 6,
          "reactions": {
            "confused_count": 0,
            "eyes_count": 0,
            "heart_count": 0,
            "hooray_count": 0,
            "laugh_count": 0,
            "rocket_count": 0,
            "thumbs_down_count": 0,
            "thumbs_up_count": 6
          },
          "target_commitish": "4f2cfe92e3499f8581bf39db77e0a1431fa7b55c",
          "updated_at": "2026-10-23T20:28:28Z"
        }
      },
      "published_at": "2026-10-23T20:24:12Z",
      "tag": "v2.103.2",
      "tarball_url": "https://github.com/cli/cli/archive/refs/tags/v2.103.2.tar.gz",
      "title": "GitHub CLI 2.103.2",
      "unknown_fields": [],
      "url": "https://github.com/cli/cli/releases/tag/v2.103.2",
      "zipball_url": "https://github.com/cli/cli/archive/refs/tags/v2.103.2.zip"
    }
  ],
  "page": {
    "has_more": true,
    "next_cursor": "c1.EXAMPLE_CURSOR",
    "next_cursor_expires_at": "2026-10-26T12:00:00Z",
    "end_reason": null
  },
  "meta": {
    "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f",
    "platform": "github",
    "source": "api",
    "is_cached": false,
    "credits_charged": 1,
    "latency_ms": 1000,
    "fetched_at": "2026-10-25T12:00:00Z",
    "input": {
      "kind": "repository",
      "id": null,
      "url": "https://github.com/cli/cli"
    },
    "credits_remaining": 9999,
    "client_request_id": null,
    "warnings": []
  }
}
```

Long arrays and strings are shortened here. Real responses are complete.

## What you send and what comes back.

The [response reference](https://socialtap.dev/docs/reference/github/releases/index.md#response) lists every field, its type and when it is `null`. [See the full schema](https://socialtap.dev/resources/release/index.md).

- ### Null means unknown

  A field GitHub doesn't show is null, never zero or an empty string, so a real zero always means zero.
- ### What it accepts

  The repository: its link (https://github.com/cli/cli, or any page under it such as /releases or a release's own page), owner/name (cli/cli), a clone link ending in .git, or the API's link (api.github.com/repos/cli/cli, or api.github.com/repositories/212613049 by the repository's ID).
- ### What comes back

  Software releases with their tag, title, release notes, author, pre-release flag, date, downloadable files with sizes and download counts, and source archives.

- **`platform`string**: Platform ID (github, …).
- **`id`string**: Platform-native release ID (string): the platform's own where it has one, else derived from its repository or package and its tag, stable for the release's life.
- **`url`string**: Canonical release page URL.
- **`tag`string**: The tag the release is cut from, as written (v19.3.1, react-dom@19.0.0); on a package registry, the version (2.32.3).
- **`title`string**: The release's title as its author wrote it; null when it has none (the platform's page then shows the tag).
- **`notes`string**: Release notes as the author wrote them, in Markdown (the platform's own flavor: links, headings, @mentions); null when the release has none.
- **`author`object**: The account that published the release (often a bot on automated releases); null when the platform does not name one.
- **`is_prerelease`boolean**: Marked by its author as a pre-release (beta, release candidate), not ready for production; null when the platform has no such mark.

Live data from 35 platforms.

[TikTok](https://socialtap.dev/apis/tiktok/index.md) · [Instagram](https://socialtap.dev/apis/instagram/index.md) · [Facebook](https://socialtap.dev/apis/facebook/index.md) · [YouTube](https://socialtap.dev/apis/youtube/index.md) · [Reddit](https://socialtap.dev/apis/reddit/index.md) · [Threads](https://socialtap.dev/apis/threads/index.md) · [GitHub](https://socialtap.dev/apis/github/index.md) · [LinkedIn](https://socialtap.dev/apis/linkedin/index.md) · [X](https://socialtap.dev/apis/x/index.md) · [Spotify](https://socialtap.dev/apis/spotify/index.md) · [Hacker News](https://socialtap.dev/apis/hackernews/index.md) · [Amazon](https://socialtap.dev/apis/amazon/index.md) · [Apple Music](https://socialtap.dev/apis/applemusic/index.md) · [Pinterest](https://socialtap.dev/apis/pinterest/index.md) · [Rumble](https://socialtap.dev/apis/rumble/index.md) · [Bluesky](https://socialtap.dev/apis/bluesky/index.md) · [Twitch](https://socialtap.dev/apis/twitch/index.md) · [Telegram](https://socialtap.dev/apis/telegram/index.md) · [TikTok Shop](https://socialtap.dev/apis/tiktokshop/index.md) · [Kwai](https://socialtap.dev/apis/kwai/index.md) · [Snapchat](https://socialtap.dev/apis/snapchat/index.md) · [SoundCloud](https://socialtap.dev/apis/soundcloud/index.md) · [Truth Social](https://socialtap.dev/apis/truthsocial/index.md) · [Kick](https://socialtap.dev/apis/kick/index.md) · [Komi](https://socialtap.dev/apis/komi/page/index.md) · [Lnk.Bio](https://socialtap.dev/apis/linkbio/profile/index.md) · [Linkme](https://socialtap.dev/apis/linkme/profile/index.md) · [Linktree](https://socialtap.dev/apis/linktree/profile/index.md) · [Pillar](https://socialtap.dev/apis/pillar/page/index.md) · [TikTok Ad Library](https://socialtap.dev/apis/tiktok-ad-library/index.md) · [Facebook Ad Library](https://socialtap.dev/apis/facebook-ad-library/index.md) · [Facebook Events](https://socialtap.dev/apis/facebook-events/index.md) · [Facebook Marketplace](https://socialtap.dev/apis/facebook-marketplace/index.md) · [Google Ads Transparency Center](https://socialtap.dev/apis/google-ads-transparency/index.md) · [LinkedIn Ad Library](https://socialtap.dev/apis/linkedin-ad-library/index.md)

## What teams build with the GitHub Releases API.

- ### Track new versions of the tools you depend on
- ### Count downloads of each release and file
- ### Feed release notes into a changelog digest
- ### Verify downloaded files against their SHA-256

## Good to know before you build.

- metrics.download_count adds up the downloads of the release's files. GitHub counts no download of the source code archives, so a release with no files has a null count.
- Releases come newest first in GitHub's own order, where releases of the same day are not always in the order they were published. since and until filter on published_at.
- Drafts are never listed: GitHub shows them only to people who can push to the repository.
- If GitHub's API refuses, the list is read from the repository's releases page. Notes and download counts are then null, and assets is empty and listed in unknown_fields.

## 1 credit per page. Failed requests are free.

Buy credits once and spend them on any endpoint, on any platform.

[Plans and packs](https://socialtap.dev/pricing/index.md) · [How this endpoint is priced](https://socialtap.dev/docs/reference/github/releases/index.md#pricing) · [How credits work](https://socialtap.dev/docs/credits/index.md)

| Source | Price per successful page | Per 1,000 pages |
| --- | --- | --- |
| Platform API `api` | 1 credit | $0.75–$1.97 |
| Public page `page` | 1 credit | $0.75–$1.97 |

- Cache hits are free.
- Credits from packs and top-ups never expire.
- A monthly plan's credits are spent first, and what is left of them ends at each renewal.
- Prices exclude tax: sales tax is added at checkout where it applies.
- Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID.

## Questions about the GitHub Releases API.

More in the [API reference](https://socialtap.dev/docs/reference/github/releases/index.md).

**How much does the GitHub Releases API cost?**

A page of up to 10 releases costs 1 credit. Every successful page is charged, empty pages included. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack.

**How do I get the next page?**

Repeat the same request with cursor set to page.next_cursor from the previous response, keeping the other parameters. When page.has_more is false there are no more pages. Cursors expire after 24 hours.

More GitHub

## GitHub API. 20 endpoints, one key.

- [GitHub Profile API](https://socialtap.dev/apis/github/profile/index.md) (1 credit · `GET /v1/github/profile`)
- [GitHub Followers API](https://socialtap.dev/apis/github/followers/index.md) (1 credit / page · `GET /v1/github/followers`)
- [GitHub Following API](https://socialtap.dev/apis/github/following/index.md) (1 credit / page · `GET /v1/github/following`)
- [GitHub User Search API](https://socialtap.dev/apis/github/search-profiles/index.md) (1 credit / page · `GET /v1/github/search_profiles`)
- [GitHub Contributors API](https://socialtap.dev/apis/github/repository-contributors/index.md) (1 credit / page · `GET /v1/github/repository_contributors`)
- [GitHub Trending Developers API](https://socialtap.dev/apis/github/trending-profiles/index.md) (1 credit / page · `GET /v1/github/trending_profiles`)
- [GitHub Issue Comments API](https://socialtap.dev/apis/github/issue-comments/index.md) (1 credit / page · `GET /v1/github/issue_comments`)
- [GitHub Repository API](https://socialtap.dev/apis/github/repository/index.md) (1 credit · `GET /v1/github/repository`)
- [GitHub Repositories API](https://socialtap.dev/apis/github/repositories/index.md) (1 credit / page · `GET /v1/github/repositories`)
- [GitHub Repository Search API](https://socialtap.dev/apis/github/search-repositories/index.md) (1 credit / page · `GET /v1/github/search_repositories`)
- [GitHub Pinned Repositories API](https://socialtap.dev/apis/github/pinned-repositories/index.md) (1 credit / page · `GET /v1/github/pinned_repositories`)
- [GitHub Trending Repositories API](https://socialtap.dev/apis/github/trending-repositories/index.md) (1 credit / page · `GET /v1/github/trending_repositories`)
- [GitHub Issue API](https://socialtap.dev/apis/github/issue/index.md) (1 credit · `GET /v1/github/issue`)
- [GitHub Issues API](https://socialtap.dev/apis/github/issues/index.md) (1 credit / page · `GET /v1/github/issues`)
- [GitHub Issue Search API](https://socialtap.dev/apis/github/search-issues/index.md) (1 credit / page · `GET /v1/github/search_issues`)
- [GitHub Pull Requests API](https://socialtap.dev/apis/github/profile-pull-requests/index.md) (1 credit / page · `GET /v1/github/profile_pull_requests`)
- [GitHub Activity API](https://socialtap.dev/apis/github/activity/index.md) (1 credit / page · `GET /v1/github/activity`)
- [GitHub Contributions API](https://socialtap.dev/apis/github/contributions/index.md) (1 credit · `GET /v1/github/contributions`)
- [GitHub README API](https://socialtap.dev/apis/github/readme/index.md) (1 credit · `GET /v1/github/readme`)

## Try it on a link you already have.

Paste it in the playground, or copy the request into your code.

100free credits

- No credit card
- Failed requests are free
- Works on all 276 endpoints

[Start for free](https://socialtap.dev/signup/) [Read the docs](https://socialtap.dev/docs/index.md)

---

[HTML version](https://socialtap.dev/apis/github/releases/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)
