>> API ONLINE <<
A clean JSON API for music search, metadata, and download tools. Manual billing, fast activation, and WhatsApp support.
Search artists and tracks with clean JSON payloads and lightweight responses.
Fetch metadata and direct download links with predictable structures.
Use /api/track/:id/download with API keys for protected access.
HOSTED API
SELF-HOST ZIP
Everything here matches the live API. Use the live response panel to grab a real track id.
Base URL
https://api.wavik.site/api
All paths below are relative to the base URL.
Search endpoints are public. Downloads require a key.
/api/track/:id/download returns metadata by default. Add file=1 to stream the file.
Thumbnails are proxied through /api/thumb/:id and cached.
Authentication
x-api-key: YOUR_KEY (recommended)Authorization: Bearer YOUR_KEY?key=YOUR_KEY or ?api_key=YOUR_KEYMissing keys return 401. Expired keys return 403.
Endpoints
GET /search?q=QUERY - Search tracks. Returns id, title, duration, thumbnail.GET /search?q=QUERY&downloads=1 - Adds download metadata for the first 5 results.GET /track/:id - Track metadata + download options (no direct URLs).GET /track/:id/download - Requires key. Use file=1 to stream the file.GET /thumb/:id - Proxied thumbnail image.GET /trending - Trending tracks.GET /trending?category=pop - Trending by category.GET /category?name=pop - Browse a category.GET /top-search - Top search queries.GET /categories - Available categories.GET /song?url=... - Legacy song details (deprecated).GET /download?url=... - Legacy download (deprecated, requires key). Optional id.Download flow (real)
# 1) Search and grab an id from the response curl "https://api.wavik.site/api/search?q=adele+hello" # 2) Track metadata curl "https://api.wavik.site/api/track/ID_FROM_SEARCH" # 3) Stream the file (requires key) curl -H "x-api-key: YOUR_KEY" "https://api.wavik.site/api/track/ID_FROM_SEARCH/download?file=1&filename=Wavik-Download"
Replace ID_FROM_SEARCH with a real id from the live response.
Response shape
{
"success": true,
"data": { "id": "...", "title": "...", "duration": "3:45" },
"meta": { "total": 18 }
}
Download entries include type, label, size (no direct URLs).
Quick calls
GET https://api.wavik.site/api/search?q=adele+hello
GET https://api.wavik.site/api/track/ID_FROM_SEARCH
GET https://api.wavik.site/api/track/ID_FROM_SEARCH/download?file=1&key=YOUR_KEY
Live response (trimmed)
Loading...