hmrt · API marketplace

Humfind

Identify a track from an audio URL or an audio file. Returns artist, title, album, year, and match confidence.

Auth

X-API-Key

Rate limit

60 requests / minute

Price

1 request · from $10 / 10,000, no expiry

Trial

250 free requests

Get API key

At zero remaining requests the gateway returns 402. Over the rate limit it returns 429.

Pricing

Lifetime plans for Humfind. Pay once — they do not renew or expire.

Starter

$10

10,000 requests

Never expires · not a monthly plan

10,000 requests. Never expires.

Subscribe · $10

Growth

$50

100,000 requests

Never expires · not a monthly plan

100,000 requests. Never expires.

Subscribe · $50

Unlimited

$100

200,000 requests

Never expires · not a monthly plan

200,000 requests. Never expires.

Subscribe · $100

First request

Replace $HUMARKET_KEY with a key from the dashboard.

Recognize from an audio URL

curl "https://api.hmrt.miniscue.live/v1/humfind/recognize/url?url=https://www.hitxgh.com/php_system/uploads/2025/10/Larruso__-_Dark_Skin_Ft_Stonebwoy__www_hitxgh_com_.mp3" \
  -H "X-API-Key: $HUMARKET_KEY"

Recognize from an audio file

curl -X POST "https://api.hmrt.miniscue.live/v1/humfind/recognize/file" \
  -H "X-API-Key: $HUMARKET_KEY" \
  -F "file=@track.mp3"

Try it

Send a request from this page

GET /v1/humfind/recognize/url

API key

Audio URL

Uses your key from this browser. A 402 means the request quota is gone or invalidated. A 429 means wait for the rate limit.

Humfind

Identify a song from an audio URL or by uploading audio. Call the hmrt gateway only. Do not send origin hostnames or origin auth headers.

Auth

X-API-Key: hmk_live_...

Recognize from an audio URL

GET /v1/humfind/recognize/url

Query	Required	Description
`url`	yes	Direct URL to an audio file

curl "https://api.hmrt.miniscue.live/v1/humfind/recognize/url?url=https://www.hitxgh.com/php_system/uploads/2025/10/Larruso__-_Dark_Skin_Ft_Stonebwoy__www_hitxgh_com_.mp3" \
  -H "X-API-Key: $HUMARKET_KEY"

Recognize from an audio file

POST /v1/humfind/recognize/file

Multipart field file (raw audio).

curl -X POST "https://api.hmrt.miniscue.live/v1/humfind/recognize/file" \
  -H "X-API-Key: $HUMARKET_KEY" \
  -F "file=@track.mp3"

Response

Both recognize endpoints return a JSON array:

[
  {
    "artist": "Artist",
    "title": "Track title",
    "album": "Album",
    "year": "2024",
    "track_id": "abc123",
    "match_confidence": 0.92,
    "match_percent": 92,
    "match": true
  }
]

Field	Type	Meaning
`artist`	string	Matched artist
`title`	string	Track title
`album`	string	Album name
`year`	string	Release year
`track_id`	string	Upstream track id
`match_confidence`	number \	null	Score when present
`match_percent`	integer \	null	Percent when present
`match`	boolean	Whether a track was matched