API Reference
REST API
SVG image endpoints you can drop directly into any Markdown file. No token, no login — just a URL.
3 endpoints
Updates every hour
No auth required
Quick Usage
Paste these into any README.md file. No authentication needed.


Parameters
| Param | Description |
|---|---|
| usernamerequired | GitHub username |
| theme | Card theme name |
| show_icons | Show stat icons |
| hide_border | Hide card border |
| hide_rank | Hide rank badge |
| hide_title | Hide card title |
| title | Custom card title text |
| card_width | Card width in pixels |
| border_radius | Border radius in pixels |
| hide | Comma-separated stats to hide: stars,commits,prs,issues,contributed,repos |
| bg_color | Background color (no #, e.g. 0d1117) |
| title_color | Title color (no #) |
| text_color | Text color (no #) |
| icon_color | Icon color (no #) |
| border_color | Border color (no #) |
| accent_color | Accent / rank color (no #) |
Example
/api/stats?username=torvalds&theme=tokyonight&show_icons=trueAuto-updating stats
All cards are cached for 1 hour with a 2-hour stale-while-revalidate window — meaning stats refresh automatically every hour. Changing any query parameter generates a fresh cache entry. No GitHub token is required for public accounts.