Gyazo API

Name: Gyazo API
Brand: Gyazo API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentMediaImage Processingbearer5 EndpointsREST

For Agents

Upload, list, search, retrieve, and delete screenshots and images in a Gyazo user library through five REST endpoints.

Install Jentic One Beta

Connect the Gyazo API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Gyazo API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Gyazo API.

Upload an image to a Gyazo user account and receive the public share URL

List the authenticated user's image library with pagination

Retrieve a single image record by image ID

Search a user's images by query string

GET STARTED

Start building with Gyazo API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Gyazo API for, with concrete tasks.

★ Automated screenshot capture pipeline

Capture screenshots from a desktop or browser-automation flow and post them to Gyazo to obtain a shareable URL for embedding in support tickets, bug reports, or release notes. The upload endpoint accepts the binary file and returns the canonical permalink, which downstream systems then store on the bug record.

POST /api/upload with the screenshot file and store the returned permalink on the matching ticket record.

Personal image library audit

List the authenticated user's Gyazo library to audit historical screenshots — for example before changing employer or cleaning up sensitive captures. The list and search endpoints support pagination and query filtering, and the delete endpoint removes images that should no longer be public.

GET /api/images with paging, filter the results by capture date, and DELETE matching image IDs after user approval.

Knowledge-base screenshot ingestion

A documentation tool searches an author's Gyazo account for the relevant screenshots when generating a knowledge-base article and embeds them by permalink. The search endpoint returns image IDs and URLs that the doc tool inserts into the article body without manual download and re-upload.

GET /api/search with query 'login screen' and embed the top three results into the article draft.

AI agent screenshot helper via Jentic

An AI assistant captures a UI screenshot during a tutorial-creation flow, uploads it to Gyazo, and inserts the returned permalink into the generated tutorial markdown. Through Jentic the agent calls the upload endpoint without managing the SDK.

Search Jentic for 'upload a screenshot to gyazo', load POST /api/upload, and execute with the captured image bytes.

Key Endpoints

5 endpoints — jentic publishes the only available openapi specification for gyazo api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

GET

/api/images

List user's images

GET

/api/images/{image_id}

Get image by ID

DELETE

/api/images/{image_id}

Delete an image

POST

/api/upload

Upload an image

GET

/api/search

Search images

GET

/api/images

List user's images

GET

/api/images/{image_id}

Get image by ID

DELETE

/api/images/{image_id}

Delete an image

POST

/api/upload

Upload an image

GET

/api/search

Search images

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Gyazo bearer access tokens are stored encrypted in the Jentic vault. Agents receive scoped execution access only — the user's access token is never exposed in the agent's prompt or tool input.

Intent-based discovery

Agents search Jentic by intent (e.g., 'upload a screenshot to gyazo') and Jentic returns the matching upload operation with its input schema, including the image-file field.

Time to first call

Direct integration: a few hours to wire the five endpoints with auth and pagination. Through Jentic: 15-20 minutes — search, load, execute.

FAQs

Specific to using Gyazo API through Jentic.

Why is there no official OpenAPI spec for Gyazo API?

Gyazo does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Gyazo API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the Gyazo API use?

Gyazo uses HTTP bearer authentication with an access token issued from the user's Gyazo account. Pass it as Authorization: Bearer <token>. Through Jentic, the token is stored encrypted in the vault and only scoped tokens are passed to the executing agent.

Can I upload a screenshot programmatically with the Gyazo API?

Yes. POST /api/upload accepts the image file and returns the canonical permalink for the new image record. This is the same endpoint the Gyazo desktop client uses internally.

Can I search my Gyazo library by query with the Gyazo API?

Yes. GET /api/search returns image records that match the query string, scoped to the authenticated user's library. Combine it with GET /api/images for paginated browsing of the full library.

What are the rate limits for the Gyazo API?

Gyazo applies user-account rate limits typically measured in tens of requests per minute on the free tier with higher limits for paid plans. Back off on 429 responses and avoid bulk-deleting an entire library in one tight loop.

How do I upload a screenshot through the Gyazo API via Jentic?

Search Jentic for 'upload a screenshot to gyazo', load the POST /api/upload operation, then execute with the image bytes. Install with pip install jentic.

Gyazo API

Connect the Gyazo API to your agent

Capabilities

Start building with Gyazo API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs