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

이미지 미리보기를 클릭하면
이미지를 편집하거나 사이즈를 조절할 수 있습니다.
이미지 미리보기를 탭하면
이미지를 편집하거나 사이즈를 조절할 수 있습니다.
컴퓨터이미지 URL 추가를 통해 이미지를 더 추가할 수 있습니다.
기기사진 찍기 또는 이미지 URL 추가를 통해 이미지를 더 추가할 수 있습니다.
업로드 중 0 이미지 (0% 완료)
대기열을 업로드하고 있습니다. 완료하는데 몇 초밖에 걸리지 않습니다.
업로드가 완료되었습니다
업로드한 게시물이 앨범에 추가되었습니다. 업로드된 게시물은 새 앨범 만들기를 할 수 있습니다.
업로드한 게시물이 앨범에 추가되었습니다.
업로드된 게시물은 새 앨범 만들기를 할 수 있습니다. 계정에 이 게시물을 저장하려면 계정 만들기 또는 로그인 해야 합니다.
이미지이(가) 업로드되지 않았습니다
업로드 중 일부 이미지에 오류가 발생하여 시스템이 처리하지 못했습니다.
    참고: 일부 이미지를 업로드하지 못했습니다. 더 알아보기
    자세한 내용은 오류 보고서를 참고해주세요.
    JPG PNG BMP GIF 200 MB