GET/api/v1/top-langs

Top Languages Card

Generate a card showing most used programming languages as SVG image.

Parameters

usernamerequired

string

GitHub username

theme

stringdefault: default

Card theme

title_color

string

Title color (hex without #)

text_color

string

Text color (hex without #)

bg_color

string

Background color (hex without #)

border_color

string

Border color (hex without #)

hide_title

booleandefault: false

Hide card title

hide_border

booleandefault: false

Hide card border

layout

stringdefault: compact

Layout style for language display

langs_count

numberdefault: 5range: 1-20

Number of languages to show

hide

string

Comma-separated languages to hide (e.g. html,css)

exclude_repo

string

Comma-separated repos to exclude from calculation

font

stringdefault: google-sans-flex

Font family for card text

emoji_set

stringdefault: twitter

Emoji style for rendering emojis

border_radius

numberdefault: 6range: 0-50

Card border radius in pixels

refresh

booleandefault: false

Force refresh the card (bypass cache)

Caching

SVG cards are cached in Cloudflare R2 storage for optimal performance.

SVG Cache

Generated SVG cards are cached until manually refreshed using the refresh parameter

Force Refresh

Add refresh=true parameter to force regenerate the card with fresh data

Data Cache

GitHub API data is cached for 24 hours in KV storage to reduce API calls

Example

Request URL

/api/v1/top-langs?username=hehehai&layout=compact&langs_count=8

Markdown (for README)

![Top Languages Card](/api/v1/top-langs?username=hehehai&layout=compact&langs_count=8)

HTML

<img src="/api/v1/top-langs?username=hehehai&layout=compact&langs_count=8" alt="Top Languages Card" />

Preview