TinyThis API Docs

Use bearer API keys to create short links and upload hosted files through predictable JSON endpoints.

Version v1 Bearer API keys JSON + multipart

Base URL https://tinythis.com/api/v1

Authentication

Send your API key as a bearer token. Raw keys are only shown once when created and are stored hashed at rest.

Authorization: Bearer tt_live_xxxxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Accept: application/json

POST/links/shorten

Shorten a URL

Create a fresh short code for a public HTTP or HTTPS URL.

Redirect URLhttps://tinythis.com/{shortCode}

Query paramsParameters sent to the short URL are merged into the destination URL.

DuplicatesIf the same parameter exists in both places, the short URL value takes precedence.

curl -X POST https://tinythis.com/api/v1/links/shorten \
  -H "Authorization: Bearer tt_live_your_api_key" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/some/long/path"}'

POST/files

Upload a hosted file

Upload a safe file with multipart form data. The default maximum size is 1024KB.

Fieldfile

Allowedjpg, jpeg, png, webp, gif, pdf, txt, csv

Deliveryhttps://tinythis.com/f/{shortCode}

curl -X POST https://tinythis.com/api/v1/files \
  -H "Authorization: Bearer tt_live_your_api_key" \
  -H "Accept: application/json" \
  -F "file=@invoice.pdf"

Errors

401Missing, revoked, expired, or invalid API key.

422Validation failed, including unsupported file type or file too large.

429Rate limit exceeded.