Skip to main content

Overview

The Statistics API provides aggregated metrics about anonymous pull requests created through gitGost. All data is fully anonymized and contains no personally identifiable information.

GET /api/stats

Retrieve total PR count and most recent activity timestamp.

Request

curl https://gitgost.leapcell.app/api/stats

Response

total_prs
integer
required
Total number of anonymous PRs created through gitGost
last_updated
string
ISO 8601 timestamp of the most recent PR creation. Only included if PRs exist.

Response Example

{
  "total_prs": 1247,
  "last_updated": "2026-03-05T14:32:18.123456Z"
}

Empty State

If no PRs have been created yet:
{
  "total_prs": 0
}

GET /api/recent-prs

Retrieve the 10 most recent anonymous PRs.

Request

curl https://gitgost.leapcell.app/api/recent-prs

Response

prs
array
required
Array of recent PR records
prs[].id
integer
Database record ID
prs[].owner
string
Repository owner
prs[].repo
string
Repository name
prs[].pr_url
string
GitHub PR URL
prs[].created_at
string
ISO 8601 timestamp of PR creation
total
integer
required
Total number of PRs across all time

Response Example

{
  "prs": [
    {
      "id": 1247,
      "owner": "torvalds",
      "repo": "linux",
      "pr_url": "https://github.com/torvalds/linux/pull/12345",
      "created_at": "2026-03-05T14:32:18.123456Z"
    },
    {
      "id": 1246,
      "owner": "golang",
      "repo": "go",
      "pr_url": "https://github.com/golang/go/pull/67890",
      "created_at": "2026-03-05T12:15:42.987654Z"
    }
  ],
  "total": 1247
}

GET /api/pr-status/:hash

Get notification subscription information for a specific PR hash.

Parameters

hash
string
required
The PR hash returned after creating a PR (e.g., from git push output)

Request

curl https://gitgost.leapcell.app/api/pr-status/abc12345

Response

hash
string
required
The provided PR hash
ntfy_topic
string
required
The ntfy topic name for this PR (derived from hash)
subscribe_url
string
required
Full ntfy subscription URL for receiving PR notifications

Response Example

{
  "hash": "abc12345",
  "ntfy_topic": "gitgost-pr-abc12345",
  "subscribe_url": "https://ntfy.sh/gitgost-pr-abc12345"
}

Notes

Privacy

  • All statistics are aggregated and anonymized
  • No user identities, IP addresses, or metadata are exposed
  • PR records contain only public GitHub URLs and timestamps

Caching

  • Stats endpoints have no caching (real-time data)
  • For badge caching behavior, see Badge Endpoints

Rate Limiting

Statistics endpoints are publicly accessible with no authentication or rate limiting.

Implementation Reference

Source: internal/http/handlers.go
  • StatsHandler (lines 926-957)
  • RecentPRsHandler (lines 959-984)
  • PRStatusHandler (lines 1655-1672)

Build docs developers (and LLMs) love