Generate placeholder images and icons on the fly. Simple, fast, and customizable.
Generate placeholder images of any size with customizable colors, text, and format.
GET /v1/image/{width}x{height}| Param | Type | Default | Description |
|---|---|---|---|
bg | hex | cccccc | Background color |
fg | hex | 888888 | Text & border color |
border | float | 0.05 | Border ratio (0-0.5) |
text | string | WxH | Custom text |
size | int | auto | Font size in pixels |
format | string | png | png, jpg, or svg |
Square icon placeholders with optional shapes.
GET /v1/icon/{size}| Param | Type | Default | Description |
|---|---|---|---|
bg | hex | cccccc | Background color |
fg | hex | 888888 | Icon color |
shape | string | square | square, circle, or rounded |
format | string | png | png or jpg |
Grid layouts for dashboard mockups and galleries.
GET /v1/grid/{width}x{height}| Param | Type | Default | Description |
|---|---|---|---|
cols | int | 3 | Number of columns (1-20) |
rows | int | 3 | Number of rows (1-20) |
gap | int | 8 | Gap between cells in pixels |
bg | hex | cccccc | Background color |
fg | hex | 888888 | Cell color |
format | string | png | png or jpg |
Video poster placeholders with play button and duration.
GET /v1/video/{width}x{height}| Param | Type | Default | Description |
|---|---|---|---|
duration | string | 0:00 | Duration (M:SS or MM:SS) |
bg | hex | cccccc | Background color |
fg | hex | 888888 | Foreground color |
format | string | png | png or jpg |
Audio placeholders with waveform visualization.
GET /v1/audio/{width}x{height}Document thumbnail placeholders.
GET /v1/doc/{width}x{height}| Param | Type | Default | Description |
|---|---|---|---|
type | string | generic | pdf, doc, xls, or generic |
pages | int | - | Number of pages (optional) |
bg | hex | cccccc | Background color |
fg | hex | 888888 | Foreground color |
Generate fake JSON data for prototypes and testing.
GET /v1/json| Param | Type | Default | Description |
|---|---|---|---|
schema | string | user | user, post, product, comment, todo, company |
count | int | 10 | Number of items (1-100) |
seed | int | - | Seed for deterministic output |
[{"id": 1, "name": "...", "email": "..."}, ...][{"id": 1, "name": "...", "price": 99.99, ...}, ...]Available schemas: user, post, product, comment, todo, company
HTML skeleton loading screens for SPAs.
GET /v1/skeleton| Param | Type | Default | Description |
|---|---|---|---|
variant | string | card | card, list, table, form, profile |
count | int | 1 | Number of skeleton items (1-10) |
animated | bool | true | Include shimmer animation |
Returns HTML with card skeleton screens
Returns HTML with list skeleton screens
Returns HTML with table skeleton (4 rows)
Available variants: card, list, table, form, profile
Use these in your HTML:
<img src="http://goosegoosego.nl/v1/image/800x400" alt="Placeholder">
<img src="http://goosegoosego.nl/v1/icon/32?shape=circle" alt="Avatar">/_metrics | API usage metrics (JSON) |
/_docs | This page (also available at /) |