KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #dsh #dsh-plugin #ai-agent #codex #ai-agents #deepseek-harness #claude-code #cli #react #mcp

badge-it

★ 237 Open GitHub ↗

An API serving useful badges for your GitHub Profile README 🚀🎉 Formerly known as git-badges.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Badge-It

[![GitHub stars](https://img.shields.io/github/stars/pujux/badge-it?color=brightgreen)](https://github.com/pujux/badge-it/stargazers)
[![GitHub issues](https://img.shields.io/github/issues/pujux/badge-it?color=brightgreen)](https://github.com/pujux/badge-it/issues)
[![GitHub forks](https://img.shields.io/github/forks/pujux/badge-it?color=brightgreen)](https://github.com/pujux/badge-it/network)
[![GitHub license](https://img.shields.io/github/license/pujux/badge-it?color=brightgreen)](https://github.com/pujux/badge-it/blob/main/LICENSE)
[![Twitter](https://img.shields.io/twitter/url?url=https%3A%2F%2Fgithub.com%2Fpujux%2Fbadge-it)](https://twitter.com/intent/tweet?text=Wow:&url=https%3A%2F%2Fgithub.com%2Fpujux%2Fbadge-it)

Used by over **2,100 unique public repositories**

## Table of Contents

- [API Docs](#api-docs)
- [Caching & Rate Limits](#caching--rate-limits)
- [Usage](#available-badges-🔥)
- [Ideas](#got-an-idea-for-a-badge-)
- [License](#license)

## API Docs

Swagger UI and the OpenAPI document are available directly from the service:

- `GET /docs` (Swagger UI)
- `GET /docs/` (Swagger UI)
- `GET /openapi.json` (OpenAPI 3.1 JSON)

Note: badge endpoints are implemented as `302` redirects to `img.shields.io`. In Swagger UI, "Try it out" typically shows the followed downstream `200 image/svg+xml` response when the redirect target succeeds.

## Caching & Rate Limits

The API applies `Cache-Control` and an in-memory service-wide IP rate limit so badge renderers (GitHub and similar markdown clients) can cache safely while still limiting abuse:

- `GET /visits/*`: `Cache-Control: no-store`
- Badge redirect endpoints (`/years`, `/repos`, `/gists`, `/updated`, `/created`): `public, max-age=0, s-maxage=300, stale-while-revalidate=600`
- `GET /commits/*`: `public, max-age=0, s-maxage=120, stale-while-revalidate=300`
- SVG endpoints (`/contributors`, `/last-stars`): `public, max-age=0, s-maxage=300, stale-while-revalidate=600`
- Docs/OpenAPI (`/docs`, `/openapi.json`): `public, max-age=300, s-maxage=300`

All hits to the service count toward the same limiter window per source IP. When request limits are exceeded, the API returns `429 Too Many Requests` with `Retry-After` and `RateLimit-*` headers.

## Available badges 🔥

All endpoints support the parameters you can also use for [shields.io](https://shields.io) badges, you can check out their style documentation [here](https://shields.io/#styles).

<details>
<summary>Visits Badge</summary>
<br>
<p dir="auto"><a href="https://badges.pufler.dev/visits/pujux/badge-it" rel="nofollow"><img src="https://badges.pufler.dev/visits/pujux/badge-it" alt="Visits Badge" data-canonical-src="https://badges.pufler.dev/visits/pujux/badge-it" style="max-width: 100%;"></a></p>
<p dir="auto">Returns a badge containing the visitor counter for your repository</p>
<h6 tabindex="-1" dir="auto"><a id="user-content-endpoint" class="anchor" aria-hidden="true" href="#endpoint"></a>Endpoint</h6>
<p dir="auto"><code>https://badges.pufler.dev/visits/{username}/{repo}</code></p>
<h6 tabindex="-1" dir="auto"><a id="user-content-markdown" class="anchor" aria-hidden="true" href="#markdown"></a>Markdown</h6>
<p dir="auto"><code>[![Visits Badge](https://badges.pufler.dev/visits/pujux/badge-it)](https://badges.pufler.dev)</code></p>
</details>

---

<details>
<summary>Years Badge</summary>
<br>
<p dir="auto"><a href="https://badges.pufler.dev/years/pujux" rel="nofollow"><img src="https://badges.pufler.dev/years/pujux?_=0" alt="Years Badge" data-canonical-src="https://badges.pufler.dev/years/pujux" style="max-width: 100%;"></a></p>
<p dir="auto">Returns a badge containing the number of years you have been a member</p>
<h6 tabindex="-1" dir="auto"><a id="user-content-endpoint-1" class="anchor" aria-hidden="true" href="#endpoint-1"></a>Endpoint</h6>
<p dir="auto"><code>https://badges.pufler.dev/years/{username}</code></p>
<h6 tabindex="-1" dir="auto"><a id="user-content-markdown-1" class="anchor" aria-hidden="true" href="#markdown-1"></a>Markdown</h6>
<p dir="auto"><code>[![Years Badge](https://badges.pufler.dev/years/pujux)](https://badges.pufler.dev)</code></p>
</details>

---

<details>
<summary>Repos Badge</summary>
<br>
<p dir="auto"><a href="https://badges.pufler.dev/repos/pujux" rel="nofollow"><img src="https://badges.pufler.dev/repos/pujux?_=0" alt="Repos Badge" data-canonical-src="https://badges.pufler.dev/repos/pujux" style="max-width: 100%;"></a></p>
<p dir="auto">Returns a badge containing the number of your public repositories</p>
<h6 tabindex="-1" dir="auto"><a id="user-content-endpoint-2" class="anchor" aria-hidden="true" href="#endpoint-2"></a>Endpoint</h6>
<p dir="auto"><code>https://badges.pufler.dev/repos/{username}</code></p>
<h6 tabindex="-1" dir="auto"><a id="user-content-markdown-2" class="anchor" aria-hidden="true" href="#markdown-2"></a>Markdown</h6>
<p dir="auto"><code>[![Repos Badge](https://badges.pufler.dev/repos/pujux)](https://badges.pufler.dev)</code></p>
</details>

---

<details>
<summary>Gists Badge</summary>
<br>
<p dir="auto"><a href="https://badges.pufler.dev/gists/pujux" rel="nofollow"><img src="https://badges.pufler.dev/gists/pujux?_=0" alt="Gists Badge" data-canonical-src="https://badges.pufler.dev/gists/pujux" style="max-width: 100%;"></a></p>
<p dir="auto">Returns a badge containing the number of your public gists</p>
<h6 tabindex="-1" dir="auto"><a id="user-content-endpoint-3" class="anchor" aria-hidden="true" href="#endpoint-3"></a>Endpoint</h6>
<p dir="auto"><code>https://badges.pufler.dev/gists/{username}</code></p>
<h6 tabindex="-1" dir="auto"><a id="user-content-markdown-3" class="anchor" aria-hidden="true" href="#markdown-3"></a>Markdown</h6>
<p dir="auto"><code>[![Gists Badge](https://badges.pufler.dev/gists/pujux)](https://badges.pufler.dev)</code></p>
</details>

---

<details>
<summary>Updated Badge</summary>
<br>
<p dir="auto"><a href="https://badges.pufler.dev/updated/pujux/badge-it" rel="nofollow"><img src="https://badges.pufler.dev/updated/pujux/badge-it?_=0" alt="Updated Badge" data-canonical-src="https://badges.pufler.dev/updated/pujux/badge-it" style="max-width: 100%;"></a></p>
<p dir="auto">Returns a badge that shows when the repository was last updated</p>
<h6 tabindex="-1" dir="auto"><a id="user-content-endpoint-4" class="anchor" aria-hidden="true" href="#endpoint-4"></a>Endpoint</h6>
<p dir="auto"><code>https://badges.pufler.dev/updated/{username}/{repo}</code></p>
<h6 tabindex="-1" dir="auto"><a id="user-content-markdown-4" class="anchor" aria-hidden="true" href="#markdown-4"></a>Markdown</h6>
<p dir="auto"><code>[![Updated Badge](https://badges.pufler.dev/updated/pujux/badge-it)](https://badges.pufler.dev)</code></p>
</details>

---

<details>
<summary>Created Badge</summary>
<br>
<p dir="auto"><a href="https://badges.pufler.dev/created/pujux/badge-it" rel="nofollow"><img src="https://badges.pufler.dev/created/pujux/badge-it?_=0" alt="Created Badge" data-canonical-src="https://badges.pufler.dev/created/pujux/badge-it" style="max-width: 100%;"></a></p>
<p dir="auto">Returns a badge that shows when the repository was created</p>
<h6 tabindex="-1" dir="auto"><a id="user-content-endpoint-5" class="anchor" aria-hidden="true" href="#endpoint-5"></a>Endpoint</h6>
<p dir="auto"><code>https://badges.pufler.dev/created/{username}/{repo}</code></p>
<h6 tabindex="-1" dir="auto"><a id="user-content-markdown-5" class="anchor" aria-hidden="true" href="#markdown-5"></a>Markdown</h6>
<p dir="auto"><code>[![Created Badge](https://badges.pufler.dev/created/pujux/badge-it)](https://badges.pufler.dev)</code></p>
</details>

---

<details>
<summary>Commits Badge</summary>
<br>
<p dir="auto"><a href="https://badges.pufler.dev/commits/monthly/pujux" rel="nofollow"><img src="https://badges.pufler.dev/commits/monthly/pujux?_=0" alt="Commits Badge" data-canonical-src="https://badges.pufler.dev/commits/monthly/pujux" style="max-width: 100%;"></a></p>
<p dir="auto">Returns a badge that shows the number of commits you have published in a specified periodicity (yearly, monthly, weekly, daily or all)</p>
<h6 tabindex="-1" dir="auto"><a id="user-content-endpoint-6" class="anchor" aria-hidden="true" href="#endpoint-6"></a>Endpoint</h6>
<p dir="auto"><code>https://badges.pufler.dev/commits/{periodicity}/{username}</code></p>
<h6 tabindex="-1" dir="auto"><a id="user-content-markdown-6" class="anchor" aria-hidden="true" href="#markdown-6"></a>Markdown</h6>
<p dir="auto"><code>[![Commits Badge](https://badges.pufler.dev/commits/monthly/pujux)](https://badges.pufler.dev)</code></p>
</details>

---

<details>
<summary>Contributors Display</summary>
<br>
<p dir="auto"><a href="https://badges.pufler.dev/contributors/pujux/badge-it" rel="nofollow"><img src="https://badges.pufler.dev/contributors/pujux/badge-it?size=50&amp;padding=5&amp;perRow=10&amp;bots=true&amp;_=0" alt="Contributors Display" data-canonical-src="https://badges.pufler.dev/contributors/pujux/badge-it?size=50&amp;padding=5&amp;perRow=10&amp;bots=true" style="max-width: 100%;"></a></p>
<p dir="auto">Returns an SVG that displays all contributors of the specified repository</p>
<p dir="auto">You can specify <code>size</code> in pixels that will be used for each avatar, <code>padding</code> in pixels that will be used between the avatars, <code>perRow</code> to control how many avatars are shown per row and <code>bots</code> as either 'true' or 'false' to hide bot contributors</p>
<h6 tabindex="-1" dir="auto"><a id="user-content-endpoint-7" class="anchor" aria-hidden="true" href="#endpoint-7"></a>Endpoint</h6>
<p dir="auto"><code>https://badges.pufler.dev/contributors/{user}/{repo}?size={number}&amp;padding={number}&amp;perRow={number}&amp;bots={boolean}</code></p>
<h6 tabindex="-1" dir="auto"><a id="user-content-markdown-7" class="anchor" aria-hidden="true" href="#markdown-7"></a>Markdown</h6>
<p dir="auto"><code>[![Contributors Display](https://badges.pufler.dev/contributors/pujux/badge-it?size=50&amp;padding=5&amp;perRow=10&amp;bots=true)](https://badges.pufler.dev)</code></p>
</details>

---

<details>
<summary>Last Stars Display</summary>
<br>
<p dir="auto"><a href="https://badges.pufler.dev/last-stars/pujux" rel="nofollow"><img src="https://badges.pufler.dev/last-stars/pujux/?count=6&amp;padding=15&amp;perRow=3&amp;_=0" alt="Last Stars Display" data-canonical-src="https://badges.pufler.dev/last-stars/pujux/?count=6&amp;padding=15&amp;perRow=3" style="max-width: 100%;"></a></p>
<p dir="auto">Returns an SVG that displays the last starred repositories of the specified user</p>
<p dir="auto">You can specify <code>count</code> to control how many starred repositories will be shown, <code>padding</code> in pixels that will be used between the repositories and <code>perRow</code> to control how many repositories will be shown per row</p>
<h6 tabindex="-1" dir="auto"><a id="user-content-endpoint-8" class="anchor" aria-hidden="true" href="#endpoint-8"></a>Endpoint</h6>
<p dir="auto"><code>https://badges.pufler.dev/last-stars/{user}?count={number}&amp;padding={number}&amp;perRow={number}</code></p>
<h6 tabindex="-1" dir="auto"><a id="user-content-markdown-8" class="anchor" aria-hidden="true" href="#markdown-8"></a>Markdown</h6>
<p dir="auto"><code>[![Last Stars Display](https://badges.pufler.dev/last-stars/pujux?count=6&amp;padding=15&amp;perRow=3)](https://badges.pufler.dev)</code></p>
</details>

## Got an idea for a badge? 😀

Create an [issue](https://github.com/pujux/badge-it/issues/new)!

## License

Badge-It is licensed under the [BSD 3-Clause License](LICENSE).

badge-it

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README