Documentation Index

API Developer Program

Welcome to the Trimzo REST API platform. Our stateless developer gateway allows you to seamlessly generate branded short links, bypass browser limits, configure custom alias routes, and monitor conversion pipelines directly from your custom CRM, SaaS apps, or CLI utilities.

Authentication

To communicate with our endpoints, you must generate a cryptographically secure API Key inside your account dashboard settings. All HTTP requests must supply this key inside the request headers using the standard Bearer Token mechanism:

Authorization: Bearer sk_live_YOUR_API_KEY_HERE

Shorten Link Endpoint

POST https://chotourl.space/api/v1/shorten.php

JSON Body Parameters

Parameter	Type	Required	Description
original_url	string	Yes	The destination long URL route (e.g., https://yourdomain.com/path).
custom_slug	string	No	A custom unique slug. Alphanumerics and dashes allowed.

Code Snippet (cURL)

curl -X POST "https://chotourl.space/api/v1/shorten.php" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"original_url": "https://brand.com/long-page-route", "custom_slug": "my-promo"}'

JavaScript (Fetch API)

fetch('https://chotourl.space/api/v1/shorten.php', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    original_url: 'https://brand.com/long-page-route',
    custom_slug: 'my-promo'
  })
})
.then(res => res.json())
.then(data => console.log(data));

Response Body (Success 201 Created)

{ "success": true, "message": "Shortlink generated programmatically successfully.", "data": { "short_url": "https://chotourl.space/my-promo", "short_code": "my-promo", "original_url": "https://brand.com/long-page-route", "created_at": "2026-05-24 14:18:00" }, "timestamp": 1782292680 }