🚀 FREE PRO

API Now Live!

REST API v1 is production-ready. Start building today.

Get API Key
API v1 - PRODUCTION READY

Build with Mobily API

Powerful REST API to create, manage, and track short links programmatically

Fast & Simple

RESTful API with JSON responses. Get started in minutes with our simple authentication.

Secure

API key authentication with rate limiting. HTTPS-only endpoints for maximum security.

Analytics

Full analytics data for every link. Track clicks, referrers, devices, and more.

Quick Start

1 Get Your API Key

Generate your API key from your dashboard. Each key supports 1,000 requests/hour.

Go to API Keys

2 Make Your First Request

Create a short link with a simple POST request:

curl -X POST https://mobily.ca/api/v1/links \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/very-long-url",
    "custom_alias": "mylink"
  }'

3 Get Response

Receive your shortened link instantly:

{
  "success": true,
  "short_url": "https://mobily.ca/mylink",
  "original_url": "https://example.com/very-long-url",
  "alias": "mylink",
  "created_at": "2025-10-07T14:30:00Z"
}

API Endpoints

POST /api/v1/links

Create Short Link

Create a new shortened URL with optional custom alias and settings.

Parameters:

  • url (required) - The original URL to shorten
  • custom_alias (optional) - Custom short code
  • password (optional) - Password protection
  • expires_at (optional) - Expiration date (YYYY-MM-DD)
GET /api/v1/links/{alias}

Get Link Details

Retrieve information about a specific shortened link including analytics.

GET /api/v1/links

List All Links

Get a paginated list of all your shortened links.

PUT /api/v1/links/{alias}

Update Link

Update link settings like password, expiration, or destination URL.

DELETE /api/v1/links/{alias}

Delete Link

Permanently delete a shortened link.

GET /api/v1/links/{alias}/analytics

Get Analytics

Retrieve detailed analytics data for a specific link.

Error Codes

Code Status Description
200 OK Request completed successfully
400 Bad Request Invalid parameters or malformed request
401 Unauthorized Missing or invalid API key
403 Forbidden API key doesn't have permission for this action
404 Not Found Resource not found
429 Too Many Requests Rate limit exceeded. Wait before retrying.
500 Internal Server Error Server error. Contact support if persists.

Error Response Format

All error responses include a JSON body with error and message fields for debugging.

Authentication

All API requests require authentication using an API key. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Keep Your API Key Secret

Never expose your API key in client-side code or public repositories. Store it securely in environment variables.

Rate Limits

Free Plan

100

requests / hour

Pro Plan

1,000

requests / hour

Business Plan

10,000

requests / hour

Ready to Start Building?

Get your API key now and start integrating Mobily into your applications today.