How to Use AnyPlaceholder.com
AnyPlaceholder.com lets designers and developers create custom placeholder images and text on-the-fly. You can use our browser UI or call the simple REST APIs directly from your code.
1. Using the Web UI
- Open the Image Generator or Text Generator.
- Adjust the parameters to your needs.
- Copy the generated URL or download/copy the result.
2. Using the HTTP API
Make a GET request to /placeholder with the query parameters below.
| Parameter | Required | Description | Example |
|---|---|---|---|
| width | Yes | Image width (px) | 300 |
| height | Yes | Image height (px) | 200 |
| bg | No | Background color (hex, no #). For 4 or 8 digits, the last digit(s) represent alpha value (0-f, 00-ff) | 09f or 0099ff or 09f8 (semi-transparent) |
| color | No | Text color (hex, no #). For 4 or 8 digits, the last digit(s) represent alpha value (0-f, 00-ff) | fff or fffc (semi-transparent) |
| text | No | Custom text. Defaults to "{width}x{height}" | Hello |
| fontSize | No | Font size (px) | 24 |
| radius | No | Corner radius (px) | 8 |
| format | No | Output format: svg (default) / png / jpg / webp | png |
| retina | No | If set to 1, creates a @2x image | 1 |
Example
https://anyplaceholder.com/placeholder?width=400&height=300&bg=333&color=fff&text=Demo&format=png3. Text Placeholder API
Make a GET request to /text with the query parameters below.
| Parameter | Required | Description | Example |
|---|---|---|---|
| paragraphs | No | Number of paragraphs (1-50, default 3) | 5 |
| sentences | No | Sentences per paragraph (1-15, default 5) | 3 |
| format | No | Output format: text (default) / html / json | json |
| lang | No | Language: en (default) / ja | ja |
Examples
https://anyplaceholder.com/text?paragraphs=3&sentences=5
https://anyplaceholder.com/text?paragraphs=2&format=html&lang=ja
https://anyplaceholder.com/text?paragraphs=1&sentences=3&format=json4. Avatar API
Make a GET request to /api/avatar to generate an avatar image from the text you provide.
| Parameter | Required | Description | Example |
|---|---|---|---|
| text | No | Text shown as-is, max 12 characters (default "AP") | JD |
| size | No | Image size in px (16-1000, default 128) | 128 |
| shape | No | Avatar shape: circle (default) / square | circle |
| bg | No | Background color (hex, no #). Defaults to a color auto-derived from the text | 4f46e5 |
| color | No | Text color (hex, no #, default fff) | fff |
| format | No | Output format: svg (default) / png | png |
Example
https://anyplaceholder.com/api/avatar?text=JD&size=128&shape=circle&format=png5. Dummy Data API
Make a GET request to /api/data to generate dummy data as JSON or CSV.
| Parameter | Required | Description | Example |
|---|---|---|---|
| type | No | Dataset type: users (default) / posts / todos / products | users |
| count | No | Number of records (1-100, default 10) | 10 |
| lang | No | Language: en (default) / ja | ja |
| format | No | Output format: json (default) / csv | json |
| seed | No | Seed for deterministic output (default 1) | 1 |
Example
https://anyplaceholder.com/api/data?type=users&count=10&lang=ja&format=json6. Chart API
Make a GET request to /api/chart to generate a bar, line, or pie chart image.
| Parameter | Required | Description | Example |
|---|---|---|---|
| type | No | Chart type: bar (default) / line / pie | bar |
| points | No | Number of data points (2-20, default 6) | 8 |
| width | No | Image width in px (100-2000, default 600) | 600 |
| height | No | Image height in px (100-2000, default 400) | 400 |
| seed | No | Seed for deterministic output (default 1) | 1 |
| title | No | Chart title (optional) | Sales |
| format | No | Output format: svg (default) / png. PNG output is capped at 1000px to stay within size limits | svg |
Example
https://anyplaceholder.com/api/chart?type=bar&points=8&title=Sales&format=svg7. PDF API
Make a GET request to /api/pdf to generate a multi-page dummy PDF.
| Parameter | Required | Description | Example |
|---|---|---|---|
| pages | No | Number of pages (1-20, default 1) | 3 |
| title | No | Document title (default "Dummy PDF"). ASCII/Latin characters only — the built-in Helvetica font cannot embed Japanese | Sample |
Note: The title supports ASCII/Latin characters only. The built-in Helvetica font cannot embed Japanese (or other non-Latin) characters.
Example
https://anyplaceholder.com/api/pdf?pages=3&title=Sample8. Map API
Make a GET request to /api/map to generate an image of a fictional city. Maps are pre-rendered in 10 visual styles and resized to your requested dimensions on the fly.
| Parameter | Required | Description | Example |
|---|---|---|---|
| width | No | Image width in px (100-2000, default 600) | 800 |
| height | No | Image height in px (100-2000, default 400) | 600 |
| seed | No | Seed for deterministic output — picks one of 50 fictional cities per style (default 1) | 42 |
| scheme | No | Visual style. Omit to auto-pick from the seed. One of: Default, Apple, AppleDark, Assassin, Google, GoogleNoZoom, Paper, SubtleGrey, UltraLight, Wy | Apple |
| format | No | Output format: jpg (default, smallest) / webp / png | jpg |
This map is decorative only — every city is fictional and does not represent any real location.
Example
https://anyplaceholder.com/api/map?width=800&height=600&seed=42&scheme=AppleMap images are pre-generated with ProbableTrain's MapGenerator (LGPL-3.0 / GPL-3.0).
9. Notes for All Endpoints
A few things that apply to every API above:
- All endpoints are deterministic: the same URL always returns the same output, and responses are cached for 24 hours.
- Responses include CORS headers (
Access-Control-Allow-Origin: *), so you can call them directly from the browser. - Each generated response stays within a 40 KB limit.
10. Attribution / License
Generated images are free to use, even in commercial projects. No attribution required, but a backlink is appreciated.
11. Need Help?
Contact us on X (Twitter) @_Kit_Ok_ or use the Buy Me a Coffee link below.