# 🚀 Musixmatch Charts Scraper · 5,000 Free Songs/Month (`omkar-cloud/musixmatch-charts-scraper`) Actor

Musixmatch Charts Scraper gets you music charts ⚡ fast, 🎯 100% accurate and 🔍 ridiculously detailed — top, trending & weekly songs for any country, top artists and featured music, with full lyrics. 💰 $1 per 1,000 songs, no start fee. Scrape your first 5,000 songs free every month 🚀

- **URL**: https://apify.com/omkar-cloud/musixmatch-charts-scraper.md
- **Developed by:** [Omkar Cloud](https://apify.com/omkar-cloud) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 chart entry scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Musixmatch Charts Scraper

Musixmatch Charts Scraper by Omkar Cloud gets you 🎯 accurate, 🔍 detailed music charts from Musixmatch, the world's biggest lyrics catalog.

Every run reads the charts live — so you get today's top songs, what's trending right now and the most viewed songs of the week for any country, plus Musixmatch's featured music, and can successfully complete your project.

**$1 per 1,000 songs.** And with Apify's free plan you get $5 of credit every month, so your first **~5,000 songs each month are free**.

This is an excellent Actor made by Omkar Cloud, which is Rated Excellent — [4.7 based on 30 reviews on Trustpilot](https://www.trustpilot.com/review/omkar.cloud).

👉 [**Try Musixmatch Charts Scraper free**](https://apify.com/omkar-cloud/musixmatch-charts-scraper) — your first ~5,000 songs are Free.

### What can I get

- 📈 **4 song charts for any country** — Top Songs, Trending Now (last 2 hours), Most Viewed This Week and Most Viewed New Releases, in chart order with the rank
- 🎤 **Top artists per country** — with genres, socials, and Spotify, iTunes and MusicBrainz IDs
- ⭐ **Featured music** — Musixmatch's trending songs, top songs, weekly tops, top albums, top artists and songs with an official lyric video
- 💿 **Full song details** — album, cover art in four sizes, release date, genres, popularity, ISRCs, Spotify and iTunes IDs
- 📝 **Full lyrics on demand** — every chart song's lyrics, lines, stanzas, key line and writers (add-on)

### Why Musixmatch Charts Scraper

Most other chart scrapers fail you in one of four ways:

- 🧩 **Low-detail data** — a title and an artist, never the ISRC or the album
- 🌍 **One country only** — so you run it again and again
- 💸 **Pay more to get the same data** — start fees and tiers
- 🪦 **Works today, breaks next month** — nobody maintains it

Musixmatch Charts Scraper covers every country in one run, is priced honestly, and actively maintained.

### Example: A Chart Song

```json
{
  "chart": "top",
  "chart_name": "Top songs",
  "chart_country": "US",
  "rank": 1,
  "id": 465558508,
  "name": "Last Thing You Need (from GTAVI: The Album)",
  "link": "https://www.musixmatch.com/lyrics/Morgan-Wallen-Grand-Theft-Auto-VI/Last-Thing-You-Need-from-GTAVI-The-Album",
  "artist": { "name": "Morgan Wallen feat. Grand Theft Auto VI" },
  "album": { "name": "Last Thing You Need (from GTAVI: The Album)" },
  "release_date": "2026-09-17",
  "popularity": 99,
  "external_ids": { "isrc": "USAT22606601" },
  "has_lyrics": true,
  "lyrics": { "snippet": "Whenever you want the last thing you need", "line_count": 51 }
}
```

*Trimmed for readability.*

### Get Started with 5,000 Free Songs

1. [Hit **Try for Free Button**](https://apify.com/omkar-cloud/musixmatch-charts-scraper) — the input is pre-filled with the US and UK Top Songs and Trending Now charts.
2. Enjoy your data 😎.

### Pricing

High value, Low price.

| What | Price | What you get |
|---|---|---|
| **Chart rows** | **$1 per 1,000** | A chart song, top artist or featured album/artist with its rank or position and full details |
| **Lyrics** (optional) | **$2 per 1,000** | The song's full lyrics — only charged for songs that have lyrics |

No start fee, one flat price on every plan. Every Musixmatch chart holds about 90 songs, so one chart for one country costs about $0.09.

💡 Apify's free plan includes $5 of credit every month — about **5,000 free songs, every month**.

👉 [**Scrape your first 5,000 songs free**](https://apify.com/omkar-cloud/musixmatch-charts-scraper)

### FAQ

#### Which charts are there?

**Top Songs** is Musixmatch's editorial top chart; **Trending Now** is the most viewed lyrics of the last 2 hours; **Most Viewed This Week** covers the last 7 days; **Most Viewed New Releases This Week** is the same, new releases only. Pick any of them for every country you list.

#### Which countries work?

Any 2-letter country code (`US`, `GB`, `IN`, `DE`, `BR`, `JP`…). Rows carry `chart_country` so you can tell them apart.

#### What does it cost?

$0.001 per row — $1 per 1,000, flat on every plan, with no start fee. Lyrics add $0.002 per song that has them. Apify's free plan gives you $5 of credit every month, which is about 5,000 rows free every month.

### 💬 Have Questions? We Have Answers.

You're a business owner — we know how hard completing a project can be. So we offer full support: just message us and we'll reply ✅ with a solution within 1 working day.

[![Message Us on WhatsApp](https://raw.githubusercontent.com/omkarcloud/assets/master/images/whatsapp-us.png)](https://api.whatsapp.com/send?phone=918178804274\&text=I%20need%20help%20with%20using%20the%20Musixmatch%20Charts%20Scraper%20Actor.)

[![Ask Us on Email](https://raw.githubusercontent.com/omkarcloud/assets/master/images/ask-on-email.png)](mailto:happy.to.help@omkar.cloud?subject=Help%20with%20Musixmatch%20Charts%20Scraper%20Actor\&body=I%20need%20help%20with%20using%20the%20Musixmatch%20Charts%20Scraper%20Actor.)

You are important to us — just message us and we will solve your problem ✅ within 1 working day. 🩷 Pinky Promise 🤙!

### Popular Actors by Omkar Cloud

- [**Musixmatch Scraper**](https://apify.com/omkar-cloud/musixmatch-scraper) — full lyrics for any song, with translations, meanings & credits
- [**Musixmatch Artist Scraper**](https://apify.com/omkar-cloud/musixmatch-artist-scraper) — an artist's profile, every song and every album
- [**Deezer Scraper**](https://apify.com/omkar-cloud/deezer-scraper) — Deezer tracks, albums, artists, playlists & charts with ISRC and credits
- [**IMDb Scraper**](https://apify.com/omkar-cloud/imdb-scraper) — IMDb titles, charts, cast, ratings & box office
- [**Website Email Contact Scraper**](https://apify.com/omkar-cloud/website-email-contact-scraper) — emails, phones & socials from any website

👉 [**Scrape your first 5,000 songs free now**](https://apify.com/omkar-cloud/musixmatch-charts-scraper)

# Actor input Schema

## `countries` (type: `array`):

Countries whose charts to scrape, as 2-letter ISO codes (`US`, `GB`, `IN`, `DE`, `BR`, `JP`…), one per line.

## `charts` (type: `array`):

Which charts to scrape for every country: Top Songs (editorial top chart), Trending Now (most viewed lyrics in the last 2 hours), Most Viewed This Week, and Most Viewed New Releases This Week.

## `maxResults` (type: `integer`):

Maximum entries per chart (1–100; Musixmatch charts hold about 90 songs). 1,000 rows ≈ $1.

## `includeTopArtists` (type: `boolean`):

Also scrape each country's most popular artists, with genres, socials and external IDs.

## `includeFeatured` (type: `boolean`):

Also scrape Musixmatch's featured lists: trending songs, top songs, weekly tops for the US and Italy, top albums, top artists and songs with an official lyric video. Rows carry `section` and `position`.

## `includeLyrics` (type: `boolean`):

Add every chart song's full lyrics — lines, stanzas, language, key line, writers and copyright. $0.002 per song with lyrics.

## Actor input object example

```json
{
  "countries": [
    "US",
    "GB"
  ],
  "charts": [
    "top",
    "trending"
  ],
  "maxResults": 100,
  "includeTopArtists": false,
  "includeFeatured": false,
  "includeLyrics": false
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "countries": [
        "US",
        "GB"
    ],
    "charts": [
        "top",
        "trending"
    ],
    "maxResults": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("omkar-cloud/musixmatch-charts-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "countries": [
        "US",
        "GB",
    ],
    "charts": [
        "top",
        "trending",
    ],
    "maxResults": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("omkar-cloud/musixmatch-charts-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "countries": [
    "US",
    "GB"
  ],
  "charts": [
    "top",
    "trending"
  ],
  "maxResults": 100
}' |
apify call omkar-cloud/musixmatch-charts-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,omkar-cloud/musixmatch-charts-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/EVhaGAZarIyHMusFP/builds/QEIna9ZlbqRWqIaGT/openapi.json