```html Documentation - Qur.li URL Shortener

Qur.li Documentation

Comprehensive guides and references for the Qur.li API, integrations, and advanced features.

Getting Started with Qur.li API

The Qur.li API allows you to programmatically create, manage, and track shortened URLs. This guide will help you get started with making your first API request.

Prerequisites

  • A Qur.li account (any plan)
  • API access enabled (available on Pro and Business plans)
  • Your API key from the dashboard

Making Your First Request

Here's an example of how to shorten a URL using cURL:

curl -X POST \
  https://api.qur.li/v1/links \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "long_url": "https://example.com/very-long-url",
    "custom_alias": "my-custom-link"
  }'

Response

{
  "success": true,
  "data": {
    "short_url": "https://qur.li/my-custom-link",
    "long_url": "https://example.com/very-long-url",
    "alias": "my-custom-link",
    "clicks": 0,
    "created_at": "2023-10-15T10:30:00Z"
  }
}

Authentication

All API requests must include your API key in the Authorization header. You can find your API key in your account settings.

Bearer Token Authentication

Authorization: Bearer YOUR_API_KEY

Getting Your API Key

  1. Log in to your Qur.li account
  2. Go to Settings → API
  3. Click "Generate API Key"
  4. Copy your key and store it securely

Important

Keep your API key secret. Do not share it in client-side code or public repositories.

API Endpoints

Create Short Link

POST /v1/links

Create a new shortened URL

Parameters

Parameter Type Required Description
long_url string Yes The URL to shorten
custom_alias string No Custom alias for the short URL

Get Link Analytics

GET /v1/links/{alias}/analytics

Retrieve analytics data for a specific short link

API Reference

Complete reference for all API endpoints, parameters, and responses.

View Full Reference →

SDK Downloads

Download official SDKs for popular programming languages and frameworks.

Download SDKs →

Need Help?

Our support team is here to help you with any questions about the API or integrations.

Contact Support