GET /icons (Collection Mode)
Render multiple icons into one SVG image using the name query parameter.
Route
- /icons?name=react,typescript,github
When name is present, this endpoint returns SVG content instead of JSON.
Required Query Params
| Param | Description |
|---|---|
| name | Comma-separated icon names, for example react,typescript,github |
Optional Query Params
| Param | Description |
|---|---|
| color | Comma-separated colors mapped by icon index. Unspecified icons use fallback palette colors |
| size | Size preset: small, medium, large |
| effect | Visual effect: glow, wave |
| columns | Number of columns in the grid (default: 3, max: 20) |
Basic Examples
Plain collection:
Two columns:
Size Examples
Small:
Medium:
Large:
Color Mapping Examples
Mapped colors (index by index):
Partial colors (remaining icons use fallback colors):
Effect Examples
Glow:
Wave:
Combined Example
Size + colors + glow + columns:
Curl Examples
curl "https://stats.pphat.top/icons?name=react,typescript,github" curl "https://stats.pphat.top/icons?name=react,typescript,github,tailwindcss&size=large&columns=2" curl "https://stats.pphat.top/icons?name=react,typescript,github&color=%230088CC,%233178C6,white&effect=glow" curl "https://stats.pphat.top/icons?name=react,typescript,github,tailwindcss,python,go&effect=wave&columns=3"
Error Examples
Missing name:
curl "https://stats.pphat.top/icons?size=medium"Invalid size:
curl "https://stats.pphat.top/icons?name=react,typescript&size=huge"Invalid columns:
curl "https://stats.pphat.top/icons?name=react,typescript&columns=0"Invalid effect:
curl "https://stats.pphat.top/icons?name=react,typescript&effect=bounce"Icon not found:
curl "https://stats.pphat.top/icons?name=react,not-a-real-icon"