Introducing the Instagram APIRead more →

GitHub Releases API. Releases, page by page.

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

In your agent: GitHub MCP server →

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
  • 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
GET /v1/github/releasesTry in
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);
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.

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.

SourcePrice per successful pagePer 1,000 pages
Platform API api1 credit$0.75–$1.97
Public page page1 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?
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.

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 Read the docs