The API Report CardAPI Index
CleanShot

CleanShot API

cleanshot.com

CleanShot's only API is a documented macOS URL scheme, cleanshot://, driving captures, recordings, and OCR in the locally installed app. CleanShot Cloud has no REST or GraphQL API, no keys or OAuth, no webhooks, and no SDKs, so nothing works server-side or headless.

Last verified: July 2026Software & Data Tools
API GRADE
C
VERIFIED JUL 2026

SCORECARD

ExistenceMIXEDA documented macOS URL scheme at cleanshot.com/docs-api is the only API; it drives the local app, with no REST or cloud surface.
AccessMIXEDCallable by anyone with the Mac app installed and logged in; useless for server-side, cross-platform, or headless automation.
CoverageMIXEDCapture, recording, OCR, and annotation commands are scriptable; cloud uploads, teams, and share links have no programmatic path.
AuthMIXEDLocal commands run authless as the desktop user; the cloud product has no API keys or OAuth at all.
Docs & DXMIXEDThe URL scheme is documented with commands and parameters, but there are no SDKs, webhooks, or vendor-built connectors.
StabilityMIXED
Supergood: CleanShot has an API, with gaps. We cover what it's missing: stable endpoints, normalized JSON, managed auth.

Frequently asked questions

CleanShot scores C on the API Report Card. CleanShot's only API is a documented macOS URL scheme, cleanshot://, driving captures, recordings, and OCR in the locally installed app. CleanShot Cloud has no REST or GraphQL API, no keys or OAuth, no webhooks, and no SDKs, so nothing works server-side or headless.

Tried to integrate with CleanShot?
SOURCES
No public REST or GraphQL API for CleanShot Cloud, automation is limited to the local-only `cleanshot://` URL scheme cleanshot.com β†—
No webhooks, cannot subscribe to upload-complete, link-viewed, or team-event notifications cleanshot.com β†—
No OAuth, API keys, or programmatic auth surface for the cloud product cleanshot.com β†—
No official SDKs in any language; everything is URL-scheme `open`-shell-out style cleanshot.com β†—
URL scheme requires the Mac app to be installed and the user to be logged in, useless for server-side, cross-platform, or headless automation cleanshot.com β†—
No partner program, no Zapier/Make connector built by CleanShot, no public marketplace apitracker.io β†—
Custom-domain configuration is a manual settings flow, not API-driven, so MSPs/agencies cannot programmatically provision branded domains for clients 9to5mac.com β†—
No documented rate limits or quotas published for the cloud upload endpoints cleanshot.com β†—
Team management (invites, roles, SSO) is dashboard-only, no SCIM, no admin API cleanshot.com β†—
Mac-only, no Windows, Linux, web or mobile clients, which forces mixed-OS teams to standardize on something else setapp.com β†—
Default cloud-video auto-delete after 24 hours surprises users; must be turned off in settings klicktrust.com β†—
Free Cloud tier is only 1 GB, fills quickly with high-resolution captures and short recordings, forcing a Pro upgrade makerstack.co β†—
Screen recording is functional but not a polished production tool, heavier tutorial work still needs ScreenFlow / Screen Studio / Camtasia efficient.app β†—
Pricing model (one-time + annual update fee + optional cloud subscription) is confusing relative to flat SaaS or free tools like Shottr klicktrust.com β†—
Workflow is inflexible in places, e.g., no option to auto-dismiss the post-capture overlay after copying OCR text g2.com β†—
Annotation feature set has a learning curve relative to simpler tools firstsales.io β†—
Custom-domain / branded share links are gated behind the Pro / Teams subscription 9to5mac.com β†—
Occasional bug reports around upload reliability and the cloud dashboard producthunt.com β†—