Overview

Gyazo is a screenshot hosting API that accepts an image upload and returns a permanent shareable URL with associated metadata like capture time and application info. It specializes in screen captures, making it easy to share visual content via a short link without managing your own image storage. Developers use it to automate screenshot archiving, build visual feedback tools, or create screenshot-sharing bots.

💡

Beginner Tip

Get a free API access token from gyazo.com/oauth/applications by registering an app with any redirect URI. Uploads require multipart/form-data with the image sent as the "imagedata" field — test with a PNG screenshot first.

Available Data

stock price and symbol
open/close/high/low values
trading volume
market cap
historical price data

Example Response

JSON Response
{
  "file_id": "f_abc123",
  "filename": "document.pdf",
  "size_bytes": 1048576,
  "mime_type": "application/pdf",
  "download_url": "https://example.com/files/f_abc123",
  "created_at": "2025-01-15T10:00:00Z"
}

Field Reference

image_id Unique identifier for the uploaded image, used to retrieve or delete it via the API
permalink_url Public URL of the Gyazo page where the image can be viewed and shared
url Direct URL to the raw image file (PNG or GIF), suitable for embedding in HTML or Markdown
created_at ISO 8601 timestamp when the screenshot was uploaded to Gyazo
type Image format type such as png or gif indicating how the capture was stored

Implementation Example

// ⚠️ Note: This URL may be a documentation page. Check official docs for actual API endpoint.
const url = "https://gyazo.com/api/docs";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "X-API-Key": "YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

401 Unauthorized Missing or expired Gyazo access token in the Authorization header
Pass the token as "Authorization: Bearer YOUR_ACCESS_TOKEN" in every request header
400 Bad Request on upload The image was not sent as proper multipart/form-data with the field name imagedata
Use -F "[email protected]" with curl, or ensure your HTTP client sets the correct multipart content-type
429 Too Many Requests Exceeded the rate limit for the free tier
The free plan allows limited uploads per hour; add delays between uploads or upgrade to Gyazo Teams for higher limits

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 15/20
🔒 Security 15/15
🛠 Developer XP 12/20
✓ Reliability 10/15

Partially tested on Apr 5, 2026

Technical Specifications

Auth API Key
HTTPS REQUIRED
CORS UNKNOWN
Difficulty Intermediate
Verified: 2026-04-04

Similar APIs

View All →