PixGB API

REST JSON API for uploads, library management, and ImgBB-style replace. Auth with your Library API token. Integrate into apps, bots, and plugins.

Auth

X-Api-Token: YOUR_TOKEN
X-API-Key: YOUR_TOKEN
Authorization: Bearer YOUR_TOKEN
# or
?key=YOUR_TOKEN

Token lives on Library after you sign in.

Upload

curl -X POST "https://pixgb.com/api/v1/upload" \
  -H "X-Api-Token: YOUR_TOKEN" \
  -F "image=@photo.jpg" \
  -F "name=optional-title.jpg" \
  -F "isPrivate=false" \
  -F "customSlug=my-logo"

curl -X POST "https://pixgb.com/api/v1/upload" \
  -H "X-Api-Token: YOUR_TOKEN" \
  -F "file=@clip.mp4"

Accepts file or image (multipart or base64), optional resize (resizeMode, allowUpscale, custom width/height), and customSlug / slug for a vanity /i/… name. Non-image files (zip, PDF, video, …) use the same endpoint with file=; optional password / sharePassword. Response includes kind (image or file), url / page_url (the /i/… share page), and download_url. Clip uploads keep that page URL as the share link. Direct image links include a file extension so picky BBCode forums accept them.

Response shape

{
  "success": true,
  "data": {
    "url": "https://pixgb.com/i/…",
    "display_url": "https://pixgb.com/o/….jpg",
    "thumb_url": "https://pixgb.com/t/….jpg",
    "links": { "bbcode": "[img]…[/img]", "markdown": "…", "html": "…" }
  }
}

Other endpoints

• GET /api/v1 — discovery
• GET /api/v1/account — plan, storage, bandwidth
• GET /api/v1/images — paginated library
• GET /api/v1/images/{code}
• PATCH /api/v1/images/{code} — {"isPrivate":true,"customSlug":"my-pic"}
• POST /api/v1/images/{code}/replace — keep same link, new file (prior version archived)
• Responses include sha256, view_count, bandwidth_bytes, and forum links
• POST /api/v1/images/{code}/resize — resizeMode=2x|3840|custom (+ optional width/height)
• DELETE /api/v1/images/{code} — Pro: trash 12 months (still uses storage); ?permanent=true hard delete

ShareX

Screenshot → PixGB upload → link on your clipboard.

1. Sign in and copy your API token from Library.
2. Download a destination below and open it in ShareX (Destinations → Custom uploader).
3. Replace YOUR_API_TOKEN with your token. Capture a screenshot — ShareX uploads and copies the direct image URL.

Download pixgb.sxcu (images) Download pixgb-files.sxcu (files / clips)

RequestURL: https://pixgb.com/api/v1/upload
Header: X-Api-Token
File form: image
URL: {"json:data.display_url"}

Images return display_url (direct /o/…). The files config returns the share page URL.

SEO & discovery

After every public upload PixGB automatically: (1) updates /sitemap.xml and /sitemap-latest.xml, (2) pings IndexNow (Bing, Yandex, and partners) with the new page + image URLs, (3) warms the viewer HTML so crawlers get a fast 200. Google has no public “index this URL now” API for normal pages — submit both sitemaps once in Google Search Console. Private / quarantined uploads are not notified.

Browser extension

Install Chrome / Firefox extension — right‑click any image → upload → forum‑safe link copied.

Also works with ShareX, this API, or paste/drop on the site.

Zero-click on the web

Guests can paste or drop images on the homepage without an account (session history at /recent). Apps should use the API above for durable library uploads.