API Documentation

API Version 1

IMGE.to API v1 allows to upload pictures as guest to IMGE.to .

API Call

Request Method

API v1 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://imge.to/api/1/(action)/

Parameters

  • key The API v1 key example Contact Us for Actual Key 1q9bca6f0a4da5c44tyvhg227a4e1e46
  • 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://imge.to/api/1/upload/?key=1q9bca6f0a4da5c44tyvhg227a4e1e46&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.

{
		"status_code": 200,
		"success": {
			"message": "image uploaded",
			"code": 200
		},
		"image": {
			"name": "example",
			"extension": "png",
			"size": 53237,
			"width": 1151,
			"height": 898,
			"date": "2019-05-17 15:32:33",
			"date_gmt": "2019-05-17 19:32:33",
			"storage_id": null,
			"description": null,
			"nsfw": "0",
			"md5": "c684350d722c956c362ab70299735830",
			"storage": "datefolder",
			"original_filename": "example.png",
			"original_exifdata": null,
			"views": "0",
			"id_encoded": "L",
			"filename": "example.png",
			"ratio": 1.2817371937639,
			"size_formatted": "52 KB",
			"mime": "image/png",
			"bits": 8,
			"channels": null,
			"url": "https://imge.to/images/2019/05/17/example.png",
			"url_viewer": "https://imge.to/i/L",
			"thumb": {
				"filename": "example.th.png",
				"name": "example.th",
				"width": 160,
				"height": 160,
				"ratio": 1,
				"size": 17848,
				"size_formatted": "17.4 KB",
				"mime": "image/png",
				"extension": "png",
				"bits": 8,
				"channels": null,
				"url": "https://imge.to/images/2019/05/17/example.th.png"
			},
			"medium": {
				"filename": "example.md.png",
				"name": "example.md",
				"width": 500,
				"height": 390,
				"ratio": 1.2820512820513,
				"size": 104448,
				"size_formatted": "102 KB",
				"mime": "image/png",
				"extension": "png",
				"bits": 8,
				"channels": null,
				"url": "https://imge.to/images/2019/05/17/example.md.png"
			},
			"views_label": "views",
			"display_url": "https://imge.to/images/2019/05/17/example.md.png",
			"how_long_ago": "moments ago"
		},
		"status_txt": "OK"
	}

Example Response (txt)

https://imge.to/images/2019/05/17/example.png

Edit or resize any image by clicking the image preview
Edit any image by touching the image preview
You can add more images from your computer or add image URLs.
You can add more images from your device, take a picture or add image URLs.
Uploading 0 이미지 (0% complete)
The queue is being uploaded, it should take just a few seconds to complete.
올려놓기 마침
Uploaded content added to . You can create a new album with the content just uploaded.
Uploaded content added to .
You can create a new album with the content just uploaded. You must create an account or sign in to save this content into your account.
No 이미지 have been uploaded
일부 오류가 발생하고 시스템이 요청을 처리 할 수​​ 없습니다.
    또는 무르기나머지도 무르기
    참고: 일부 이미지를 올려놓을 수 없었습니다. 자세히 알아보기
    자세한 내용은오류 보고서를 참고하십시오
    JPG PNG BMP GIF 200 MB