ClipRelayCreate link
DEVELOPERS — CURRENT API

Build better
video links.

Create temporary TikTok watch links, request an owner-approved bot API key, and explore the API.

Request bot API access

01

How it works

Source-backed links require no file storage or downloadable bot-host files.

  1. Choose a videoPaste a public TikTok video URL. Other social platforms are not supported.
  2. Create a linkChoose Best, Standard, or Mobile source preference for TikTok.
  3. Share itChoose a link lifetime up to 24 hours. Playback depends on the original video's availability.
02

Link API

Generate and resolve links. No Vercel Blob token is needed.

POST/api/key-requests

Submit a Discord bot request for owner review (one request every seven days).

GET/api/key-requests

Check the status of the current browser's submitted request.

GET/api/keys/me

Inspect an owner-issued bot key and the last 24 hours of calls.

DELETE/api/keys/me

Revoke the authenticated bot key.

POST/api/links

Create a TikTok source link. Bot clients authenticate with X-API-Key.

GET/d/{code}

Open a watch page with the official TikTok player.

GET/api/links/media/{code}

Redirect to a TikTok source MP4 while the link is active.

GET/api/health

Inspect backend readiness and current source-backed storage mode.

Trusted bot request
POST /api/links
X-API-Key: crk_YOUR_BOT_KEY
Content-Type: application/json

{ "url": "https://www.tiktok.com/@creator/video/123...", "format": "best" }

Both https://www.clipreeelay.xyz and https://clipreeelay.vercel.app accept authenticated API requests with the same key. You can use either HTTPS host as the API base URL.

The response includes watchUrl, downloadUrl, and expiresAt. Keep your bot-specific API key private. The owner issues keys only after reviewing requests. Approved keys expire after seven days and allow 100 total requests. Request access or view an issued key.

03

Discord integration

The Discord bot prioritises the highest available original source that fits the upload limit. Device playback still depends on the codec.

BotHosting variables
DISCORD_TOKEN=your_discord_token
CLIPRELAY_URL=https://clipreeelay.vercel.app
CLIPRELAY_API_KEY=crk_YOUR_BOT_KEY

Use discord.py 2.6 or newer for Media Gallery playback inside a Container. The bot sends the best available source without re-encoding when it fits Discord's upload limit. Some HEVC/HDR files may not play inline on every device. Website share links offer an alternative compatible source when available.

04

Storage and limits

What runs without Vercel Blob, and what is not yet supported.

24 hTemporary link lifetime
0 MP4Video files stored on Vercel
2.6+discord.py media layouts

Manual MP4 uploads and legacy /v/ links are disabled. Arbitrary file hosting requires a separate public media host and cannot be restored by relying on Vercel functions' temporary local disk. Links created here cannot revoke Discord attachments or external media URLs once someone has saved them.