A lightweight tool that collects high-quality audio metadata and direct MP3 links from Zing MP3 pages. It helps developers and analysts turn Zing MP3 URLs into structured, usable music data without manual effort.
Created by Bitbash, built to showcase our approach to Scraping and Automation!
If you are looking for zing-mp3-downloader you've just found your team β Letβs Chat. ππ
This project extracts detailed audio information from Zing MP3 URLs, including metadata and high-quality download links. It solves the problem of manually collecting track details by automating data extraction in a clean, structured format. Itβs built for developers, data engineers, and music analysts who need reliable music metadata at scale.
- Designed specifically for Zing MP3 public pages
- Focuses on metadata quality and clarity
- Handles single or multiple URLs efficiently
- Produces clean, analysis-ready output
- Simple input and predictable results
| Feature | Description |
|---|---|
| Metadata extraction | Retrieves title, artist, duration, and thumbnails for each track. |
| High-quality audio links | Provides direct MP3 links, including 320kbps when available. |
| Batch processing | Processes multiple Zing MP3 URLs in one run. |
| Structured output | Returns results in consistent JSON records. |
| Error handling | Clearly flags inaccessible or unsupported URLs. |
| Field Name | Field Description |
|---|---|
| url | Original Zing MP3 URL provided as input. |
| title | Track or page title from Zing MP3. |
| thumbnail | Artwork or thumbnail image URL. |
| medias | Available audio streams with quality and format details. |
| quality | Audio bitrate or quality level (e.g., 320kbps). |
| extension | File format of the media, such as mp3. |
| duration | Track length in seconds. |
| error | Indicates whether the extraction failed. |
[
{
"url": "https://zingmp3.vn/nghe-si/SOOBIN",
"result": {
"url": "https://zingmp3.vn/nghe-si/SOOBIN",
"source": "zingmp3",
"title": "Zing MP3",
"thumbnail": "https://static-zmp3.zmdcdn.me/skins/common/logo600.png",
"medias": [
{
"url": "http://api.mp3.zing.vn/api/streaming/audio/SOOBIN/320",
"quality": "320p",
"extension": "mp3",
"type": "audio"
}
],
"type": "single",
"error": false,
"time_end": 330
}
}
]
Zing MP3 Downloader/
βββ src/
β βββ runner.py
β βββ extractors/
β β βββ zingmp3_parser.py
β β βββ media_utils.py
β βββ outputs/
β β βββ json_exporter.py
β βββ config/
β βββ settings.example.json
βββ data/
β βββ inputs.sample.json
β βββ output.sample.json
βββ requirements.txt
βββ README.md
- Music analysts use it to collect track metadata, so they can analyze trends and catalogs.
- Developers use it to build music-related apps with accurate Zing MP3 data.
- Content curators use it to organize libraries, so they can manage playlists efficiently.
- Researchers use it to gather structured music datasets for further study.
Does this work with all Zing MP3 links? It supports public Zing MP3 pages. Private or restricted content may not return results.
Can it download the audio files directly? The scraper provides direct download URLs, which can then be used by any download tool or script.
Is there a limit on how many URLs I can process? Multiple URLs are supported, but rate limiting is applied to ensure stable requests.
What format is the output in? Results are returned as structured JSON records, ready for storage or analysis.
Primary Metric: Processes one Zing MP3 URL per second on average under normal network conditions.
Reliability Metric: Achieves a success rate above 95% on public, non-restricted pages.
Efficiency Metric: Low memory footprint with minimal CPU usage during batch runs.
Quality Metric: Metadata completeness is consistently high, with titles, thumbnails, and audio links captured accurately.
