Cyber Monday Sale! Get over 30% off when you subscribe to an annual subscription plan!

Random Image API

The Random Image API generates random images for all your placeholder and design needs. It supports custom sizes as well as custom image categories.

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
254ms297ms318ms464ms932ms

Didn't find what you were looking for? Suggest an improvement

/v1/randomimage GET

https://api.api-ninjas.com/v1/randomimage

Returns a random, base64-encoded image in JPEG format.

Parameters

  • category  optionalpremium only

    Image category. If set, must be one of the following: nature, city, technology, food, still_life, abstract, wildlife.

  • width  optionalpremium only

    Width of the image to generate. Must be between 1 and 5000. Default value is 640.

  • height  optionalpremium only

    Height of the image to generate. Must be between 1 and 5000. Default value is 480.

Headers

  • X-Api-Key  required

    API Key associated with your account.

  • Accept  required

    Header indicating the content type to accept in the result. Must be set to the following: image/jpg.

Sample Request Live Demo!

https://api.api-ninjas.com/v1/randomimage

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

IMAGE

Code Examples

1 2 3 curl -X GET "https://api.api-ninjas.com/v1/randomimage?category=wildlife" \ -H "X-Api-Key: YOUR_API_KEY" \ --output random_image.jpg

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.