hitd2

Unofficial Node.js wrapper for the Hitmo API (hitmo.me)

Search for music tracks, retrieve metadata, and extract MP3 audio URLs from hitmo sites.

Features

• Search tracks by query
• Get track metadata (title, artist, duration, cover image)
• Extract playable MP3 URLs
• Built-in retry with host failover (hitmos.fm, hitmoz.org)
• Caching via hcacher (configurable TTLs)
• TypeScript-first with full type definitions

Installation

npm install hitd2

Usage

import { HITApi } from "hitd2";

const api = new HITApi();

const tracks = await api.search("Дико например");
console.log(tracks);

const track = await api.getTrack(tracks[0].id);
const audio = await api.getAudio(tracks[0].id);

console.log(track, audio);

API

HITApi(options?)

| Option | Type | Default | Description | | --------------- | ------------- | ------- | ----------------------------------------- | | httpClient | HyperClient | — | Custom HTTP client instance | | sessionCookie | string | — | Session cookie for authenticated requests |

search(query, limit?)

Search for tracks. Returns TrackMeta[].

getTrack(trackId)

Get full metadata for a track. Returns TrackMeta.

getAudio(trackId)

Extract best MP3 audio URL from track page. Returns TrackAudio.

Types

interface TrackMeta {
  id: string;
  title: string;
  artist: string;
  duration: number; // seconds
  uri: string; // "hitmos:track:{id}"
  name: string;
  duration_ms: number;
  explicit: boolean;
  image?: string;
}

interface TrackAudio {
  id: string;
  url: string; // best MP3 URL
  format: string;
  files: TrackAudioFile[];
  urls: string[];
  expiresAt: number;
}

License

MIT