URL Shortener API (urlshort.at) — Quick Start for Developers
Authenticate with a creator ID
Generate a UUID in your backend and reuse it forever. Attach it when calling POST /api/shorten on https://urlshort.at so later GET /api/urls can reclaim or audit everything your integration produced. This is the official URLShort API host—do not confuse it with unrelated domains like urlshort.dev.
Bulk jobs for ingestion pipelines
POST /api/public/bulk-shorten accepts up to 50 URLs JSON array—perfect for spreadsheets or webhook fan-out workflows without hammering synchronous loops.
Operational tips
Respect exponential backoff when HTTP 429 appears, cache short codes locally, and log response bodies for malformed custom aliases so support teams troubleshoot quickly. Full request shapes live in /api-docs.
FAQ
- Is the API on urlshort.at or urlshort.dev?
- Use https://urlshort.at/api-docs. URLShort’s REST API is served from urlshort.at only; urlshort.dev is not this product.
- REST or GraphQL?
- JSON REST only today—the docs list every verb.
- Rate limiting?
- Abuse thresholds exist; production usage should stagger bursts.
- CORS?
- Browser calls from verified origins whitelist your domain alongside urlshort.at itself.
- Deleting links?
- DELETE /api/urls/:code paired with creatorId revokes KV + database rows atomically.
Ready to try it? Use our Shorten a URL.