Dunya API
We provide an API to give access to the content collected and created as part of the CompMusic project
You can find documentation on how to access the API on our documentation page In order to use the documentation you must use an API token which identifies your user. After signing up for a user account you can find your API token on your user account page.
Examples
We have published a selection of demo code that shows how to use parts of the Dunya API for analysis of the content. All of these examples are written in Python using Jupyter notebooks to present the code and results.- andalusian-corpus-notebooks: An analysis of the Arab-Andalusian corpus
- Ismir2018TutorialNotebooks: Demos used in a tutorial "Computational approaches for analysis of non-Western music traditions"
- Jingju-Dunya-Notebook: An analysis of the Jingju music corpus
Permissions
We make some content available only to academic researchers who wish to reuse it for additional research.
We generate the following classes of data
- Metadata
- Descriptive information about the music in each collection
- Audio
- Audio recordings of music in each collection
- Additional files
- Additional files collected during the project (scores, lyrics)
- Automatically created files
- Information generated by algorithms created by researchers during the CompMusic project
| Metadata | Audio | Additional files | Automatically created files | |
|---|---|---|---|---|
| Carnatic | open | restricted | open | open |
| Carnatic CC collection | open | open | open | open |
| Hindustani | open | restricted | open | open |
| Hindustani CC collection | open | open | open | open |
| Makam | open | restricted | open | open |
| Arab Andalusian | open | open | open | open |
| Jingju | open | restricted | restricted | open |
Items in the open category can be accessed by any user with an API token. If you wish to use any of the items that are in a restricted category then you should send a request from your profile page explaining your academic affiliation and why you wish to use this content. After approving your request you will be able to access the content with your existing API token.