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 string 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 string 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"