Metadata-Version: 2.1
Name: musicxmatch-api
Version: 1.0.0
Summary: Extract lyrics from MusicXMatch API, for free.
Home-page: https://github.com/tomchen/example_pypi_package
Author: Roméo Phillips
Author-email: phillipsromeo@gmail.com
Project-URL: Documentation, https://github.com/Strvm/MusicXMatchAPI
Project-URL: Bug Reports, https://github.com/Strvm/MusicXMatchAPI
Project-URL: Source Code, https://github.com/Strvm/MusicXMatchAPI
Keywords: lyrics,songs,music,musicxmatch,api,musicxmatch-api,musicxmatch-api-python
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Provides-Extra: dev

# MusicXMatch API

Musixmatch is the world's largest catalog of song lyrics and translations. The service is used by millions of people around the world to find lyrics for songs playing around them, to translate lyrics, and to get the facts behind the songs.

# What is this?

This is a Python wrapper for the [Musixmatch API](https://developer.musixmatch.com/). It uses the community API key to make requests to the API. These requests have the the same access as a **[Plus](https://developer.musixmatch.com/plans)** plan but for **free**.

# What can I access?

You can basically query for any lyrics and translation from their API, a more detailed list can be viewed here: [Musixmatch API Documentation](https://developer.musixmatch.com/documentation).

# How do I use it?

First, you need to install the package:

```bash
pip install musicxmatch_api
```

# Examples

Search for artists
```python
    # If you need to make a high volume of requests, consider using proxies
    api = MusixMatchAPI(proxies=proxies)
    search = api.search_artist("eminem")
```

Search for songs
```python
    # If you need to make a high volume of requests, consider using proxies
    api = MusixMatchAPI(proxies=proxies)
    search = api.search_tracks("eminem")
```

Search for a specific song
```python
    # If you need to make a high volume of requests, consider using proxies
    api = MusixMatchAPI(proxies=proxies)
    search = api.get_track(track_id=15445219)
```


# Disclaimer

The content provided herein is intended strictly for educational purposes. Any misuse or abuse of this information that contradicts this purpose, including but not limited to the unauthorized distribution, reproduction, or alteration of content, or the use of information for illicit activities, is strictly prohibited and may constitute a violation of applicable laws and regulations. This could lead to serious consequences including legal action. Educational resources are to be used responsibly, ethically, and with integrity. We reserve the right to restrict access to these resources for anyone found violating these terms.
