{
  "markdown": "# YourImageShare API\n\n[![smithery badge](https://smithery.ai/badge/team-54m5/yourimageshare)](https://smithery.ai/servers/team-54m5/yourimageshare)\n[![yourimageshare MCP server](https://glama.ai/mcp/servers/MediaShareORG/yourimageshare/badges/card.svg)](https://glama.ai/mcp/servers/MediaShareORG/yourimageshare)\n\nFree JSON/REST API for [YourImageShare](https://yourimageshare.com) - a free\nimage and video hosting platform for anonymous and registered users. Use the\nAPI to upload, list, and delete files programmatically instead of going\nthrough the browser uploader.\n\n- **Base URL:** `https://yourimageshare.com/api`\n- **Auth:** an API key, sent as an `X-API-Key` header (preferred) or `?key=` fallback\n- **Format:** JSON in and out, except uploads which are `multipart/form-data`\n- **Full reference:** [API.md](API.md)\n- **Live docs:** [yourimageshare.com/about/api](https://yourimageshare.com/about/api)\n- **Postman collection:** [YourImageShare-API.postman_collection.json](YourImageShare-API.postman_collection.json)\n\n## Get an API key\n\nSign in to your [account](https://yourimageshare.com/my-account) and open\nthe **API** tab. Your key is shown there, along with a **Regenerate**\nbutton.\n\nThat tab also has a separate, scoped **Upload-only key** - use that one\ninstead anywhere the key ends up in something other people can see (a\nforum plugin's page-source snippet, a public config file), since it can\nonly upload and not list/delete. See [Upload-only key](API.md#upload-only-key)\nin the full reference. The [forum plugins](#forum-plugins) below already\nuse it.\n\n## Quick example\n\n```bash\ncurl \"https://yourimageshare.com/api\" \\\n  -H \"X-API-Key: YOUR_API_KEY\" \\\n  -F \"uploads=@/path/to/photo.jpg\"\n```\n\n```json\n{\n  \"type\": \"success\",\n  \"msg\": \"success\",\n  \"data\": {\n    \"id\": \"aB3xY9qRz1\",\n    \"type\": \"image\",\n    \"path\": \"https://i.yourimageshare.com/aB3xY9qRz1.webp\",\n    \"src\": \"https://yourimageshare.com/ib/aB3xY9qRz1.webp\",\n    \"direct\": \"https://yourimageshare.com/ib/aB3xY9qRz1\"\n  }\n}\n```\n\n## Endpoints\n\n| Method | Path | Description |\n|---|---|---|\n| `POST` | `/api` | Upload a file |\n| `GET` | `/api` | List your uploads (paginated) |\n| `DELETE` | `/api/{id}` | Delete one of your uploads |\n\nFull request/response shapes, rate limits, error codes, and code samples in\ncurl, JavaScript, Python, PHP, and Go are in [API.md](API.md).\n\n## Client libraries\n\nTen official SDKs (across nine languages/runtimes, JS/TS counted once with\ntwo registries), so you don't have to hand-roll the HTTP calls, plus a\nDiscord bot built on top of one of them:\n\n- **JavaScript/TypeScript:** [`yourimageshare`](https://www.npmjs.com/package/yourimageshare) on npm - `npm install yourimageshare`. Also on [JSR](https://jsr.io/@yourimageshare/yourimageshare) as `@yourimageshare/yourimageshare` - `npx jsr add @yourimageshare/yourimageshare`, same source, published as TypeScript directly. Zero dependencies, works in Node.js and browsers. Source: [/js](js).\n- **Python:** [`yourimageshare`](https://pypi.org/project/yourimageshare/) on PyPI - `pip install yourimageshare`. One dependency (`requests`), Python 3.8+. Source: [/python](python).\n- **PHP:** [`yourimageshare/yourimageshare-php`](https://packagist.org/packages/yourimageshare/yourimageshare-php) on Packagist - `composer require yourimageshare/yourimageshare-php`. Zero Composer dependencies (uses PHP's own `curl` extension), PHP 7.4+. Own repo ([MediaShareORG/yourimageshare-php](https://github.com/MediaShareORG/yourimageshare-php)) - Packagist requires a root-level `composer.json`, not a monorepo subdirectory.\n- **Go:** [`github.com/MediaShareORG/yourimageshare/go`](https://pkg.go.dev/github.com/MediaShareORG/yourimageshare/go) - `go get github.com/MediaShareORG/yourimageshare/go`. Zero dependencies (standard library only), Go 1.18+. Source: [/go](go).\n- **Rust:** [`yourimageshare`](https://crates.io/crates/yourimageshare) on crates.io - `cargo add yourimageshare`. Two dependencies (`ureq`, blocking/no async runtime, plus `serde`), Rust 1.70+. Source: [/rust](rust).\n- **Ruby:** [`yourimageshare`](https://rubygems.org/gems/yourimageshare) on RubyGems - `gem install yourimageshare`. Zero gem dependencies (stdlib `Net::HTTP` + `json`), Ruby 2.7+. Source: [/ruby](ruby).\n- **.NET:** [`YourImageShare`](https://www.nuget.org/packages/YourImageShare) on NuGet (pending first publish) - `dotnet add package YourImageShare`. One dependency (Microsoft's own `System.Text.Json`), targets netstandard2.0 (.NET Framework and modern .NET both). Source: [/dotnet](dotnet).\n- **Dart/Flutter:** [`yourimageshare`](https://pub.dev/packages/yourimageshare) on pub.dev (pending first publish) - `dart pub add yourimageshare`. One dependency (`http`, the Dart team's own package), Dart 2.17+. Source: [/dart](dart).\n- **Elixir:** [`yourimageshare`](https://hex.pm/packages/yourimageshare) on Hex.pm - add `{:yourimageshare, \"~> 1.0\"}` to `mix.exs`. One dependency (`Req`), Elixir 1.14+. Returns `{:ok, result} | {:error, reason}` tagged tuples (the direct equivalent of Go's return style) plus bang variants that raise. Docs: [hexdocs.pm/yourimageshare](https://yourimageshare.hexdocs.pm). Source: [/elixir](elixir).\n- **MCP server** (for AI coding agents - Claude Code, Cursor, and other MCP-compatible clients): [`yourimageshare-mcp`](https://www.npmjs.com/package/yourimageshare-mcp) on npm - `npx yourimageshare-mcp`, no install step. Also listed on [Smithery](https://smithery.ai/servers/team-54m5/yourimageshare) and [Glama](https://glama.ai/mcp/servers/MediaShareORG/yourimageshare). Source: [/mcp](mcp).\n- **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](discord).\n\nAll SDKs wrap the same three endpoints below (`upload`/`list`/`delete`) with\ntyped results and a proper error type on API failures instead of raw HTTP\nhandling, and are MIT licensed. .NET and Dart are built and verified\nagainst the live API but not yet published - each package name/ID is\nconfirmed available and reserved by this doc. .NET needs a NuGet API key\n(Microsoft account); Dart needs an interactive `dart pub login` (Google\nOAuth, browser-based - can't be scripted).\n\nNo official library for your language? The [full HTTP reference](API.md)\ncovers everything needed to call the API directly.\n\n## Expiring uploads\n\nPass `expires_in` (seconds, 60 to 2,592,000) on upload to auto-delete a\nfile later - the storage object is removed and the page starts 410ing\nwithin about 5 minutes of expiry. Omit it for a normal, permanent upload.\n\n```bash\ncurl \"https://yourimageshare.com/api\" \\\n  -H \"X-API-Key: YOUR_API_KEY\" \\\n  -F \"uploads=@/path/to/photo.jpg\" \\\n  -F \"expires_in=3600\"\n```\n\n## Screenshot tools\n\nReady-made configs/scripts to upload straight from a screenshot tool, no\nbrowser tab required:\n\n- [`YourImageShare.sxcu`](YourImageShare.sxcu) - ShareX custom uploader\n- [`yis-flameshot-upload.sh`](yis-flameshot-upload.sh) - Flameshot (Linux)\n- [`yis-greenshot-upload.ps1`](yis-greenshot-upload.ps1) - Greenshot (Windows)\n\nSetup instructions are in the comments at the top of each file, and on the\n[live docs page](https://yourimageshare.com/about/api#screenshot-tools).\n\n## Forum plugins\n\nA real \"Upload Image\" button next to your forum's post editor - each one\nuploads through `/api` and inserts BBCode at your cursor. All six are\nconfigured with your **Upload-only key** (not your main API key), since\nthe key renders in every visitor's page source and the upload-only key\ncan only upload on your behalf - see [Upload-only key](API.md#upload-only-key).\n\n- [`phpbb/`](forum-plugins/phpbb) - a real phpBB 3.2/3.3 extension ([download](forum-plugins/yourimageshare-phpbb.zip))\n- [`smf/`](forum-plugins/smf) - a real SMF package ([download](forum-plugins/yourimageshare-smf.zip))\n- [`mybb/`](forum-plugins/mybb) - a real MyBB 1.8 plugin ([download](forum-plugins/yourimageshare-mybb.zip))\n- [`fluxbb/`](forum-plugins/fluxbb), [`punbb/`](forum-plugins/punbb), [`zetaboards/`](forum-plugins/zetaboards) - these three don't have a formal plugin system, so it's a small copy-paste snippet into your template/Admin CP instead\n\nAll six share one underlying widget, [`forum-upload.js`](forum-plugins/forum-upload.js)\n(also served live from `yourimageshare.com/assets/js/forum-upload.js`), so\nfixes/improvements apply everywhere at once. Full setup instructions and\ndownloads are also on the [live docs page](https://yourimageshare.com/about/api#forum-plugins).\n\n## WordPress plugin\n\n[`yourimageshare-media-offload/`](wordpress-plugin/yourimageshare-media-offload)\n([download](wordpress-plugin/yourimageshare-media-offload.zip)) - offloads\nyour Media Library to YourImageShare instead of local disk: new image/video\nuploads go through `/api` automatically, the local file (and every\ngenerated thumbnail size) is deleted once the remote copy is confirmed, and\nevery WordPress attachment URL (block editor, featured images, galleries,\nREST API) resolves to the YourImageShare-hosted file - no shortcode, no\nworkflow change. Built for the common shared-hosting problem of a Media\nLibrary outgrowing a small storage quota. Uses the same **Upload-only key**\npattern as the forum plugins above; an optional full API key enables\ndeleting the remote copy when an attachment is deleted in WordPress (or\nwhen restoring a file to local storage and choosing to remove the remote\ncopy).\n\nv1.1.0 adds: bulk-offload for an *existing* Media Library (rate-limit-aware\nbatches, not just new uploads going forward), a one-click **Restore to\nlocal** action so offloading isn't a one-way door, a Media Library status\ncolumn + row actions, and a dismissible admin notice for offload failures.\nDedicated top-level admin menu, icon is the site's own Pacifico \"Y\"\nwordmark extracted as a real vector path from the font file. Audited\nagainst the [WordPress.org detailed plugin guidelines](https://developer.wordpress.org/plugins/wordpress-org/detailed-plugin-guidelines/)\n(external-service disclosure in both the readme and the settings page,\nnonces + capability checks on every AJAX action, no bundled jQuery/CDN\nassets, conservative `uninstall.php`). Not yet published to the\nWordPress.org Plugin Directory - the code is complete and installable\nmanually (zip the folder, upload via Plugins > Add New > Upload Plugin) in\nthe meantime.\n\n## Rate limits\n\nEach API key gets 20 requests/minute and 500 requests/day by default, plus a\n2,000/day ceiling per IP address as a backstop. Every response includes\n`X-RateLimit-Limit`/`X-RateLimit-Remaining` headers; a `429` includes\n`Retry-After`.\n\n## Support\n\nQuestions or issues: [yourimageshare.com/contact](https://yourimageshare.com/contact).\n",
  "bytes": 10782,
  "sha": "aed32dbf5029a6d651469fc2ff773180c5d7c746ddde6b9f1f067398f39dad72",
  "repo_slug": "mediashareorg/yourimageshare",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_mediashareorg_yourimageshare_4237fd61/readme"
}