API to get titel from upload/*.mid

[h3tz]

Hi there,

i would like to request an api to get the mid title from a given .mid available from /uploads/.mid.
Or is there already a meca available?

[Reinissance]

Interested too, in order to query searches for my negative harmony player which is capable to link against your midi files thanks to your CORS settings like this. BTW many thanks for this!

[bassklampfe]

What you ask for, is the "get" api query
https://bitmidi.com/api/midi/get?id=77261
In the json response is everything you need

{
  "result": {
    "query": {
      "id": "77261",
      "select": [
        "id",
        "name",
        "slug",
        "alternateNames",
        "views",
        "plays",
        "createdAt",
        "updatedAt"
      ]
    },
    "result": {
      "id": 77261,
      "name": "Mythos & DJ Cosmo - Unchained Melody.mid",
      "slug": "mythos-and-dj-cosmo-unchained-melody-mid",
      "alternateNames": [
        "Mythos__DJ_Cosmo_-_Unchained_Melody__DJ_TranceStorm_20101013174722.mid"
      ],
      "views": 6923,
      "plays": 1467,
      "createdAt": "2018-07-13 20:10:09",
      "updatedAt": "2025-05-29 19:17:40",
      "url": "/mythos-and-dj-cosmo-unchained-melody-mid",
      "downloadUrl": "/uploads/77261.mid"
    },
    "related": [
      {
        "id": 70811,
        "name": "M.BROTHERS.Unchained melody.mid",
        "slug": "m-brothers-unchained-melody-mid",
        "alternateNames": null,
        "views": 10975,
        "plays": 2982,
        "createdAt": "2018-07-13 20:10:09",
        "updatedAt": "2025-05-29 19:09:36",
        "url": "/m-brothers-unchained-melody-mid",
        "downloadUrl": "/uploads/70811.mid"
      },
      {
        "id": 101758,
        "name": "THE RIGHTEOUS BR.Unchained melody.MID",
        "slug": "the-righteous-br-unchained-melody-mid",
        "alternateNames": null,
        "views": 10422,
        "plays": 2223,
        "createdAt": "2018-07-13 20:10:09",
        "updatedAt": "2025-05-29 23:09:50",
        "url": "/the-righteous-br-unchained-melody-mid",
        "downloadUrl": "/uploads/101758.mid"
      },
      {
        "id": 107028,
        "name": "Unchained-Melody-(Piano).mid",
        "slug": "unchained-melody-piano-mid",
        "alternateNames": null,
        "views": 11194,
        "plays": 2855,
        "createdAt": "2018-07-13 20:10:09",
        "updatedAt": "2025-05-29 20:49:37",
        "url": "/unchained-melody-piano-mid",
        "downloadUrl": "/uploads/107028.mid"
      },
      {
        "id": 107029,
        "name": "Unchained-Melody-1.mid",
        "slug": "unchained-melody-1-mid",
        "alternateNames": null,
        "views": 8563,
        "plays": 2228,
        "createdAt": "2018-07-13 20:10:09",
        "updatedAt": "2025-05-29 21:51:24",
        "url": "/unchained-melody-1-mid",
        "downloadUrl": "/uploads/107029.mid"
      },
      {
        "id": 107030,
        "name": "Unchained-Melody-2.mid",
        "slug": "unchained-melody-2-mid",
        "alternateNames": null,
        "views": 25914,
        "plays": 6772,
        "createdAt": "2018-07-13 20:10:09",
        "updatedAt": "2025-05-29 19:55:38",
        "url": "/unchained-melody-2-mid",
        "downloadUrl": "/uploads/107030.mid"
      }
    ]
  }
}

[Reinissance]

Sure, thanks for the hint.

Though it's a different topic let me ask if there is also a way to query a search for all titles containing "summer" for example (like on your site), - would be awesome to be able to be able to access your db that way...

Regards

[bassklampfe]

(like on your site)

Let me make this clear. This is NOT my site, it belongs to feross. I'm just able to read some of the code (especially src/api/midi.js ) to understand the api

query a search for all titles containing "summer" for example

https://bitmidi.com/api/midi/search?q=summer
returns

{
  "result": {
    "query": {
      "q": "summer",
      "page": 0,
      "pageSize": 15,
      "select": [
        "id",
        "name",
        "slug",
        "alternateNames",
        "views",
        "plays",
        "createdAt",
        "updatedAt"
      ]
    },
    "results": [
      {
        "id": 97881,
        "name": "Summer-Summer-Lady.mid",
        "slug": "summer-summer-lady-mid",
        "alternateNames": null,
        "views": 9934,
        "plays": 3336,
        "createdAt": "2018-07-13 20:10:09",
        "updatedAt": "2025-05-29 20:50:45",
        "url": "/summer-summer-lady-mid",
        "downloadUrl": "/uploads/97881.mid"
      },
      {
        "id": 1367,
        "name": "4 Strings - Summer Sun (Ibiza Mix).mid",
        "slug": "4-strings-summer-sun-ibiza-mix-mid",
        "alternateNames": ["4Strings-SummerSun(IbizaMix)__SYQ.mid"],
        "views": 8814,
        "plays": 2014,
        "createdAt": "2018-07-13 20:10:09",
        "updatedAt": "2025-05-30 00:51:27",
        "url": "/4-strings-summer-sun-ibiza-mix-mid",
        "downloadUrl": "/uploads/1367.mid"
      },
      {
        "id": 2964,
        "name": "A HA.Summer moved on K.mid",
        "slug": "a-ha-summer-moved-on-k-mid",
        "alternateNames": null,
        "views": 4206,
        "plays": 680,
        "createdAt": "2018-07-13 20:10:09",
        "updatedAt": "2025-05-30 06:10:15",
        "url": "/a-ha-summer-moved-on-k-mid",
        "downloadUrl": "/uploads/2964.mid"
      },
      {
        "id": 3157,
        "name": "A-Summer-Place.mid",
        "slug": "a-summer-place-mid",
        "alternateNames": null,
        "views": 7145,
        "plays": 1278,
        "createdAt": "2018-07-13 20:10:09",
        "updatedAt": "2025-05-29 19:17:11",
        "url": "/a-summer-place-mid",
        "downloadUrl": "/uploads/3157.mid"
      },
      {
        "id": 3443,
        "name": "ABBA.Summer night city.mid",
        "slug": "abba-summer-night-city-mid",
        "alternateNames": null,
        "views": 7458,
        "plays": 1042,
        "createdAt": "2018-07-13 20:10:09",
        "updatedAt": "2025-05-29 19:15:47",
        "url": "/abba-summer-night-city-mid",
        "downloadUrl": "/uploads/3443.mid"
      },
      {
        "id": 3665,
        "name": "ACE OF BASE.Cruel summer K.mid",
        "slug": "ace-of-base-cruel-summer-k-mid",
        "alternateNames": null,
        "views": 9489,
        "plays": 1251,
        "createdAt": "2018-07-13 20:10:09",
        "updatedAt": "2025-05-30 05:30:39",
        "url": "/ace-of-base-cruel-summer-k-mid",
        "downloadUrl": "/uploads/3665.mid"
      },
      {
        "id": 3861,
        "name": "ADAMS.Summer of 69 K.mid",
        "slug": "adams-summer-of-69-k-mid",
        "alternateNames": null,
        "views": 6892,
        "plays": 1242,
        "createdAt": "2018-07-13 20:10:09",
        "updatedAt": "2025-05-30 06:16:41",
        "url": "/adams-summer-of-69-k-mid",
        "downloadUrl": "/uploads/3861.mid"
      },
      {
        "id": 4573,
        "name": "Airwave - Summer In.mid",
        "slug": "airwave-summer-in-mid",
        "alternateNames": ["Airwave_-_Summer_In__MX24_20100323221751.mid"],
        "views": 3424,
        "plays": 471,
        "createdAt": "2018-07-13 20:10:09",
        "updatedAt": "2025-05-29 16:16:50",
        "url": "/airwave-summer-in-mid",
        "downloadUrl": "/uploads/4573.mid"
      },
      {
        "id": 6456,
        "name": "Andain - Summer Calling (Airwave Club Mix).mid",
        "slug": "andain-summer-calling-airwave-club-mix-mid",
        "alternateNames": [
          "andain__summer_calling__airwave_club_mix__zoik.mid"
        ],
        "views": 5313,
        "plays": 575,
        "createdAt": "2018-07-13 20:10:09",
        "updatedAt": "2025-05-29 16:15:23",
        "url": "/andain-summer-calling-airwave-club-mix-mid",
        "downloadUrl": "/uploads/6456.mid"
      },
      {
        "id": 7253,
        "name": "APHRODITE'S CHILD.Spring,summer winter and fall K.mid",
        "slug": "aphrodites-child-springsummer-winter-and-fall-k-mid",
        "alternateNames": null,
        "views": 7245,
        "plays": 1031,
        "createdAt": "2018-07-13 20:10:09",
        "updatedAt": "2025-05-30 04:40:53",
        "url": "/aphrodites-child-springsummer-winter-and-fall-k-mid",
        "downloadUrl": "/uploads/7253.mid"
      },
      {
        "id": 7636,
        "name": "Armin van Buuren fear. Ana Criado - Suddenly summer (piano).mid",
        "slug": "armin-van-buuren-fear-ana-criado-suddenly-summer-piano-mid",
        "alternateNames": [
          "ArminvanBuurenfearAnaCriado_-_Suddenlysummerpiano__Subject16_20120328181741.mid"
        ],
        "views": 11498,
        "plays": 3521,
        "createdAt": "2018-07-13 20:10:09",
        "updatedAt": "2025-05-29 19:08:02",
        "url": "/armin-van-buuren-fear-ana-criado-suddenly-summer-piano-mid",
        "downloadUrl": "/uploads/7636.mid"
      },
      {
        "id": 15610,
        "name": "BanjoKazooie - Click Clock Wood Summer.mid",
        "slug": "banjokazooie-click-clock-wood-summer-mid",
        "alternateNames": null,
        "views": 3452,
        "plays": 667,
        "createdAt": "2018-07-13 20:10:09",
        "updatedAt": "2025-05-29 20:14:57",
        "url": "/banjokazooie-click-clock-wood-summer-mid",
        "downloadUrl": "/uploads/15610.mid"
      },
      {
        "id": 19469,
        "name": "Boys Be - Early Summer II.mid",
        "slug": "boys-be-early-summer-ii-mid",
        "alternateNames": null,
        "views": 3650,
        "plays": 486,
        "createdAt": "2018-07-13 20:10:09",
        "updatedAt": "2025-05-30 06:14:01",
        "url": "/boys-be-early-summer-ii-mid",
        "downloadUrl": "/uploads/19469.mid"
      },
      {
        "id": 19477,
        "name": "Boys-Of-Summer-1.mid",
        "slug": "boys-of-summer-1-mid",
        "alternateNames": null,
        "views": 6126,
        "plays": 880,
        "createdAt": "2018-07-13 20:10:09",
        "updatedAt": "2025-05-30 05:37:46",
        "url": "/boys-of-summer-1-mid",
        "downloadUrl": "/uploads/19477.mid"
      },
      {
        "id": 19478,
        "name": "Boys-Of-Summer-2.mid",
        "slug": "boys-of-summer-2-mid",
        "alternateNames": null,
        "views": 5550,
        "plays": 839,
        "createdAt": "2018-07-13 20:10:09",
        "updatedAt": "2025-05-30 03:39:13",
        "url": "/boys-of-summer-2-mid",
        "downloadUrl": "/uploads/19478.mid"
      }
    ],
    "total": 108,
    "pageTotal": 8
  }
}

with https://bitmidi.com/api/midi/search?page=1&q=summer you'll get the next page of results

[Reinissance]

OMG, that simple, thanks for your help 🤦‍♂️