# DrishtiAPI Cloud

> High-performance developer APIs for streaming media, Nepali news feeds, dynamic EMVCo payment QR generation, and multimedia search. Fast, caching-optimized, and developer-friendly.

Website: https://api.sushil0.com.np
API Base URL: https://api.sushil0.com.np
Telegram Key & Billing Bot: https://t.me/DrishtiapiBot
Support Contact: @Mister_unnone on Telegram

## Overview

DrishtiAPI Cloud delivers production-grade APIs designed for web apps, mobile applications, Flutter, React Native, and server-side automation.

All APIs use standard JSON payloads and support authentication via either the `x-api-key` header or the `?api_key=` query parameter. Every registered developer gets 100 lifetime free requests for evaluation. Paid subscriptions provide unlimited requests with 1-month or 1-year terms. Localhost and 127.0.0.1 testing is always free and unlimited.

## Available APIs

- [Nepali News Hub API](https://api.sushil0.com.np/docs/nepali-news.html): Live curated news feed from 15+ top Nepali portals (OnlineKhabar, Ekantipur, Setopati, Ratopati, Nagarik, Hamropatro, BBC Nepali, etc.). Filter by portal or category with instant full-text search.
- [Dual-Network Payment QR API](https://api.sushil0.com.np/docs/payment-qr.html): Generate official EMVCo-compliant QR payloads for Fonepay and NepalPay. Generates mobile banking deep links and SVG QR codes for instant merchant checkouts.
- [JioSaavn 320kbps Music API](https://api.sushil0.com.np/docs/jiosaavn-music.html): High-fidelity Indian and Bollywood music search with automated DES-ECB decryption returning direct 320kbps MP3 and MP4 streams with cached responses.
- [Apple iTunes Media Search API](https://api.sushil0.com.np/docs/itunes-search.html): Global catalog search covering songs, podcasts, albums, movies, and audiobooks with 30-second previews and high-resolution album artwork.
- [Audius Decentralized Music API](https://api.sushil0.com.np/docs/audius-music.html): Web3 decentralized music discovery engine. Query trending indie tracks, electronic artists, streaming MP3 streams, and genre leaderboards without rate limits.
- [All-In-One Video Downloader API](https://api.sushil0.com.np/docs/video-downloader.html): Extract direct high-resolution video streams and MP3 audio from YouTube, TikTok, Facebook, Instagram, Twitter/X, and Pinterest. (Hosted on downloader.sushil0.com.np).

## Authentication & Headers

Authentication is required for production usage:
- Header: `x-api-key: your_api_key_here`
- Query Parameter: `?api_key=your_api_key_here`

For browser frontend apps, the Origin or Referer header is validated against your licensed domains registered via `/setdomain` in the Telegram bot.

## Core Endpoints

### 1. Nepali News Hub
- Endpoints:
  - `GET /v1/news/latest`: Latest breaking feeds
  - `GET /v1/news/categories`: Complete catalog of supported English categories
- Query Params for `/v1/news/latest`:
  - `portal` (optional): Filter by portal slug (e.g. `onlinekhabar`, `ekantipur`, `setopati`, `ratopati`)
  - `category` (optional): Filter by canonical English category slug: `news`, `business`, `nepse`, `politics`, `sports`, `tech`, `health`, `education`, `entertainment`, `tourism`, `opinion`, `international`, `provinces`
  - `q` (optional): Full-text search keyword
  - `limit` (optional): Number of items (default 10, max 50)
- Sample Request:
  `curl -H "x-api-key: YOUR_KEY" "https://api.sushil0.com.np/v1/news/latest?category=business&limit=5"`

### 2. Dual-Network Payment QR
- Endpoint: `POST /v1/checkout/generate-qr`
- Request Body (JSON):
  - `amount` (number, required): Transaction amount in NPR
  - `remarks` (string, required): Order or bill reference
  - `merchant_id` (string, optional): Fonepay merchant identifier
- Response includes EMVCo string payload, base64 QR code image, and mobile banking deep links for eSewa, Khalti, and IME Pay.

### 3. JioSaavn 320kbps Music
- Endpoint: `GET /v1/music/song`
- Query Params:
  - `query` (required): Song name, artist, or movie title
- Response includes metadata, album art, duration, and decrypted direct streaming links (`bitrate_320kbps`, `bitrate_160kbps`, `bitrate_96kbps`).

### 4. Apple iTunes Search
- Endpoint: `GET /v1/itunes/search`
- Query Params:
  - `term` (required): Search keyword
  - `media` (optional): `music`, `podcast`, `movie`, `audiobook`
  - `limit` (optional): Results count (1-50)

### 5. Audius Decentralized Music
- Endpoint: `GET /v1/audius/tracks/trending`
- Query Params:
  - `genre` (optional): Music genre filter
  - `time` (optional): `week`, `month`, `allTime`

## Pricing & Key Acquisition

Key generation and subscriptions are managed exclusively through Telegram via `@DrishtiapiBot`:
- Free Starter: 100 lifetime requests (Localhost and 127.0.0.1 are always free & unlimited).
- Individual APIs:
  - JioSaavn Music: NPR 199 / month | NPR 1,599 / year
  - Nepali News: NPR 199 / month | NPR 1,599 / year
  - Nepal Payment QR: NPR 299 / month | NPR 2,399 / year
  - Apple iTunes: NPR 149 / month | NPR 1,199 / year
  - Audius Music: NPR 149 / month | NPR 1,199 / year
- 5-in-1 Master Bundle: NPR 399 / month | NPR 2,999 / year (Includes unlimited requests to all 5 APIs).
- Multi-Domain Licensing:
  - Standard: 1 live domain included
  - Add-on: +NPR 99/mo per additional domain
  - Freelancer Pack: 5 domains (+NPR 249/mo)
  - Agency Pack: Unlimited domains (2x base price)

Developers pay via eSewa, Khalti, or Fonepay QR in the bot, submit their receipt screenshot, and receive an instant cryptographically secure API key upon 1-tap admin review.