API Documentation Portal | AloneMusic API

Authentication & Usage Guidelines

All authenticated endpoints require an active API key passed as a query parameter api_key=YOUR_API_KEY or within path routes.

Base Production URL: https://api.riteshyt.in | Web Portal: https://yt.riteshyt.in

30-Day Free API Keys

Generated instantly on the Developer Dashboard or via Telegram Bot command /generate. Format prefix: riteshfree...

Permanent Lifetime Keys

Unlimited lifetime keys issued by administrators. Format prefix: riteshprantly... or ritesh_unlimited...

GET Multi-Platform Media Extractor

Extract rich metadata, direct video/audio stream URLs, thumbnails, and multiple resolution formats from 28+ social media and streaming platforms.

GET /api/platform/extract?url={platform_url}&api_key={api_key}

Aliases: /api/extract, /api/get, /api/universal, /api/all, /get, /media

Parameter	Type	Presence	Description
`url`	string	Required	Target media URL (Reels, TikTok, Spotify track, Pins, Shorts, Tweets, etc.)
`api_key`	string	Optional	Your active API Key

Supported Platforms (100+):

YouTubeInstagram (Reels/Posts) TikTok (No Watermark)Spotify JioSaavnSoundCloud Apple MusicGaana DeezerResso TidalTwitter / X PinterestReddit FacebookThreads SnapchatDailymotion VimeoBandcamp MixcloudVK (VKontakte) RumbleStreamable AudiomackOK.ru CoubDouyin KuaishouTriller NiconicoOdysee / LBRY 9GAGLikee NewgroundsFlickr IzleseneSmugMug BitChuteVeoh ImgurLoom WistiaTrovo WeiboRutube TED TalksInternet Archive HearThis.atJamendo ReverbNationAudius BoomplayAnghami WynkHungama YoukuiQIYI XiaohongshuPeertube AfreecaTVArtStation DeviantArtPixiv BehanceDribbble UnsplashPexels PixabayGiphy TenorNapster KugouKuwo QQ MusicNetEase Red Bull TViHeartRadio TuneInPandora Last.fmGenius TeraboxTwitch KickBilibili MXPlayerBluesky LinkedInTumblr MastodonIMDb

Example JSON Response:

{
  "success": true,
  "platform": "instagram",
  "id": "Cx123456789",
  "title": "Instagram Reel Video",
  "description": "Trending reel audio video",
  "thumbnail": "https://instagram.fdel...",
  "duration": 30,
  "media_type": "video",
  "download_url": "/api/platform/stream?url=https%3A%2F%2Finstagram.fdel...",
  "formats": [
    {
      "format_id": "mp4_1080p",
      "type": "video",
      "url": "/api/platform/stream?url=https%3A%2F%2Finstagram.fdel...",
      "quality": "1080p",
      "ext": "mp4",
      "bitrate": 3200000,
      "has_audio": true
    }
  ]
}

curl -X GET "https://api.riteshyt.in/api/platform/extract?url=https://www.instagram.com/reel/Cxxxx/&api_key=YOUR_API_KEY"

import requests

url = "https://api.riteshyt.in/api/platform/extract"
params = {
    "url": "https://www.instagram.com/reel/Cxxxx/",
    "api_key": "YOUR_API_KEY"
}
response = requests.get(url, params=params)
data = response.json()
print("Download URL:", data.get("download_url"))

async function extractMedia() {
  const url = "https://api.riteshyt.in/api/platform/extract?url=https://www.instagram.com/reel/Cxxxx/&api_key=YOUR_API_KEY";
  const res = await fetch(url);
  const data = await res.json();
  console.log(data);
}

GET Search Endpoint

Search YouTube for tracks and videos with ultra-fast InnerTube lookup (<500ms) and yt-dlp fallbacks.

GET /search?q={query}&limit={limit}&api_key={api_key}

Parameter	Type	Presence	Description
`q` / `query`	string	Required	Search string, song title, or YouTube video URL
`limit`	integer	Optional	Max results to return (Default: 1, Max: 20)
`api_key`	string	Required	Your active API Key

Example JSON Response:

{
  "result": [
    {
      "type": "video",
      "id": "dQw4w9WgXcQ",
      "title": "Rick Astley - Never Gonna Give You Up (Official Music Video)",
      "duration": "3:33",
      "thumbnails": [
        { "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg" }
      ],
      "link": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
      "channel": { "name": "Rick Astley" },
      "viewCount": { "short": "1.5B", "text": "1,500,000,000 views" },
      "publishedTime": "14 years ago"
    }
  ]
}

curl -X GET "https://api.riteshyt.in/search?q=Kesariya&limit=5&api_key=YOUR_API_KEY"

import httpx

response = httpx.get("https://api.riteshyt.in/search", params={
    "q": "Kesariya",
    "limit": 5,
    "api_key": "YOUR_API_KEY"
})
results = response.json().get("result", [])
for item in results:
    print(f"{item['title']} - {item['id']}")

fetch("https://api.riteshyt.in/search?q=Kesariya&limit=5&api_key=YOUR_API_KEY")
  .then(res => res.json())
  .then(data => console.log(data.result));

GET Stream & Download Endpoint

Stream or download MP3 audio and MP4 video media with full HTTP 206 Range headers support for instantaneous seeking.

GET /download?query={query}&dl_type={audio|video}&quality={720}&api_key={api_key}

Parameter	Type	Presence	Description
`query`	string	Required	Video ID (11 chars), YouTube URL, Spotify URL, or search query
`dl_type`	string	Optional	`audio` (default MP3) or `video` (MP4)
`quality`	integer	Optional	Video resolution (e.g. `360`, `720`, `1080`). Default: 720
`api_key`	string	Required	Your active API Key

Direct Stream URL Paths (Alias):

GET /downloads/{api_key}/youtube.com/{vidid}.mp3

GET /downloads/{api_key}/youtube.com/{vidid}.mp4?quality=720

# Stream MP3 Audio directly
curl -L -o song.mp3 "https://api.riteshyt.in/download?query=dQw4w9WgXcQ&dl_type=audio&api_key=YOUR_API_KEY"

# Stream 720p MP4 Video
curl -L -o video.mp4 "https://api.riteshyt.in/download?query=dQw4w9WgXcQ&dl_type=video&quality=720&api_key=YOUR_API_KEY"

import requests

url = "https://api.riteshyt.in/download"
params = {
    "query": "dQw4w9WgXcQ",
    "dl_type": "audio",
    "api_key": "YOUR_API_KEY"
}
response = requests.get(url, params=params, stream=True)
with open("audio.mp3", "wb") as f:
    for chunk in response.iter_content(chunk_size=65536):
        f.write(chunk)

const audio = new Audio("https://api.riteshyt.in/downloads/YOUR_API_KEY/youtube.com/dQw4w9WgXcQ.mp3");
audio.play();

GET Video Details Endpoint

Retrieve single video or Spotify track metadata including duration (seconds and string format), title, thumbnail URL, and exact video ID.

GET /details?link={link_or_id}&api_key={api_key}

Parameter	Type	Presence	Description
`link` / `id`	string	Required	YouTube Video URL, 11-char Video ID, or Spotify Track URL
`api_key`	string	Required	Your active API Key

Example JSON Response:

{
  "title": "Rick Astley - Never Gonna Give You Up",
  "duration_min": "03:33",
  "duration_sec": 213,
  "thumbnail": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
  "vidid": "dQw4w9WgXcQ",
  "link": "https://youtu.be/dQw4w9WgXcQ"
}

GET Playlist Endpoint

Extract videos and tracks from YouTube Playlists, Spotify Playlists, Albums, or Artist top tracks.

GET /playlist?link={playlist_url_or_id}&limit={limit}&api_key={api_key}

Parameter	Type	Presence	Description
`link` / `id`	string	Required	YouTube Playlist URL/ID or Spotify Playlist/Album/Artist URL
`limit`	integer	Optional	Max items to fetch (Default: 10)
`api_key`	string	Required	Your active API Key

Example JSON Response:

{
  "videos": [
    {
      "vidid": "dQw4w9WgXcQ",
      "title": "Rick Astley - Never Gonna Give You Up",
      "duration_min": "03:33",
      "duration_sec": 213,
      "thumbnail": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg"
    }
  ]
}

GET Technical Video Info Endpoint

Get technical format lists, resolutions, and media metadata for YouTube video IDs.

GET /video_info?vidid={vidid}&api_key={api_key}

Parameter	Type	Presence	Description
`vidid`	string	Required	11-character YouTube Video ID
`api_key`	string	Required	Your active API Key

GET MusicBot Audio Redirect Endpoint

Dedicated high-speed audio redirect URL engineered for Pyrogram/Telethon Telegram music bots (Yukki, Yukon, Aviax, Fallen, Alone, etc.).

GET /api/musicbot/play/{vidid}?api_key={api_key}

GET System Health Check

Check API service status and health uptime.

GET /health

{ "status": "ok" }

AloneMusic API Reference & Documentation

Authentication & Usage Guidelines

30-Day Free API Keys

Permanent Lifetime Keys

GET Multi-Platform Media Extractor

GET Search Endpoint

GET Stream & Download Endpoint

GET Video Details Endpoint

GET Playlist Endpoint

GET Technical Video Info Endpoint

GET MusicBot Audio Redirect Endpoint

GET System Health Check