API version 1

Imgbb's API v1 allows you to upload images.

Request method

API v1 calls can be made using the POST or GET request methods, but since GET requests are limited by the maximum allowed URL length, you should prefer the POST method.

Image Upload


Parameters

The API key.
A binary file, base64 data, or an image URL (up to 32 MB).
The name of the file; this is automatically detected if you upload a file using POST and multipart/form-data.
Enable this if you want uploads to be automatically deleted after a certain time (in seconds, 60-15552000).

Example call

Note: Always use POST when uploading local files. URL encoding may alter the base64 source due to encoded characters or simply because of the URL length limit when using GET.

API response

API v1 responses display all uploaded image information in JSON format.

In the JSON response, the headers will include status codes to let you easily determine whether the request was OK. It will also include the status property.

Example response (JSON)