MinifyURL API
Programmatic access to your short links. Available on the Pro plan.
🔑 API access is a Pro feature. Generate your API key from your Dashboard.
The MinifyURL API lets you create, list, and manage your short links programmatically. All endpoints return JSON.
Base URL
https://minifyurl.in/api/v1
Authentication
All API requests must include your API key in the Authorization header as a Bearer token.
Header format
Authorization: Bearer YOUR_API_KEY
⚠️ Keep your API key secret. Do not share it or commit it to version control. If compromised, revoke it immediately from your dashboard.
Getting your API key
1. Log in to your account
2. Go to Dashboard
3. Scroll to the API Access section
4. Click Generate API Key
5. Copy and save the key — it is only shown once
Errors
The API uses standard HTTP status codes. All errors return a JSON object with an error field.
| Status | Meaning |
|---|---|
| 200 | Success |
| 201 | Created (new link) |
| 400 | Bad request — check your parameters |
| 401 | Unauthorized — missing or invalid API key |
| 403 | Forbidden — Pro plan required |
| 404 | Link not found |
| 500 | Server error |
Error response example
{"error": "Invalid API key"}
Shorten URL PRO
POST
/api/v1/shorten
Create a short link
Request body
| Parameter | Type | Description |
|---|---|---|
| urlrequired | string | The URL to shorten. Must include https:// |
| custom_slugoptional | string | Custom ending for your short link (e.g. "mybrand") |
| expires_inoptional | number | Number of days before the link expires |
curl -X POST https://minifyurl.in/api/v1/shorten \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com/very/long/url"}'
Response
{
"code": "abc12",
"short_url": "https://minifyurl.in/abc12",
"original_url": "https://example.com/very/long/url",
"expires_at": null
}
List Links PRO
GET
/api/v1/links
Get all your links
Returns up to 100 of your most recent links.
curl https://minifyurl.in/api/v1/links \
-H "Authorization: Bearer YOUR_API_KEY"
Response
{
"links": [
{
"code": "abc12",
"original_url": "https://example.com",
"hits": 42,
"created_at": "2026-04-15T10:00:00Z",
"expires_at": null
}
],
"count": 1
}
Link Stats PRO
GET
/api/v1/links/:code/stats
Get analytics for a link
Path parameters
| Parameter | Description |
|---|---|
| coderequired | The short link code (e.g. "abc12") |
curl https://minifyurl.in/api/v1/links/abc12/stats \
-H "Authorization: Bearer YOUR_API_KEY"
Response
{
"link": { "code": "abc12", "hits": 42 },
"countries": [{ "country": "IN", "count": "30" }],
"browsers": [{ "browser": "Chrome", "count": "25" }],
"devices": [{ "device": "mobile", "count": "35" }]
}
Delete Link PRO
DELETE
/api/v1/links/:code
Permanently delete a link
Path parameters
| Parameter | Description |
|---|---|
| coderequired | The short link code to delete |
curl -X DELETE https://minifyurl.in/api/v1/links/abc12 \
-H "Authorization: Bearer YOUR_API_KEY"
Response
{ "ok": true, "deleted": "abc12" }