YourImageShare API

Free JSON/REST API for YourImageShare - a free image and video hosting platform for anonymous and registered users. Use the API to upload, list, and delete files programmatically instead of going through the browser uploader.

• Base URL: https://yourimageshare.com/api
• Auth: an API key, sent as an X-API-Key header (preferred) or ?key= fallback
• Format: JSON in and out, except uploads which are multipart/form-data
• Full reference: API.md
• Live docs: yourimageshare.com/about/api
• Postman collection: YourImageShare-API.postman_collection.json

Get an API key

Sign in to your account and open the API tab. Your key is shown there, along with a Regenerate button.

That tab also has a separate, scoped Upload-only key - use that one instead anywhere the key ends up in something other people can see (a forum plugin's page-source snippet, a public config file), since it can only upload and not list/delete. See Upload-only key in the full reference. The forum plugins below already use it.

Quick example

curl "https://yourimageshare.com/api" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "uploads=@/path/to/photo.jpg"

{
  "type": "success",
  "msg": "success",
  "data": {
    "id": "aB3xY9qRz1",
    "type": "image",
    "path": "https://i.yourimageshare.com/aB3xY9qRz1.webp",
    "src": "https://yourimageshare.com/ib/aB3xY9qRz1.webp",
    "direct": "https://yourimageshare.com/ib/aB3xY9qRz1"
  }
}

Endpoints

Full request/response shapes, rate limits, error codes, and code samples in curl, JavaScript, Python, PHP, and Go are in API.md.

Client libraries

Three official SDKs, so you don't have to hand-roll the HTTP calls, plus a Discord bot built on top of one of them - source for all four lives in this repo:

• JavaScript/TypeScript: yourimageshare on npm - npm install yourimageshare. Zero dependencies, works in Node.js and browsers. Source: /js.
• Python: yourimageshare on PyPI - pip install yourimageshare. One dependency (requests), Python 3.8+. Source: /python.
• MCP server (for AI coding agents - Claude Code, Cursor, and other MCP-compatible clients): yourimageshare-mcp on npm - npx yourimageshare-mcp, no install step. Also listed on Smithery and Glama. Source: /mcp.
• Discord bot: /upload file:<attachment> slash command, built on the JS SDK. Self-hosted - run your own instance with your own bot token, same model as the ShareX/Flameshot integrations below, not a public bot we run. Source: /discord.

The three SDKs wrap the same three endpoints below (upload/list/delete) with typed results and a proper exception on API errors instead of raw HTTP handling, and are MIT licensed.

No official library for your language? The full HTTP reference covers everything needed to call the API directly.

Expiring uploads

Pass expires_in (seconds, 60 to 2,592,000) on upload to auto-delete a file later - the storage object is removed and the page starts 410ing within about 5 minutes of expiry. Omit it for a normal, permanent upload.

curl "https://yourimageshare.com/api" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "uploads=@/path/to/photo.jpg" \
  -F "expires_in=3600"

Screenshot tools

Ready-made configs/scripts to upload straight from a screenshot tool, no browser tab required:

• YourImageShare.sxcu - ShareX custom uploader
• yis-flameshot-upload.sh - Flameshot (Linux)
• yis-greenshot-upload.ps1 - Greenshot (Windows)

Setup instructions are in the comments at the top of each file, and on the live docs page.

Forum plugins

A real "Upload Image" button next to your forum's post editor - each one uploads through /api and inserts BBCode at your cursor. All six are configured with your Upload-only key (not your main API key), since the key renders in every visitor's page source and the upload-only key can only upload on your behalf - see Upload-only key.

• phpbb/ - a real phpBB 3.2/3.3 extension (download)
• smf/ - a real SMF package (download)
• mybb/ - a real MyBB 1.8 plugin (download)
• fluxbb/, punbb/, zetaboards/ - these three don't have a formal plugin system, so it's a small copy-paste snippet into your template/Admin CP instead

All six share one underlying widget, forum-upload.js (also served live from yourimageshare.com/assets/js/forum-upload.js), so fixes/improvements apply everywhere at once. Full setup instructions and downloads are also on the live docs page.

Rate limits

Each API key gets 20 requests/minute and 500 requests/day by default, plus a 2,000/day ceiling per IP address as a backstop. Every response includes X-RateLimit-Limit/X-RateLimit-Remaining headers; a 429 includes Retry-After.

Support

Questions or issues: yourimageshare.com/contact.