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.

![GitHub Stats](https://yoursite.com/api/stats?username=YOUR_USERNAME&theme=tokyonight)

![Top Languages](https://yoursite.com/api/top-langs?username=YOUR_USERNAME&layout=compact)

![Repo Card](https://yoursite.com/api/repo?owner=YOUR_USERNAME&repo=YOUR_REPO)

Parameters

ParamDescription
usernamerequiredGitHub username
themeCard theme name
show_iconsShow stat icons
hide_borderHide card border
hide_rankHide rank badge
hide_titleHide card title
titleCustom card title text
card_widthCard width in pixels
border_radiusBorder radius in pixels
hideComma-separated stats to hide: stars,commits,prs,issues,contributed,repos
bg_colorBackground color (no #, e.g. 0d1117)
title_colorTitle color (no #)
text_colorText color (no #)
icon_colorIcon color (no #)
border_colorBorder color (no #)
accent_colorAccent / rank color (no #)

Example

/api/stats?username=torvalds&theme=tokyonight&show_icons=true

Auto-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.