Skip to main content
POST
/
emoji
Create Emoji URLs
curl --request POST \
  --url https://spoo.me/emoji \
  --header 'Accept: <accept>' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data url=https://example.com \
  --data 'emojies=🐍🐍' \
  --data password=Python.Snake63 \
  --data max-clicks=1000 \
  --data block-bots=false
{
  "short_url": "https://spoo.me/🐍🐍",
  "domain": "spoo.me",
  "original_url": "https://example.com"
}

Headers

​
Accept
enum<string>
default:application/json
required

Must be set to application/json to receive JSON responses

Available options:
application/json

Body

application/x-www-form-urlencoded
​
url
string<uri>
required

The long URL to be shortened. Must include a valid protocol (http/https) and follow RFC-1034 & RFC-2727 standards.

Example:

"https://example.com"

​
emojies
string

Custom emoji sequence for the shortened URL. Must contain only emojis, no other character is allowed. Anything beyond 15 emojis will be stripped by the API.

Maximum length: 15
Example:

"🐍🐍"

​
password
string

Password to access the shortened URL. Must be at least 8 characters long, contain at least one letter, one number, and one special character ('@' or '.').

Minimum length: 8
Example:

"Python.Snake63"

​
max-clicks
integer

Maximum number of clicks allowed for the shortened URL. Must be a positive integer.

Required range: x >= 1
Example:

1000

​
block-bots
boolean

Whether to block bots from accessing the shortened URL.

Example:

false

Response

Emoji URL successfully created

​
short_url
string<uri>

The shortened URL with emojis

Example:

"https://spoo.me/🐍🐍"

​
domain
string<host>

The domain of the shortened URL

Example:

"spoo.me"

​
original_url
string<uri>

The original URL

Example:

"https://example.com"

⌘I