We have updated our Search for Tracks endpoint to add several new filters inside a new ai_analysis parameter.

Those new filters are the following :

Here is a sample cURL request to show how to use it:

curl --request POST \
  --url 'https://reprtoir.io/api/tracks/search?search_mode=basic&search_by_similarity[search_mode]=mostRepresentative&search_by_similarity[source]=track&sort_field=_score&sort_order=desc&page=1&per_page=10' \
  --header 'X-API-Key: YOUR API KEY HERE' \
  --header 'X-API-Version: 2024-04-11' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '
{
  "ai_analysis": {
    "emotional_profile": [
      "positive"
    ],
    "predominant_voice_gender": [
      "female"
    ]
  }
}
'

As we added new Artist roles (see application changelog), Album and Track objects have been updated in the API.

The following attributes are now added to these objects:

producer_artists remixer_artists classical_orchestra_artists conductor_artists soloist_artists musician_artists mixing_engineer_artists mastering_engineer_artists

Our endpoint api/producers has been renamed to api/record_labels

See updated doc at https://docs.reprtoir.com/reference/get_api-record-labels#/

If you are subscribed to the Audio AI add-on, the audios endpoint now has a new ai_analysis node containing all the data.

Available data :

• status of analysis
• BPM
• Key
• Emotional Profile
• Energy Level
• Emotional Dynamics
• Predominent Voice Gender
• Voice Presence Profile
• Voiceover Esists ?
• Time Signature
• Description
• Arousal
• Valence
• Representative Segment

All track results now have a work node that references the its optional associated work.

All album and track results now have an identifiers node array contaning the custom identifiers available for that resource. For exemple ASCAP Code, YouTube Asset Identifier, ABRAMUS Code, etc.

New endpoint to list / search for works added :

https://docs.reprtoir.com/reference/get_api-works

This is now possible to upload a reference audio file via this new endpoint : https://docs.reprtoir.com/reference/post_api-reference-audios

In your Reprtoir Settings, under Integrations > Webhooks, you can register a webhook URL to be called when an upload is ready to be used in a search.

Then in the tracks search endpoint, when using search_mode=similarity and search_by_similarity[source]=audio, the UUID of the reference audio can be passed to search_by_similarity[reference_uuid] to search for tracks similar to the uploaded audio file.

The following endpoint has been updated:

https://docs.reprtoir.com/reference/get_api-audios-uuid
It now returns an new waveform object that includes an URL to the raw waveform data of the audio.

In addition of the MP3 320 kbps version we already sent within the API, we have added the MP3 128 kbps version.

The following endpoint has been updated:

• https://docs.reprtoir.com/reference/get_api-audios-uuid

It now returns an additional field bitratein the versions array of audio files.