Gyazo

Gyazo API

List

The API request to get a list of a user’s saved images.

URL

GET https://api.gyazo.com/api/images

parameters

Key	Type	Required	Default	Remarks
access_token	string	✓		User's access token
page	integer		1
per_page	integer		20	1 to 100

response header

X-Total-Count:  350
X-Current-Page: 1
X-Per-Page:     20
X-User-Type:    lite

response body

[
    {
        "image_id": "8980c52421e452ac3355ca3e5cfe7a0c",
        "permalink_url": "http://gyazo.com/8980c52421e452ac3355ca3e5cfe7a0c",
        "thumb_url": "https://i.gyazo.com/thumb/afaiefnaf.png",
        "url": "https://i.gyazo.com/8980c52421e452ac3355ca3e5cfe7a0c.png",
        "type": "png",
        "created_at": "2014-05-21 14:23:10+0900",
        "metadata": {
           "app": null,
           "title": null,
           "url": null,
           "desc": ""
        },
        "ocr": {
           "locale": "en",
           "description": "Gyazo\n",
        }
    },
    {
        "image_id": "8980c52421e452ac3355ca3e5cfe7a0c",
        "permalink_url": "http://gyazo.com/8980c52421e452ac3355ca3e5cfe7a0c",
        "thumb_url": "https://i.gyazo.com/thumb/afaiefnaf.png",
        "url": "https://i.gyazo.com/8980c52421e452ac3355ca3e5cfe7a0c.png",
        "type": "png",
        "created_at": "2014-05-21 14:23:10+0900",
        "metadata": {
           "app": null,
           "title": null,
           "url": null,
           "desc": ""
        },
        "ocr": {
           "locale": null,
           "description": "",
        }
    },
    ...
]

Image

The API request to get an image.

URL

GET https://api.gyazo.com/api/images/:image_id

parameters

Key	Type	Required	Default	Remarks
access_token	string	✓		User's access token
image_id	string	✓

response body

{
  "image_id": "27a9dca98bcf5cafc0bd84a80ee9c0a1",
  "permalink_url": null,
  "thumb_url": null,
  "type": "png",
  "created_at": "2018-07-24T07:33:24.771Z",
  "metadata": {
    "app": null,
    "title": null,
    "url": null,
    "desc": ""
  },
  "ocr": {
    "locale": "en",
    "description": "Gyazo\n",
  }
}

Upload

The API request to upload an image.

NOTICE

Use multipart/form-data
Be aware that the URL is different from the other API

URL

POST https://upload.gyazo.com/api/upload

parameters

Key	Type	Required	Default	Remarks
access_token	string	✓		User's access token
imagedata	binary	✓		Don't forget to specify `filename` directive of Content-Disposition part in multipart/form-data. `filename` is required value.
access_policy	string `anyone` or `only_me`		`anyone`	You can set an access policy for images. The default value `anyone` means anyone that has the link can view the image. If you set access to `only_me` then only the user who uploads the image will be able to view it.
metadata_is_public	string 'true' or 'false'			Boolean value about publish URL and title metadata
referer_url	string			Referer site URL
app	string			Application name
title	string			Site title
desc	string			Comment
created_at	float			Image's created time, Unix time
collection_id	string			You can add image to collection which enables you to edit.

response

{
    "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"
}

Delete

The API request to delete an image.

URL

DELETE https://api.gyazo.com/api/images/:image_id

parameters

Key	Type	Required	Default	Remarks
image_id	string	✓		You can only delete your own images

response

{
   "image_id": "8980c52421e452ac3355ca3e5cfe7a0c",
   "type": "png"
}

oEmbed

This API provide image's raw URL. This API follows oEmbed. It's a format for allowing an embedded representation of a URL on third party sites.

URL

GET https://api.gyazo.com/api/oembed?url=:image_url

parameters

Key	Type	Required	Default	Remarks
url	string	✓		You can only set URL of Gyazo image page ( http://gyazo.com/XXXXXXXXXXXX )

response

{
  "version":"1.0",
  "type":"photo",
  "provider_name":"Gyazo",
  "provider_url":"https://gyazo.com",
  "url":"http://i.gyazo.com/8c9d9c8ec14dec4631b6ec77d1c85450_1.png",
  "width":617,
  "height":597
}

note

Request URL set href attribute on link tag in image page.

<link href="https://gyazo.com/api/oembed?url=http://gyazo.com/XXXXXXXXXXXX" rel="alternate" title="Screenshot by Gyazo" type="application/json+oembed" />