Skip to main content
POST
/
stats
/
{shortCode}
Get URL Statistics
curl --request POST \
  --url https://spoo.me/stats/{shortCode} \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data password=Example@12
{
  "_id": "<string>",
  "short_code": "<string>",
  "url": "<string>",
  "total-clicks": 123,
  "total_unique_clicks": 123,
  "creation-date": "2023-12-25",
  "last-click": "2023-11-07T05:31:56Z",
  "last-click-browser": "<string>",
  "last-click-os": "<string>",
  "average_daily_clicks": 123,
  "average_weekly_clicks": 123,
  "average_monthly_clicks": 123,
  "average_redirection_time": 123,
  "max-clicks": 123,
  "password": "<string>",
  "expired": true,
  "block-bots": true,
  "counter": {},
  "unique_counter": {},
  "browser": {},
  "unique_browser": {},
  "os_name": {},
  "unique_os_name": {},
  "country": {},
  "unique_country": {},
  "referrer": {},
  "unique_referrer": {},
  "bots": {}
}

Path Parameters

​
shortCode
string
required

The short code of the URL. Can represent the short code of both regular and emoji URLs.

Body

application/x-www-form-urlencoded
​
password
string

Password of the shortened URL if it's password protected. Required only for password-protected URLs.

Example:

"Example@12"

Response

URL statistics retrieved successfully

​
_id
string

The short code of the shortened URL

​
short_code
string

The short code of the shortened URL

​
url
string<uri>

Original long URL that the short link redirects to

​
total-clicks
integer

Total number of clicks since the short link was created

​
total_unique_clicks
integer

Total number of unique clicks since the short link was created

​
creation-date
string<date>

Date when the short link was created

​
last-click
string<date-time> | null

Timestamp of the last time the short link was accessed

​
last-click-browser
string | null

Last browser used to access the short link

​
last-click-os
string | null

Last operating system used to access the short link

​
average_daily_clicks
number

Average clicks per day since the link was created

​
average_weekly_clicks
number

Average clicks per week since the link was created

​
average_monthly_clicks
number

Average clicks per month since the link was created

​
average_redirection_time
number

Average redirection time of the short link in milliseconds

​
max-clicks
integer | null

Maximum clicks set by the user

​
password
string | null

Password set by the user

​
expired
boolean | null

Whether the link has expired

​
block-bots
boolean

Whether bots are blocked from accessing the short link

​
counter
object

Data about clicks per day since the link was created

​
unique_counter
object

Data about unique clicks per day since the link was created

​
browser
object

Data about the browsers used to access the short link

​
unique_browser
object

Data about unique browsers used to access the short link

​
os_name
object

Data about the operating systems used to access the short link

​
unique_os_name
object

Data about unique operating systems used to access the short link

​
country
object

Data about the countries from which the short link was accessed

​
unique_country
object

Data about unique countries from which the short link was accessed

​
referrer
object

Data about the referrers from which the short link was accessed

​
unique_referrer
object

Data about unique referrers from which the short link was accessed

​
bots
object

Data about the bots that accessed the short link

⌘I