URL Shortener API: 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 so later GET /api/urls can reclaim or audit everything your integration produced.
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.
FAQ
- 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 free short URL tool.