Holdicon API Documentation

Usage Guide

Create custom placeholder images with our powerful Holdicon API. Here's how to get started:


                            GET https://placehold.cloud/h

This API generates customizable placeholder images with optional text, icons, or animal shapes.

Parameter	Type	Default	Description
seed	string	''	Seed for consistent random generation
width	integer	128	Width of the image in pixels
height	integer	128	Height of the image in pixels
background_color	string	Random	Hexadecimal color code for background
text_color	string	Contrast color	Hexadecimal color code for text
text	string	Random 2 letters	Text to display on the image
robot	boolean	false	Generate a robot icon
cat	boolean	false	Generate a cat icon
dog	boolean	false	Generate a dog icon

Generate a 200x200 image with red background and white text "AB":


                            https://placehold.cloud/h?width=200&height=200&background_color=FF0000&text_color=FFFFFF&text=AB

Generate a 150x150 robot icon with default colors:


                            https://placehold.cloud/h?width=150&height=150&robot=true

Generate a 180x180 cat icon with custom colors:


                            https://placehold.cloud/h?width=180&height=180&cat=true&background_color=00FF00&text_color=000000

Generate a 200x200 dog icon with custom colors:


                            https://placehold.cloud/h?width=200&height=200&dog=true&background_color=0000FF&text_color=FFFFFF

The API returns a PNG image.

This endpoint is rate-limited to 120 requests per minute.