🚀 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.

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.

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

📌 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

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

💻 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
- Interactive API Documentation – Explore all endpoints with live examples
- Sign Up for Free – Get started with 200 free links per month
- View Pricing – See our flexible plans and upgrade anytime
- Contact Support – Questions? We're here to help
🎉 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! 🚀