Overview

The Gyazo API can be used in a wide array of apps to upload new images, show a Gyazo user’s images, and more. It provides a RESTful API for HTTP requests and returns a response in JSON. This should be familiar to anyone who has used major APIs before such as Amazon S3 and Twitter.

Sample

$ curl -i https://upload.gyazo.com/api/upload -F "access_token=YOUR_ACCESS_TOKEN" \
  -F "imagedata=@/home/gyazo/greaetpicture.png"

HTTP/1.1 200 OK

{
    "image_id" : "8980c52421e452ac3355ca3e5cfe7a0c",
    "permalink_url": "http://gyazo.com/8980c52421e452ac3355ca3e5cfe7a0c",
    "thumb_url" : "https://i.gyazo.com/thumb/180/afaiefnaf.png",
    "url" : "https://i.gyazo.com/8980c52421e452ac3355ca3e5cfe7a0c.png",
    "type": "png"
}

API Endpoint

API endpoint is below.

https://api.gyazo.com
https://upload.gyazo.com    (Upload API)

The endpoint has a different Upload API than the others.


Timestamp

Timestamp is in the following format:

YYYY-MM-DDTHH:MM:SSZ

Policy

If your app continuously uploads illegal or inappropriate images, or puts excessive strain on our servers we may be forced to block access.