Back to DocumentationDocumentation

Media APIs

Endpoints for placeholder images, stock photos, SVGs, avatars, QR codes, and tracking pixels.

Base URL
https://mockly.me

Returns a default placeholder image (300×300). Supports custom dimensions, blur, and grayscale.

https://mockly.me/image/placeholder/300/200

Parameters

NameTypeDescription
widthnumberPath segment — width in pixels (1–2000)
heightnumberPath segment — height in pixels (1–2000)
blurnumberQuery param — blur amount 0–10
grayscalebooleanQuery param — convert to grayscale

Example Response

Binary PNG image (200 OK)

Returns a random stock photo from the Unsplash collection. Supports cropping, blur, and grayscale.

https://mockly.me/image/stock/400/300

Parameters

NameTypeDescription
widthnumberPath segment — crop width (1–2000)
heightnumberPath segment — crop height (1–2000)
blurnumberQuery param — blur amount 0–10
grayscalebooleanQuery param — convert to grayscale

Example Response

Binary JPEG/PNG image (200 OK)

Returns an SVG placeholder with configurable width and height.

https://mockly.me/svg?width=200&height=100

Parameters

NameTypeDescription
widthnumberQuery param — SVG width (default 100)
heightnumberQuery param — SVG height (default 100)

Example Response

SVG markup (200 OK)

Generates a professional avatar with initials. Deterministic when a name is provided.

https://mockly.me/avatar?name=John+Doe

Parameters

NameTypeDescription
sizenumberQuery param — avatar size in pixels (default 200)
namestringQuery param — name used for initials
bg_colorstringQuery param — background hex without #

Example Response

Binary PNG image (200 OK)

Generates a QR code PNG for the given text.

https://mockly.me/qr?text=Hello+World

Parameters

NameTypeDescription
textstringQuery param — content to encode (required)

Example Response

Binary PNG image (200 OK)

Returns a 1×1 transparent GIF, useful for tracking pixels and layout tests.

https://mockly.me/pixel

Example Response

Binary GIF image (200 OK)