Delete URL - Spoo.me Docs

DELETE

/

api

/

v1

/

urls

/

{url_id}

Delete URL

curl --request DELETE \
  --url https://spoo.me/api/v1/urls/{url_id} \
  --header 'Authorization: Bearer <token>'

{
  "message": "<string>",
  "id": "<string>"
}

Authorizations

Authorization

string

header

required

API key authentication. Pass your key as: Bearer spoo_<your_key>

Path Parameters

url_id

string

required

Unique identifier of the URL

Response

Successful Response

Response body for DELETE /api/v1/urls/{url_id}.

message

string

required

Confirmation message.

Example:

"URL deleted"

id

string

required

ID of the deleted URL.

Example:

"507f1f77bcf86cd799439011"

URL StatisticsGet click statistics for URLs. Retrieve aggregated click analytics with flexible grouping, filtering, and time-range options. Results are computed in a single database round-trip using `$facet` aggregation. **Authentication**: Optional for `scope=anon` (public stats on a single URL); required for `scope=all` (all URLs owned by the user). **API Key Scope**: `stats:read`, `urls:read`, or `admin:all` **Rate Limits**: - Authenticated: 60/min, 5,000/day - Anonymous: 20/min, 1,000/day **Scopes**: - `scope=anon` + `short_code=<alias>` — public stats for one URL (if stats are not private) - `scope=all` — aggregate stats across all URLs owned by the authenticated user **Grouping Dimensions**: `time`, `browser`, `os`, `country`, `city`, `referrer`, `short_code` **Metrics**: `clicks`, `unique_clicks` **Filtering**: Filter by `browser`, `os`, `country`, `city`, `referrer`, or `short_code` using query params or a JSON `filters` object.

Delete URL

curl --request DELETE \
  --url https://spoo.me/api/v1/urls/{url_id} \
  --header 'Authorization: Bearer <token>'

{
  "message": "<string>",
  "id": "<string>"
}