July 20, 2026

Shorty API v1 — Shorty changelog

The public Shorty developer API: a versioned /v1 REST surface with API keys, RFC 9457 errors, rate-limit headers, idempotency, and cursor pagination.

Open in Claude Open in ChatGPT

The Shorty API is live at https://aishorty.com/v1, authenticated with shk_live_ API keys (created in Settings) or OAuth 2.1 access tokens. Endpoints:

GET /v1/usage — plan, limits, and usage counters.
GET /v1/articles · GET /v1/articles/search · GET /v1/articles/{id} — your summarized articles.
GET /v1/transcriptions · POST /v1/transcriptions · GET /v1/transcriptions/{id} — transcription jobs.
POST /v1/summaries — summarize YouTube videos, web pages, or text.
POST /v1/subtitles · GET /v1/subtitles/{jobId}/download — subtitle jobs and artifacts.
GET /v1/jobs/{id} — async job status.

Writes are async (202 + job_id), retry-safe via the Idempotency-Key header, and burst-limited per key with IETF RateLimit response headers. Errors are RFC 9457 application/problem+json with a stable code — see the error reference.