API Documentation

Our API currently allow you to upload images as guest. A new version of the API is currently under development and will be released as soon as possible !

API Call

Request Method

API calls can be done using the POST or GET request methods but since GET request are limited by the maximum allowed length of an URL you should prefer the POST request method.

Request URL

https://imgfly.me/api/1/(action)/ (if this doesn't work, try removing the slash '/' at the end)

Parameters

  • key The API v1 key is c6133147592983996b65dda51ba70255
  • action What you want to do [values: upload].
  • source Either a image URL or a base64 encoded image string. You can also use FILES["source"] in your request.
  • format Sets the return format [values: json (default), redirect, txt].

Example Call

GET https://imgfly.me/api/1/upload/?key=c6133147592983996b65dda51ba70255&source=http://somewebsite/someimage.jpg&format=json

Note: Always use POST when uploading local files. Url encoding may alter the base64 source due to encoded characters or just by URL request length limit due to GET request.

API Response

API v1 responses will vary depending on the format parameter:

  • json Display all the image uploaded information in JSON format. [default]
  • txt Returns the image direct URL in text/plain format.
  • redirect Redirects to the image viewer URL.

When using JSON the response will have headers status codes to allow you to easily notice if the request was OK or not. It will also output the status_txt and status_code properties.

Example Response (JSON)

Example Response (txt)

http://127.0.0.1/images/2014/06/04/example.png

Edit or resize any image by clicking the image preview
Edit or resize any image by touching the image preview
You can keep adding more images from your computer or from image URLs.
You can keep adding more images from your device or from image URLs.
Uploading 0 image (0% complete)
The queue is being uploaded, it should take just a few seconds to complete.
Upload complete
Uploaded content added to . You can create a new album with the content just uploaded.
Uploaded content added to .
You can create an account or sign in to save this content into your account.
No image have been uploaded
Some errors have occured and the system couldn't process your request.
    or cancelcancel remaining
    Note: Some images couldn't be uploaded. learn more
    Check the error report for more information.
    JPG PNG BMP GIF max 100 MB