Create Short URL

Creates a new short URL for your destination link. You can optionally specify a custom slug, password protection, expiration time, and tags for organization.

Header Parameters

Authorization*string

Your API key

Request Body

application/json

Short URL configuration

TypeScript Definitions

Use the request body type in TypeScript.

custom_slug?string

Your preferred custom slug (e.g., "my-link"). If not provided, a random slug will be generated.

domain*string

The domain to use for your short URL (e.g., "s.ee")

expiration_redirect_url?string

URL to redirect visitors to after this short link expires

expire_at?integer

Unix timestamp when this short link should expire (e.g., 1735689600)

password?string

Optional password to protect this short link (3-32 characters)

tag_ids?array<integer>

Array of tag IDs to organize this link (get available tags via /api/v1/tags)

target_url*string

The destination URL you want to shorten (required)

title?string

A descriptive title for this short link (for your reference)

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/shorten" \  -H "Authorization: string" \  -H "Content-Type: application/json" \  -d '{    "domain": "s.ee",    "target_url": "string"  }'

{  "code": 0,  "data": {    "custom_slug": "string",    "short_url": "string",    "slug": "string"  },  "message": "string"}

Header Parameters

Request Body

Response Body

200application/json

`application/json`