URL Slug API Documentation

Authorization: Bearer YOUR_API_KEY

import requests

API_KEY = "your_api_key"
BASE_URL = "https://api.urlcut.ai/v1"

def create_short_url(url, slug=None, title=None):
    """Create a short URL with optional custom slug."""
    headers = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    }

    payload = {"url": url}
    if slug:
        payload["slug"] = slug
    if title:
        payload["title"] = title

    response = requests.post(
        f"{BASE_URL}/links",
        headers=headers,
        json=payload
    )

    return response.json()

# Usage
result = create_short_url(
    url="https://example.com/my-long-article",
    slug="my-article",
    title="My Article Title"
)
print(result["data"]["short_url"])
# Output: https://urlcut.ai/my-article

const axios = require('axios');

const API_KEY = 'your_api_key';
const BASE_URL = 'https://api.urlcut.ai/v1';

async function createShortUrl(url, options = {}) {
  try {
    const response = await axios.post(
      `${BASE_URL}/links`,
      {
        url,
        slug: options.slug,
        title: options.title,
        tags: options.tags
      },
      {
        headers: {
          'Authorization': `Bearer ${API_KEY}`,
          'Content-Type': 'application/json'
        }
      }
    );

    return response.data;
  } catch (error) {
    console.error('Error:', error.response?.data || error.message);
    throw error;
  }
}

// Usage
createShortUrl('https://example.com/blog/post', {
  slug: 'blog-post',
  title: 'My Blog Post',
  tags: ['blog', 'tech']
}).then(result => {
  console.log(result.data.short_url);
});

<?php
$apiKey = 'your_api_key';
$baseUrl = 'https://api.urlcut.ai/v1';

function createShortUrl($url, $slug = null, $title = null) {
    global $apiKey, $baseUrl;

    $payload = ['url' => $url];
    if ($slug) $payload['slug'] = $slug;
    if ($title) $payload['title'] = $title;

    $ch = curl_init("$baseUrl/links");
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => [
            "Authorization: Bearer $apiKey",
            "Content-Type: application/json"
        ],
        CURLOPT_POSTFIELDS => json_encode($payload)
    ]);

    $response = curl_exec($ch);
    curl_close($ch);

    return json_decode($response, true);
}

// Usage
$result = createShortUrl(
    'https://example.com/product/12345',
    'cool-product',
    'Cool Product'
);
echo $result['data']['short_url'];
// Output: https://urlcut.ai/cool-product
?>