/placeholder and /placeholder/url
Downloadable placeholder images with caching.
Methods
GET
Endpoints
/placeholderreturns a binary image./placeholder/urlreturns a plain text image URL.
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
q |
string | yes | Image keyword (for example: mountain). |
page |
integer | no | Pagination page (default 1, minimum 1). |
Behavior
- Uses the same image fallback chain as
/images. -
Downloads and caches images in
placeholders/by SHA1 hash. - If no image is found, serves
static/not-found.png. - If
qis missing, renders the placeholder help page.
Examples
GET /placeholder?q=mountain
GET /placeholder/url?q=mountain