Live status: ghstats.dev/status for API uptime, endpoint health, and response times.

Free, real-time GitHub stat cards, badges, and charts -- drop a URL into your README and you're done. No tokens, no setup.

ghstats.dev

Standard card

[![](https://ghstats.dev/api/card?username=YOUR_USERNAME&theme=tokyonight)](https://github.com/rowkav09/GitHub-profile-stats)

Compact grids (3 / 4 / 6)

[![](https://ghstats.dev/api/card?username=YOUR_USERNAME&theme=radical&size=compact&compact_count=3)](https://github.com/rowkav09/GitHub-profile-stats)
[![](https://ghstats.dev/api/card?username=YOUR_USERNAME&theme=catppuccin&size=compact&compact_count=4)](https://github.com/rowkav09/GitHub-profile-stats)
[![](https://ghstats.dev/api/card?username=YOUR_USERNAME&theme=forest&size=compact&compact_count=6)](https://github.com/rowkav09/GitHub-profile-stats)

Languages (bar, stacked, grid, horizontal list, vertical list, donut, vertical donut, compact)

Layout	Preview	Markdown
Bar		[](https://github.com/rowkav09/GitHub-profile-stats)
Stacked		[](https://github.com/rowkav09/GitHub-profile-stats)
Grid		[](https://github.com/rowkav09/GitHub-profile-stats)
Horizontal List		[](https://github.com/rowkav09/GitHub-profile-stats)
Vertical List		[](https://github.com/rowkav09/GitHub-profile-stats)
Donut		[](https://github.com/rowkav09/GitHub-profile-stats)
Vertical Donut		[](https://github.com/rowkav09/GitHub-profile-stats)
Compact		[](https://github.com/rowkav09/GitHub-profile-stats)

Mini badges (drop anywhere)

Any metric, any colour, any style — perfect for sprinkling through a README.

Metric	Preview	Markdown
Stars		[](https://github.com/rowkav09/GitHub-profile-stats)
Commits		[](https://github.com/rowkav09/GitHub-profile-stats)
Streak		[](https://github.com/rowkav09/GitHub-profile-stats)
Followers		[](https://github.com/rowkav09/GitHub-profile-stats)

Pass label=... to override the default label text and style=... to switch between flat, flat-square, for-the-badge, plastic, and minimal (see the table below).

Badge styles -- pick a look

Style	Preview
flat
flat-square
for-the-badge
plastic
minimal

Apply with ?style=for-the-badge on /api/mini or /api/badge. Works alongside color and label.

Activity sparkline (7--90 days)

[![](https://ghstats.dev/api/sparkline?username=YOUR_USERNAME&days=30&width=420)](https://github.com/rowkav09/GitHub-profile-stats)

Quick colour override

https://ghstats.dev/api/card?username=YOUR_USERNAME&bg=0f0f23&text=cccccc&title_color=ffff66&icon_color=ff6644

1. Create a public repo named your-username on GitHub and add a README.md.
2. Paste an embed from the gallery above. Done.

Need tweaks? Use the on-page editor to toggle stats, themes, borders, titles, and copy Markdown/HTML instantly.

Card ( /api/card )

• username (required)
• alltime=true (optional; returns all-time commit, PR, issue, and estimated-hours totals)
• theme default default
• Layout: size=default|compact, compact_count=3|4|6, show_emoji=true
• Visibility: hide=stars,issues,..., show_ring, show_icons, hide_title, hide_border
• Styling: bg, text, title_color, icon_color, border_color, border_radius, custom_title, order

Languages ( /api/langs )

• layout=bar|stacked|horizontal_list|vertical_list|grid, max_langs (1--12)
• hide_border, hide_title, custom_title, border_radius, theme overrides as above

Mini badges ( /api/mini )

• metric=stars|commits|prs|issues|hours|streak|week|followers|repos|contributions
• label (override text), color (value side), theme (for errors)
• style=flat|flat-square|for-the-badge|plastic|minimal (default flat)

Counter badge ( /api/badge )

• style=flat|flat-square|for-the-badge|plastic|minimal (default flat)

Visits badge ( /api/visits )

• style=flat|flat-square|for-the-badge|plastic|minimal (default flat)

Note: hours is currently WIP and is an estimate, not exact tracked coding time.

Sparkline ( /api/sparkline )

• days (7--90), width (180--800), height (40--240), line_color, fill_color, title, hide_border, border_radius

Default, Light, Radical, Tokyo Night, Dracula, Nord, Gruvbox, Catppuccin, Ocean, Sunset, Forest, Midnight, Night Owl, Solarized, Ayu, Rose Pine, Kanagawa, Material Palenight.

• Token needed? Yes -- the GitHub GraphQL API requires a valid token. Set GITHUB_TOKEN, GH_TOKEN, or GITHUB_ACCESS_TOKEN.
• Refresh rate? Tiered by endpoint so slower-moving badges can stay cached longer while activity-focused embeds refresh sooner.
• Free? Yes. MIT licensed.
• Where to tweak without URLs? ghstats.dev/builder.

• /api/card and activity-oriented mini badges (commits, prs, issues, streak, week, contributions) are cached for about 30 minutes at the edge.
• /api/langs, /api/badge, and slower-moving mini badges like followers and repos are cached for about 6 hours at the edge.
• stars mini badges are cached for about 24 hours at the edge.
• /api/visits is intentionally uncached so counters increment on every request.

• PRs welcome -- see CONTRIBUTING.md.
• Like it? Drop a star on the repo: GitHub.

MIT

Generate a shareable profile card for posts, portfolios, and profile pages:

https://ghstats.dev/api/profile?repo=octocat/Hello-World&theme=github&type=repo

Use the PNG endpoint for LinkedIn and other sites that require an uploaded raster image:

https://ghstats.dev/api/profile/png?username=octocat&theme=dark&type=profile&download=true

# Contribution heatmap
https://ghstats.dev/api/profile/png?username=octocat&theme=dark&type=contributions

The preset and layout registries are separate, so adding a new colour preset or card type does not require changing the API routes.