Skip to main content

Songs uploading

If you want to recognize music among the songs you've uploaded, this is the endpoint you use for uploading your songs.

Access to uploading

To get access to the endpoint, contact the AudD representative that you work with. Access to this endpoint isn't available by default.

Uploading music to our main DB

This is not the information for our partners. To upload your catalog to our main DB and to update it, ask the AudD representative you work with to give you a link to the correct page.

The songs uploaded via this endpoint will be available for recognition only to you.

Necessary rights

By uploading any audio files, you confirm that you have the rights to do so and to give us the rights to process these files, to store the files for up to 72 hours, to make digital "fingerprints" from the files and to store and process those fingerprints for an unrestricted period of time.

Adding additional metadata

We strongly recommend to store any metadata on your side and send us integer IDs linked to the metadata. Contact us if you want to store on our side and get with the recognition results not just the IDs, but also the additional metadata.

How to send files​

There are two ways of sending files to the API:

  • Provide a URL of the file. Our server will download and recognize the file. Send the URL in the url parameter.
  • Post the file using multipart/form-data in the usual way the files are uploaded via the browser. Send the file in the file parameter, by POST. Useful if the file is not available by a URL.

You can try to send a file from a browser here.

post
Upload a song​

https://api.audd.io/upload/
Form Data Parameters
api_token
REQUIRED
string
Your api_token
url
POSSIBLY REQUIRED
string
The URL of the song
file
POSSIBLY REQUIRED
binary
The file of the song
audio_id
REQUIRED
integer
ID of the song. You will get the ID you set with the recognition results