# GitHub Repo Releases API (https://www.socialcrawl.dev/platforms/github/repo-releases)

> Returns the most recent releases for the repository under `data.items[]` — each entry includes `tag_name`, `name`, `body` (markdown release notes), `published_at`, `prerelease`, and `assets[]`. Sorted newest-first by upstream default.

TL;DR: `GET /v1/github/repo/releases` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | GitHub repo URL — `https://github.com/{owner}/{repo}`. |
| `per_page` | no | Releases per page (1–100). Defaults to 30. |
| `page` | no | 1-indexed page number. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/github/repo/releases?url=https%3A%2F%2Fgithub.com%2Ffacebook%2Freact" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I list a repo's releases with an API?

Send a GET request to /v1/github/repo/releases with the repository URL in the url parameter. SocialCrawl returns an array of releases, each with tag name, release notes, published date, author, prerelease flag, and downloadable asset list.

### What fields does each release include?

Tag name, release name, body (the release notes as markdown), published and created timestamps, author, draft and prerelease flags, and an assets array with file name, size, and download URL for each attached binary.

### Can I track a project's release cadence with this?

Yes. List releases on a schedule and compare published timestamps to measure how often a project ships. Pair it with the repo endpoint for stars and the dossier endpoint for a synthesized activity view of the same project.

### Are release assets and binaries included?

Yes. Each release carries an assets array listing every uploaded file with its name, content type, byte size, download count, and direct download URL — useful for tracking which build artifacts a project distributes.

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

Each request costs 1 credit on the standard tier, regardless of how many releases come back. New accounts get 100 free credits with no credit card required — enough to pull release history for around 100 repositories.

See the full GitHub API: https://www.socialcrawl.dev/platforms/github

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to list GitHub releases for a repo with an API
- What does the SocialCrawl GitHub Releases API return?