Placeholder as a Service

Placehold Image API

Deliver deterministic, design-ready placeholders from a curated dataset. Point your mocks at a single API endpoint and control size, format, keywords, and placement without hosting extra infrastructure.

Base endpoint

https://img.pixo.page

GET https://img.pixo.page/{category?}/{tags?}/{dimensions?}.{format?}

Mix path segments and query parameters (`?w=1200&h=800`) as needed. Non-HTML clients receive an image response by default.

Example endpoints

Drop these URLs straight into Figma, docs, or tests. Each card renders a live preview.

Highlights

  • Placement-aware selections

    Combine categories, tags, and a placement key to lock designs to one deterministic variant.

  • Format negotiation

    Request explicit `.avif`, `.webp`, `.png`, or rely on the Accept header to choose the best format automatically.

  • Zero-setup caching

    Derivatives are cached on disk and returned with strong validators for CDN and browser reuse.

  • Keyword discovery API

    Use `/api/keywords` to retrieve available categories, tags, and placement-ready keywords for your frontend search.

Key parameters

  • dimensions

    Embed `1200x800` (or a single `512`) in the path, or pass `?w=&h=` query parameters.

  • format

    Suffix the URL with an extension or send `?format=webp` / `?f=avif`; otherwise the server negotiates from `Accept`.

  • tags & keywords

    Stack extra path segments or pass `?tags=night,aurora` to narrow the dataset to relevant imagery.

  • placement or seed

    Keep layouts stable by providing `placement=hero` or `seed=welcome-card`—results persist across refreshes.

Response insights

  • Transparent headers

    `X-Placeholder-Id`, `X-Placeholder-Dimensions`, and `X-Placeholder-Format` clarify the chosen variant.

  • Helpful fallbacks

    Unmatched filters respond with an SVG diagnostic that lists the inferred dimensions and reason.

  • Cache friendly

    `ETag` and `Last-Modified` let clients revalidate warmed assets without re-downloading.

Need more? Browse the full documentation at /docs or inspect the dataset manifest endpoints.