Introducing the QZ-L Public API — Integrate URL Shortening into Your Applications

Build with qz-l. Create, manage, and track shortened links programmatically with our fully-featured public API. Complete interactive documentation included.

December 12, 2025By qz-l team

🚀 Introducing the QZ-L Public API

We're thrilled to announce the official launch of the QZ-L Public API—a fully-featured REST API that lets developers integrate URL shortening, analytics, and link management directly into their applications.

Whether you're building a marketing automation tool, a productivity app, or an enterprise solution, our API makes it simple to add professional link management to your platform.


🎯 Why Use the QZ-L API?

⚡ Fast & Reliable

Create shortened links in milliseconds with our optimized infrastructure. Every link is tracked with detailed analytics from day one.

🔐 Security & Privacy First

  • No tracking cookies
  • No invasive profiling
  • IP addresses counted, not stored
  • Enterprise-grade SSL encryption
  • Rate limiting to prevent abuse

📊 Built-in Analytics

Every shortened link comes with:

  • Real-time click tracking
  • Visitor analytics (OS, browser, device)
  • Traffic source detection
  • Hourly and daily breakdowns
  • Conversion metrics

💪 Flexible Pricing

Pay only for what you use. API plans include:

  • Free Tier: 200 links/month to get started
  • Starter: 1,000 links/month with 5 custom aliases
  • Basic: 10,000 links/month with 10 custom aliases
  • Prime: 100,000 links/month with unlimited aliases
  • Ultimate: Enterprise custom domains and unlimited everything

🔗 What You Can Do with the API

Create Short Links Programmatically

POST /api/short
{
  "longUrl": "https://example.com/very/long/url",
  "alias": "custom-name"  // optional
}

Instantly get back:

  • Your unique short code
  • Full short URL
  • Direct link to analytics

Manage Your Links

  • List all your shortened links with filters and pagination
  • Get detailed information about any link
  • Update link metadata
  • Delete links you no longer need

Track Real-Time Analytics

  • View total clicks and unique visitors
  • Analyze traffic sources and referrers
  • Break down visitor demographics (devices, browsers, OS)
  • Get hourly traffic distribution
  • Monitor conversion rates

API Key Management

  • Create and revoke API keys from your dashboard
  • Set rate limits and usage quotas
  • Monitor API usage and billing

📚 Complete Interactive Documentation

We've built beautiful, interactive API documentation powered by Scalar, right here on qz-l.com.

Visit the API Docs

Our documentation includes:

  • Live endpoint explorer – Test API calls directly in the browser
  • Request/response examples – See real data for every endpoint
  • Code snippets – Ready-to-use examples in multiple programming languages
  • Authentication guide – Clear instructions for using API keys
  • Error handling – Understand every response code and error message
  • Rate limiting info – Know your quota and usage

🛠️ Getting Started in 3 Steps

Step 1: Create a Free Account

Head to qz-l.com and sign up. It's free and takes 2 minutes. signup

Step 2: Generate an API Key

Log in to your dashboard and navigate to API Keys. Create a new key with a click—copy it and keep it safe. apikeys

Step 3: Make Your First API Call

Use your API key to create a shortened link:

curl -X POST https://qz-l.com/api/short \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "longUrl": "https://www.example.com/my/super/long/url"
  }'

You'll get back:

{
  "shortCode": "abc123",
  "shortUrl": "https://qz-l.com/abc123",
  "longUrl": "https://www.example.com/my/super/long/url",
  "createdAt": "2025-12-12T10:00:00Z"
}

That's it! Your link is live and already tracking analytics.


📊 Manage Everything from Your Dashboard

Once you've signed up, your dashboard gives you complete control:

Link Management

  • View all your shortened links in a clean, searchable table
  • Filter by date range, API key, or search term
  • See click counts and creation dates at a glance
  • Delete or manage individual links
  • Claim links created before you signed up links

📌 Important Notice: Claim Your Short Link

If you created a short link on qz-l.com before signing up your account, you can claim ownership of it. Simply navigate to your Links tab and click Submit Claim. Provide the short URL, the original long URL, and your email address, and our team will verify and transfer ownership to your account.

API Key Management

  • Create unlimited API keys for different projects
  • Revoke keys instantly if compromised
  • Monitor usage and rate limit status
  • Rotate keys for security

Subscription & Billing

  • Check your current plan and monthly limits
  • See real-time usage statistics
  • Upgrade or downgrade anytime
  • View invoices and billing history
  • No hidden fees or surprise charges links

Link Analytics

  • Search any of your links to see detailed analytics
  • Track traffic trends over 30 days
  • Analyze visitor sources and demographics
  • Export reports for further analysis links

💻 Framework Examples

JavaScript/Node.js

const apiKey = 'your-api-key-here';

const shortenUrl = async (longUrl) => {
  const response = await fetch('https://qz-l.com/api/short', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ longUrl })
  });
  
  return response.json();
};

// Usage
shortenUrl('https://example.com/long/url').then(data => {
  console.log('Short link:', data.shortUrl);
});

Python

import requests

api_key = 'your-api-key-here'
headers = {
    'Authorization': f'Bearer {api_key}',
    'Content-Type': 'application/json'
}

response = requests.post(
    'https://qz-l.com/api/short',
    headers=headers,
    json={'longUrl': 'https://example.com/long/url'}
)

data = response.json()
print(f"Short link: {data['shortUrl']}")

cURL

curl -X POST https://qz-l.com/api/short \
  -H "Authorization: Bearer your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{"longUrl": "https://example.com/long/url"}'

🔒 Security & Best Practices

Protect Your API Keys

  • Never hardcode API keys in your source code
  • Use environment variables or secrets management tools
  • Rotate keys regularly for enhanced security
  • Revoke immediately if a key is compromised

Rate Limiting

  • Standard: 1,000 requests per hour
  • Higher limits available on Premium plans
  • Graceful rate limiting—you'll know before you hit the limit

API Versioning

  • Current version: 1.0.0
  • Backward compatibility guaranteed
  • New features added without breaking existing endpoints

🚀 Real-World Use Cases

Marketing Automation
Automatically generate tracked short links in email campaigns and social media posts.

Analytics Integration
Integrate qz-l analytics into your internal dashboard to track marketing performance.

Multi-Tenant Applications
Give each of your customers their own branded link management within your app.

Social Media Tools
Build tools that auto-generate, share, and track links across multiple platforms.

Enterprise Link Management
Centralize link management across your organization with team collaboration and detailed reporting.


📖 Learn More


🎉 What's Next?

We're just getting started. Upcoming features include:

  • 🔗 Custom domain support (use your own domain for branded links)
  • 🔐 Advanced security (IP whitelisting, webhook callbacks)
  • 📱 Mobile SDKs (iOS and Android)
  • 🌐 GraphQL API (alternative to REST)
  • 🤖 AI-powered link recommendations
  • 📊 Advanced bulk operations and analytics export

Let's Build Together

The qz-l API is here to empower developers. Whether you're building a small side project or an enterprise platform, we're excited to see what you create.

Ready to start? Create your free account and generate your first API key today.

Questions? Email us at support@qz-l.com or check out our API documentation.

Happy building! 🚀

Related Posts

Introducing Analytics Dashboard - Now See How Your Links Perform

Track every click on your shortened links with our new analytics dashboard. See traffic trends, visitor sources, device types, and more.

Full Subscription Management Now Live on QZ-L.com

QZ-L.com now lets you upgrade, cancel, and track your subscription usage with ease. Manage your plans and enjoy full control over your short links and aliases.

Introducing AI Chat Assistant — Your Smart Helper for Short Links

Meet the new qz-l AI Chat Assistant. Create links, view analytics, manage URLs, and get instant help — all through chat.

Introducing the QZ-L Public API — Integrate URL Shortening into Your Applications | qz-l