API Documentation

Simple, powerful API for integrating URL shortening into your applications. Token-based authentication for secure API access.

OpenAPI JSON View in Swagger UI

Authentication

Getting Your API Token

Sign in to your Uplink dashboard
Go to the "API Tokens" section
Click "Generate New Token"
Choose token expiration (7 days, 30 days, 90 days, 1 year, or never)
Copy your token immediately - you won't see it again!

Using Your Token

Include the token in the Authorization header of every request:

bash

Authorization: Bearer uplink_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

🔐 Security Tip

Your API token is as powerful as your password. Keep it secret and never commit it to version control. If compromised, generate a new token immediately.

Quick Start

Create a shortened URL in seconds with a single POST request using your API token:

bash

TOKEN="uplink_yse2JpXPSUKu-szJel4waiBsU6XNO0FsOgFLx8qkuwU"

curl -X POST https://meetra.live/api/v1/shorten \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
    "url": "https://example.com/very/long/url"
  }'

💡 Tip: Try it now!

Replace the TOKEN value with your actual API token, then copy the curl command and run it in your terminal to create your first shortened URL.

Endpoint Reference

POST /api/v1/shorten

Create a shortened URL

Request

Field	Type	Required	Description
url	string	Required	The URL to shorten. Must start with http:// or https://
slug	string	Optional	Custom short code. 2-50 alphanumeric, hyphens, or underscores. Must be unique.
permanent	boolean	Optional	If true, link never expires. If false, expires in 30 days. Default: false

json

{
  "url": "https://example.com/very/long/url",
  "slug": "my-custom-slug",
  "permanent": true
}

Response

json

{
  "success": true,
  "shortUrl": "https://meetra.live/abc123",
  "code": "abc123",
  "originalUrl": "https://example.com/very/long/url",
  "permanent": false,
  "expiresAt": "2025-01-26T19:22:05.000Z"
}

Code Examples

javascript

const token = 'uplink_your_token_here';

const response = await fetch('https://meetra.live/api/v1/shorten', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${token}`,
  },
  body: JSON.stringify({
    url: 'https://example.com/very/long/url',
    permanent: false,
  }),
});

const data = await response.json();

if (data.success) {
  console.log('Short URL:', data.shortUrl);
  console.log('Code:', data.code);
  console.log('Expires:', data.expiresAt);
} else {
  console.error('Error:', data.error);
}

Common Use Cases

Social Media Automation

Shorten URLs before posting to Twitter, LinkedIn, or other social platforms.

const shortUrl = await shorten(url); tweet(`Check this out: ${shortUrl}`);

Analytics & Campaigns

Create custom slugs for tracking different marketing campaigns.

await shorten(url, { slug: "summer-2025", permanent: true });

Email Templates

Generate short links for email campaigns to save space and improve tracking.

const links = await Promise.all( urls.map(u => shorten(u)) );

QR Code Generation

Combine with QR code libraries for smaller, scannable codes.

const {shortUrl} = await shorten(url); qrcode.toCanvas(shortUrl);

Mobile App Integration

Quick integration for iOS, Android, or cross-platform apps.

let result = try await URLSession .shared.data(from: shortenURL)

Browser Extensions

Add URL shortening directly to your browser context menu.

chrome.contextMenus.onClicked .addListener((shortUrl) => {...});

FAQ

Ready to integrate?

The API is live right now. Generate your API token in the dashboard, then start shortening URLs with a single POST request. Fast, simple, and secure.

View on GitHub OpenAPI Spec BroCode Community