Custom catalog

Add a song to the caller's private fingerprint catalog (NOT for music recognition).

⚠ This is NOT how you submit audio for music recognition. For recognition, use POST / (or POST enterprise.audd.io/ to scan beyond the first 12 seconds of a file). This endpoint adds a song to the caller's private fingerprint catalog so AudD can later identify it for the caller's account only.

Requires special access — contact api@audd.io to enable.

Calling upload again with the same audio_id re-fingerprints that slot. There is no public list/delete endpoint; callers track audio_id ↔ song mappings on their side.

post/upload/

Request

  • Base URL: https://api.audd.io
  • URL: https://api.audd.io/upload/
  • Auth: one of:
    • API key in header api_token
    • API key in query parameter api_token

Response

Catalog updated, or 904 if the caller's token doesn't have access.

OR

Changes

No recorded changes to this operation across all 1 revision of this API.