GitHub Releases API. Releases, page by page.
Release notes, files and exact download counts. We handle the proxies, blocks and platform changes.
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
- 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
urlis 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 socialtapurl = https://github.com/cli/cliconst 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);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"])require "json"
require "net/http"
uri = URI("https://socialtap.dev/v1/github/releases")
uri.query = URI.encode_www_form('url' => 'https://github.com/cli/cli')
req = Net::HTTP::Get.new(uri)
req["x-api-key"] = ENV.fetch("SOCIALTAP_API_KEY")
res = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(req) }
body = JSON.parse(res.body)
raise "#{body["error"]["code"]}: #{body["error"]["message"]}" unless res.is_a?(Net::HTTPSuccess)
pp body["data"]
puts body["meta"]["credits_charged"]<?php
$query = http_build_query([
'url' => 'https://github.com/cli/cli',
]);
$ch = curl_init('https://socialtap.dev/v1/github/releases?' . $query);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['x-api-key: ' . getenv('SOCIALTAP_API_KEY')],
]);
$body = json_decode(curl_exec($ch), true);
if (curl_getinfo($ch, CURLINFO_RESPONSE_CODE) >= 400) {
throw new RuntimeException($body['error']['code'] . ': ' . $body['error']['message']);
}
print_r($body['data']);
echo $body['meta']['credits_charged'], PHP_EOL;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"])
}curl -G 'https://socialtap.dev/v1/github/releases' \
--data-urlencode 'url=https://github.com/cli/cli' \
-H "x-api-key: $SOCIALTAP_API_KEY"{
"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": []
}
}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);import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
public class Main {
public static void main(String[] args) throws Exception {
String query = "url=" + encode("https://github.com/cli/cli");
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://socialtap.dev/v1/github/releases?" + query))
.header("x-api-key", System.getenv("SOCIALTAP_API_KEY"))
.GET()
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
// An error is {"error": {"code", "message", ...}}; success is {data, meta}, meta.credits_charged its price.
if (response.statusCode() >= 400) throw new RuntimeException(response.body());
System.out.println(response.body());
}
static String encode(String value) {
return URLEncoder.encode(value, StandardCharsets.UTF_8);
}
}using System.Text.Json;
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-api-key", Environment.GetEnvironmentVariable("SOCIALTAP_API_KEY"));
var query = string.Join("&",
"url=" + Uri.EscapeDataString("https://github.com/cli/cli"));
var res = await http.GetAsync("https://socialtap.dev/v1/github/releases?" + query);
using var body = JsonDocument.Parse(await res.Content.ReadAsStringAsync());
if (!res.IsSuccessStatusCode)
{
var error = body.RootElement.GetProperty("error");
throw new Exception($"{error.GetProperty("code")}: {error.GetProperty("message")}");
}
Console.WriteLine(body.RootElement.GetProperty("data"));
Console.WriteLine(body.RootElement.GetProperty("meta").GetProperty("credits_charged"));// Cargo.toml: reqwest = { version = "0.12", features = ["blocking", "json"] }, serde_json = "1"
use std::env;
fn main() -> Result<(), Box<dyn std::error::Error>> {
let res = reqwest::blocking::Client::new()
.get("https://socialtap.dev/v1/github/releases")
.query(&[("url", "https://github.com/cli/cli")])
.header("x-api-key", env::var("SOCIALTAP_API_KEY")?)
.send()?;
let ok = res.status().is_success();
let body: serde_json::Value = res.json()?;
if !ok {
return Err(format!("{}: {}", body["error"]["code"], body["error"]["message"]).into());
}
println!("{} {}", body["data"], body["meta"]["credits_charged"]);
Ok(())
}200 OK · GET https://socialtap.dev/v1/github/releasesLong arrays and strings are shortened here. Real responses are complete.Docs What you send and what comes back.
The response reference lists every field, its type and when it is null. See the full schema.
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.
platformstring- Platform ID (github, …).
idstring- 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.
urlstring- Canonical release page URL.
tagstring- 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).
titlestring- The release's title as its author wrote it; null when it has none (the platform's page then shows the tag).
notesstring- Release notes as the author wrote them, in Markdown (the platform's own flavor: links, headings, @mentions); null when the release has none.
authorobject- The account that published the release (often a bot on automated releases); null when the platform does not name one.
is_prereleaseboolean- 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.
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.
| 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.
How much does the GitHub Releases API cost?
How do I get the next page?
Try it on a link you already have.
Paste it in the playground, or copy the request into your code.
- No credit card
- Failed requests are free
- Works on all 276 endpoints