API

Create and manage short links from your own code.

Documentation

Send your token with every request in the Authorization header. Request bodies are JSON.

Authorization: Bearer <your_api_token>

Endpoints

Endpoint	Description	Cost
GET `?action=status`	Current usage and limits	0
POST `?action=create_link`	Create a short link (fullurl, redirectmode, optional premiumshort)	1
POST `?action=update_link`	Change destination and/or mode (id or short_tag)	1
POST `?action=delete_link`	Delete a short link (id or short_tag)	0

Redirect modes

1 – Direct: Visitors are forwarded instantly. Fastest option.
2 – Paged View: Visitors see the destination and a preview first, then decide to continue.
3 – Safe View: We load the page for the visitor – scripts and trackers removed, their IP stays hidden from the destination.

Examples

`?action=status`

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://hidelink.top/api.php?action=status"

<?php
$ch = curl_init('https://hidelink.top/api.php?action=status');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer YOUR_TOKEN'],
]);
$result = json_decode(curl_exec($ch), true);
print_r($result);

`?action=create_link`

curl -X POST "https://hidelink.top/api.php?action=create_link" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"fullurl":"https://example.com/","redirectmode":1}'

<?php
$data = [
    'fullurl'      => 'https://example.com/',
    'redirectmode' => 1,            // 1 = direct, 2 = paged view, 3 = safe view
    // 'premiumshort' => 'my-name', // optional
];
$ch = curl_init('https://hidelink.top/api.php?action=create_link');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer YOUR_TOKEN',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS     => json_encode($data),
]);
$result = json_decode(curl_exec($ch), true);
echo $result['short_url'] ?? $result['error'];

`?action=update_link`

curl -X POST "https://hidelink.top/api.php?action=update_link" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"short_tag":"my-name","fullurl":"https://example.com/new","redirectmode":2}'

<?php
$data = [
    'short_tag'    => 'my-name',  // or 'id' => 123
    'fullurl'      => 'https://example.com/new',
    'redirectmode' => 2,
];
// same cURL call as create_link, action=update_link

`?action=delete_link`

curl -X POST "https://hidelink.top/api.php?action=delete_link" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"short_tag":"my-name"}'

<?php
$data = ['short_tag' => 'my-name']; // or 'id' => 123
// same cURL call as create_link, action=delete_link

Example response

{
  "success": true,
  "short_url": "https://hidelink.top/aB3xK9p",
  "short_tag": "aB3xK9p",
  "redirect_mode": 1,
  "usage": { "limit": 1000, "used": 12, "remaining": 988, "month": "2026-10" }
}

Errors return "success": false with an "error" message and a matching HTTP status (400, 401, 403, 404, 429).