nPlaceholder

The fastest, most reliable placeholder image service

API Documentation

What is nPlaceholder?

nPlaceholder is a free image placeholder service that allows you to generate custom placeholder images on the fly. Simply include an image URL in your HTML, and we'll generate the perfect placeholder for your design.

How to use our placeholders

Just add the image URL to your HTML. The basic format is:

https://via.nplaceholder.com/300x200

This will generate a 300x200 pixel placeholder image.

Example 300x200 placeholder

Defining image size

You can specify the width and height of your placeholder image:

https://via.nplaceholder.com/600x400

Generates a 600x400 image

https://via.nplaceholder.com/300

Generates a 300x300 square image

Supported formats

We support multiple image formats. Just add the extension to the URL:

https://via.nplaceholder.com/300x200.png
https://via.nplaceholder.com/300x200.jpg
https://via.nplaceholder.com/300x200.webp

Supported formats: PNG, JPG/JPEG, WEBP, GIF

Custom text

Add custom text to your placeholder by appending it to the URL:

https://via.nplaceholder.com/300x200?text=Hello+World
https://via.nplaceholder.com/300x200/Hello+World

Both formats are supported. Use + or %20 for spaces.

Background and text colors

Customize the background and text colors using hex codes (without the #):

https://via.nplaceholder.com/300x200/FF0000/FFFFFF

Red background with white text

https://via.nplaceholder.com/300x200/0000FF/FFFF00?text=Custom

Blue background with yellow text and custom text

WEBP support

We fully support the modern WEBP format for optimized file sizes:

https://via.nplaceholder.com/300x200.webp

HTTPS

All images are served over HTTPS by default for secure delivery.

About Us

nPlaceholder was born as the successor to the classic placeholder.com, a service beloved by developers and designers worldwide. We preserve the simplicity and ease of use that made the original so popular, while bringing modern improvements in performance, reliability, and features.

100% API compatible with placeholder.com — migrating is as simple as adding an "n" to your existing URLs. Change placeholder.com to nplaceholder.com and you're done!

Our mission is simple: provide the fastest, most reliable placeholder image service with a clean API that just works. No registration, no API keys, no complications—just add the URL and go.

Frequently Asked Questions

Is nPlaceholder free to use?

Yes! nPlaceholder is completely free to use for any project, commercial or personal.

Do I need an API key?

No API key required. Just use the URL format and start generating images immediately.

Are there any rate limits?

Yes, to ensure fair usage for everyone, we have the following limits:

  • Rate limit: 60 requests per minute per IP
  • Maximum image size: 3000×3000 pixels
  • Maximum area: 9,000,000 pixels total
  • Text length: Up to 200 characters

These limits are generous for normal usage. For high-volume needs, please contact us.

Can I use this in production?

Absolutely! Our service is designed for production use with high availability and CDN delivery.

What happened to placeholder.com?

nPlaceholder was created to continue the legacy of placeholder.com with improved infrastructure and modern features, while maintaining full API compatibility.