S.EE Docs
API Reference

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

custom_slug?string

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

Lengthlength <= 255
domain*string

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

Default"s.ee"
Lengthlength <= 255
expiration_redirect_url?string

URL to redirect visitors to after this short link expires

Lengthlength <= 2000
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)

Length3 <= length <= 32
tag_ids?array<>

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)

Lengthlength <= 2000
title?string

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

Lengthlength <= 255

Response Body

application/json

curl -X POST "https://s.ee/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"
}

SM.MS Compatibility

Migrate from SM.MS to S.EE with minimal code changes

Create Short URL (Simple Mode) GET

A simplified way to create short URLs using query parameters instead of a JSON body. Ideal for quick integrations, bookmarklets, or when you need a plain text response. Set json=true for JSON response format.