Developer guide: shorten links programmatically with the API

Deciding whether the API fits? What the API does, and its rate limits — on every plan including free.

When you're creating links at volume (from a CMS, an internal tool, or a script) you don't want to click a form. The Urlicer API lets you create and manage short links straight from your own code.

Get a key

Generate an API key from your workspace's API keys page. Keys look like url_live_…, are scoped to that workspace, and are sent as a Bearer token:

Authorization: Bearer url_live_your_key_here

Create a link

A single POST creates a short link and returns it:

curl -X POST https://urlicer.com/api/v1/links \
  -H "Authorization: Bearer url_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/very/long/path","alias":"spring"}'

The rest of the endpoints

• POST /api/v1/links: create a link.
• POST /api/v1/links/bulk: create many at once.
• GET /api/v1/links: list your links.
• GET /api/v1/links/{code}: fetch one.
• PATCH /api/v1/links/{code}: update the destination or settings.
• DELETE /api/v1/links/{code}: remove one.

Good to know

Requests are rate-limited per plan, and everything is workspace-scoped to the key. Full request and response details live in the help centre. The API is included in every plan, the free one included. What changes with your plan is how many requests each key may make per minute, how many keys you can hold, and which link features (custom aliases, expiry, passwords, branded domains, bulk) those keys can use; see pricing.

Building something? Shorten a link free. No signup, and every link gets a QR code and click analytics.