# Codeberg API
> Live profile and repository data from Codeberg as an API — the community-run, Forgejo-powered git host and a leading open-source alternative to GitHub. Look up any user or organisation for their profile and social reach (followers, following, starred repositories, join date, location and website), open any repository for its stats (stars, forks, watchers, open issues, primary language, size and dates), or search Codeberg's repositories ranked by stars. The git-forge community layer for developer, social and dashboard apps. Live, no key, no cache. Distinct from GitHub and GitLab APIs and from package-registry APIs — this is the Codeberg platform's own community and project data.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/codeberg-api/..."
```

## Pricing
- **Free** (Free) — 11,000 calls/Mo, 5 req/s
- **Starter** ($7/Mo) — 150,000 calls/Mo, 15 req/s
- **Pro** ($18/Mo) — 740,000 calls/Mo, 40 req/s
- **Scale** ($44/Mo) — 3,600,000 calls/Mo, 100 req/s

## Endpoints

### User

#### `GET /v1/user` — A user or organisation profile

**Parameters:**
- `username` (query, required, string) — Codeberg username or org Example: `forgejo`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/codeberg-api/v1/user?username=forgejo"
```

**Response:**
```json
{
    "data": {
        "id": 70422,
        "type": null,
        "login": "forgejo",
        "avatar": "https://codeberg.org/avatars/dae8ab126a96f6fbd6942cf08ab92382",
        "created": "2022-11-06T07:18:11+01:00",
        "website": "https://forgejo.org",
        "is_admin": false,
        "location": null,
        "followers": 534,
        "following": 0,
        "full_name": "Forgejo",
        "description": "Beyond coding. We forge.",
        "profile_url": "https://codeberg.org/forgejo",
        "starred_repos": 0,
        "account_age_days": 1311
    },
    "meta": {
        "timestamp": "2026-06-09T03:02:07.964Z",
        "request_id": "d112c45e-6c72-4fc8-8b39-764bed472d37"
    },
    "status": "ok",
    "message": "User retrieved successfully",
    "success": true
}
```

### Repo

#### `GET /v1/repo` — A repository's stats

**Parameters:**
- `repo` (query, required, string) — owner/name (or pass owner= & name=) Example: `forgejo/forgejo`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/codeberg-api/v1/repo?repo=forgejo%2Fforgejo"
```

**Response:**
```json
{
    "data": {
        "url": "https://codeberg.org/forgejo/forgejo",
        "name": "forgejo",
        "forks": 839,
        "owner": "forgejo",
        "stars": 4890,
        "created": "2022-11-06T07:24:57+01:00",
        "is_fork": false,
        "size_kb": 344999,
        "updated": "2026-06-09T04:01:16+02:00",
        "language": "Go",
        "watchers": 119,
        "full_name": "forgejo/forgejo",
        "is_mirror": false,
        "description": "Beyond coding. We forge.",
        "is_archived": false,
        "open_issues": 1340,
        "default_branch": "forgejo"
    },
    "meta": {
        "timestamp": "2026-06-09T03:02:08.087Z",
        "request_id": "71068e86-66af-47ee-9abc-86f4323e1bce"
    },
    "status": "ok",
    "message": "Repository retrieved successfully",
    "success": true
}
```

### Search

#### `GET /v1/search` — Search repositories

**Parameters:**
- `q` (query, required, string) — Search query (min 2 chars) Example: `markdown`
- `sort` (query, optional, string) — stars (default), forks or updated Example: `stars`
- `limit` (query, optional, string) — Max results (1-50) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/codeberg-api/v1/search?q=markdown&sort=stars&limit=20"
```

**Response:**
```json
{
    "data": {
        "sort": "stars",
        "count": 20,
        "query": "markdown",
        "repos": [
            {
                "url": "https://codeberg.org/Recommendations/Mirror_to_Codeberg",
                "name": "Mirror_to_Codeberg",
                "forks": 5,
                "owner": "Recommendations",
                "stars": 155,
                "created": "2022-12-30T02:57:44+01:00",
                "is_fork": false,
                "size_kb": 646,
                "updated": "2024-12-03T05:29:22+01:00",
                "language": "Markdown",
                "watchers": 10,
                "full_name": "Recommendations/Mirror_to_Codeberg",
                "is_mirror": false,
                "description": "A central place of information about mirroring repos to Codeberg #GiveUpGitHub",
                "is_archived": false,
                "open_issues": 10,
                "default_branch": "main"
            },
            {
                "url": "https://codeberg.org/swiso/website",
                "name": "website",
                "forks": 33,
                "owner": "swiso",
                "stars": 150,
                "created": "2019-09-27T17:43:10+02:00",
                "is_fork": false,
                "size_kb": 12156,
                "updated": "2026-03-15T17:58:22+01:00",
                "language": "HTML",
                "watchers": 14,
                "full_name": "swiso/website",
                "is_mirror": false,
                "d
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/codeberg-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "source": "Codeberg (Forgejo) public API (live)",
        "service": "codeberg-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/repo": "A repository's stats (repo=forgejo/forgejo or owner= & name=).",
            "GET /v1/user": "A user/org profile + social counts (username=forgejo).",
            "GET /v1/search": "Search repositories (q=markdown, sort=stars|forks|updated)."
        },
        "description": "Live Codeberg (Forgejo) git-forge community data: any user or organisation's profile and social reach (followers, following, starred repos, join date), any repository's stats (stars, forks, watchers, open issues, language, size, dates), and repository search ranked by stars. Codeberg is the community-run open-source alternative to GitHub. Live, no key. Distinct from GitHub/GitLab and package-registry APIs — this is the Codeberg platform's own community and project data.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-09T03:02:11.773Z",
        "request_id": "2ab1b494-e80c-4c3f-bd51-da309b65a719"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```

### Users

#### `GET /v1/user-repos` — A user/org's repositories ranked by stars

**Parameters:**
- `username` (query, required, string) — Codeberg username or org Example: `forgejo`
- `limit` (query, optional, string) — Max repos (1-50) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/codeberg-api/v1/user-repos?username=forgejo&limit=20"
```

**Response:**
```json
{
    "data": {
        "count": 20,
        "repos": [
            {
                "url": "https://codeberg.org/forgejo/forgejo",
                "name": "forgejo",
                "forks": 846,
                "owner": "forgejo",
                "stars": 4930,
                "created": "2022-11-06T07:24:57+01:00",
                "is_fork": false,
                "size_kb": 376359,
                "updated": "2026-06-13T03:53:26+02:00",
                "language": "Go",
                "watchers": 120,
                "full_name": "forgejo/forgejo",
                "is_mirror": false,
                "description": "Beyond coding. We forge.",
                "is_archived": false,
                "open_issues": 1347,
                "default_branch": "forgejo"
            },
            {
                "url": "https://codeberg.org/forgejo/docs",
                "name": "docs",
                "forks": 246,
                "owner": "forgejo",
                "stars": 53,
                "created": "2023-08-06T00:30:46+02:00",
                "is_fork": false,
                "size_kb": 25611,
                "updated": "2026-06-13T09:35:21+02:00",
                "language": "Shell",
                "watchers": 32,
                "full_name": "forgejo/docs",
                "is_mirror": false,
                "description": "Forgejo Documentation",
                "is_archived": false,
                "open_issues": 59,
                "default_branch": "next"
         
…(truncated, see openapi.json for full schema)
```

### Repositories

#### `GET /v1/repo-commits` — A repository's recent commits

**Parameters:**
- `repo` (query, required, string) — owner/name Example: `forgejo/forgejo`
- `limit` (query, optional, string) — Max commits (1-50) Example: `10`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/codeberg-api/v1/repo-commits?repo=forgejo%2Fforgejo&limit=10"
```

**Response:**
```json
{
    "data": {
        "repo": "forgejo/forgejo",
        "count": 10,
        "commits": [
            {
                "sha": "36deaf6ae0",
                "url": "https://codeberg.org/forgejo/forgejo/commit/36deaf6ae05bd7e8002c8b018bf1cc60dff321e5",
                "date": "2026-06-13T03:46:44+02:00",
                "author": "oliverpool",
                "message": "fix(comment): RunMainAppWithStdin is the right name to search for (#13071)"
            },
            {
                "sha": "3be06159b4",
                "url": "https://codeberg.org/forgejo/forgejo/commit/3be06159b464c4b9ba8c56c4c6ee7042ed46ccb8",
                "date": "2026-06-13T03:45:57+02:00",
                "author": "Renovate Bot",
                "message": "Update module code.forgejo.org/forgejo/runner/v12 to v12.11.1 (forgejo) (#13074)"
            },
            {
                "sha": "dd993af8d5",
                "url": "https://codeberg.org/forgejo/forgejo/commit/dd993af8d53617abc6f7663f9304829e7e0cf11d",
                "date": "2026-06-13T03:44:42+02:00",
                "author": "Renovate Bot",
                "message": "Update module github.com/vektra/mockery/v3 to v3.7.1 (forgejo) (#13075)"
            },
            {
                "sha": "a893d5e339",
                "url": "https://codeberg.org/forgejo/forgejo/commit/a893d5e339ccf98528ab38ce4492c202f5938c95",
                "date": "2026-06-12T02:55:52+02:00",
                "author": "Renovate Bot",
                "mess
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/repo-issues` — A repository's issues

**Parameters:**
- `repo` (query, required, string) — owner/name Example: `forgejo/forgejo`
- `state` (query, optional, string) — open (default), closed or all Example: `open`
- `limit` (query, optional, string) — Max issues (1-50) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/codeberg-api/v1/repo-issues?repo=forgejo%2Fforgejo&state=open&limit=20"
```

**Response:**
```json
{
    "data": {
        "repo": "forgejo/forgejo",
        "count": 20,
        "state": "open",
        "issues": [
            {
                "url": "https://codeberg.org/forgejo/forgejo/issues/13078",
                "state": "open",
                "title": "bug: 2fa code completion pops up in safari for code search box",
                "author": "BernhardBln",
                "labels": [
                    "bug/new-report",
                    "forgejo/ui"
                ],
                "number": 13078,
                "created": "2026-06-13T09:18:45+02:00",
                "updated": "2026-06-13T09:19:34+02:00",
                "comments": 0
            },
            {
                "url": "https://codeberg.org/forgejo/forgejo/issues/13069",
                "state": "open",
                "title": "bug: npm package page doesn’t show readme anymore",
                "author": "tao-cumplido",
                "labels": [
                    "bug/new-report",
                    "forgejo/ui"
                ],
                "number": 13069,
                "created": "2026-06-12T21:02:02+02:00",
                "updated": "2026-06-12T21:02:02+02:00",
                "comments": 0
            },
            {
                "url": "https://codeberg.org/forgejo/forgejo/issues/13060",
                "state": "open",
                "title": "bug: inconsistency in context between schedule actions and other triggered actions",
                "author": "YaFou"
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/repo-releases` — A repository's published releases

**Parameters:**
- `repo` (query, required, string) — owner/name Example: `forgejo/forgejo`
- `limit` (query, optional, string) — Max releases (1-50) Example: `10`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/codeberg-api/v1/repo-releases?repo=forgejo%2Fforgejo&limit=10"
```

**Response:**
```json
{
    "data": {
        "repo": "forgejo/forgejo",
        "count": 10,
        "releases": [
            {
                "tag": "v15.0.3",
                "url": "https://codeberg.org/forgejo/forgejo/releases/tag/v15.0.3",
                "name": "v15.0.3",
                "draft": false,
                "author": "release-team",
                "published": "2026-06-10T08:11:24+02:00",
                "prerelease": false
            },
            {
                "tag": "v11.0.15",
                "url": "https://codeberg.org/forgejo/forgejo/releases/tag/v11.0.15",
                "name": "v11.0.15",
                "draft": false,
                "author": "release-team",
                "published": "2026-06-10T08:06:19+02:00",
                "prerelease": false
            },
            {
                "tag": "v15.0.2",
                "url": "https://codeberg.org/forgejo/forgejo/releases/tag/v15.0.2",
                "name": "v15.0.2",
                "draft": false,
                "author": "release-team",
                "published": "2026-05-12T12:09:16+02:00",
                "prerelease": false
            },
            {
                "tag": "v11.0.14",
                "url": "https://codeberg.org/forgejo/forgejo/releases/tag/v11.0.14",
                "name": "v11.0.14",
                "draft": false,
                "author": "release-team",
                "published": "2026-05-12T12:06:55+02:00",
                "prerelease": false
            },

…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/codeberg-api
OpenAPI spec: https://www.oanor.com/api/codeberg-api/openapi.json