Resources · AudD music recognition API

Turn audio into song metadata, then do something with it.

Worked guides for the AudD API — recognize music in clips, long files, and live streams. Build a Shazam clone, scan uploads for copyright, list a DJ set, monitor radio airplay. Copy a recipe, ship it.

Recipes

End-to-end builds — from a blank file to a working thing.

01
Recipe

Build a copyright scanner for user-uploaded content

Scan user uploads for copyrighted music with the AudD enterprise endpoint, capturing ISRC, UPC, label, and timestamps for every match.

read →
02
Recipe

Build a Discord bot that identifies songs in voice channels

Capture a few seconds of a Discord voice channel, send the clip to AudD, and reply in chat with the artist, title, and song_link.

read →
03
Recipe

Build a now-playing widget for a livestream

Show the currently-playing song on a livestream overlay using AudD audio streams, with a webhook callback receiver or longpoll, plus a copy-paste HTML widget.

read →
04
Recipe

Build a Shazam-style music identification app

Capture a few seconds of audio from the microphone and identify the song with AudD's standard recognition endpoint, including streaming links.

read →
05
Recipe

Detect samples and reuse of your own tracks

Detect when uploaded content reuses your own tracks — samples, leaks, or re-uploads — by matching against a private custom catalog with the AudD API.

read →
06
Recipe

Flag and remove music in a live-event recording

Find where copyrighted music plays in a long broadcast or livestream recording, flag each segment in a report, and produce a cleaned copy with those segments muted or cut.

read →
07
Recipe

Generate DMCA takedown evidence

Produce a structured evidence pack — track identification plus exact in-file timestamps — proving copyrighted music appears in a piece of content, ready for a DMCA filing.

read →
08
Recipe

Generate music credits for a podcast episode

Produce a timestamped music credits list for a podcast episode with the AudD enterprise endpoint, collapsing repeated matches into one credit per song.

read →
09
Recipe

Identify music in Instagram Reels and TikTok videos

Pass a social-media video URL straight to AudD's recognition endpoint to identify the music in a Reel, TikTok, or YouTube Short — no downloading required.

read →
10
Recipe

Monitor radio airplay for your music catalog

Track which of your catalog's songs get played across many radio stations 24/7 with AudD audio streams, storing every recognition and aggregating it into an airplay chart.

read →
11
Recipe

Scan an archive of audio files and write metadata back

Walk a directory of audio files, identify each one with AudD, and write artist, title, album, and ISRC to a resumable CSV.

read →
12
Recipe

Turn a DJ set or mix into a tracklist

Build a timestamped tracklist from a recorded DJ set or mix with the AudD enterprise endpoint, reading each match's file-absolute start time to place tracks and surface blends.

read →

Concepts

How the API works and how to choose between its parts.

01
Concept

Audio formats and quality for music recognition

Which audio and video formats AudD accepts, the 10 MB standard-endpoint cap, and practical guidance on clip length, sample rate, channels, and compression for reliable matches.

read →
02
Concept

Controlling enterprise endpoint cost

How the AudD enterprise endpoint bills per 12 seconds of audio, and how limit, every, skip, and skip_first_seconds trade cost against completeness.

read →
03
Concept

Interpreting the recognition score

Every AudD match carries a confidence score. How to read it and how to set application-specific thresholds for auto-accept, blocking, and human review.

read →
04
Concept

Public database vs your custom catalog

When AudD recognition matches against the public 160-million-song database versus a private custom catalog you upload, and how to tell the two apart in a response.

read →
05
Concept

Retries: what's safe to retry and what consumes a request

Which AudD API failures are safe to retry, which consume a request, and how to configure the SDK's retry budget without double-billing or duplicating catalog entries.

read →
06
Concept

Standard, enterprise, or streams: how to choose

Pick the right AudD recognition surface for your input: standard for a short clip, enterprise for long files, streams for continuous live audio.

read →
07
Concept

The song_link (lis.tn) universal music link

Every AudD match includes a song_link on the lis.tn domain; how its ?thumb and ?provider conventions and the SDK helpers let you build cover-art and 'open in your service' UIs without requesting provider metadata.

read →
08
Concept

Webhook callbacks vs longpoll for stream results

Choose how to receive AudD stream recognition events: webhook callbacks when you can host a public HTTPS endpoint, longpoll when you can't.

read →

Integrations

Run recognition on a specific platform or runtime.

01
Integration

Add AudD to a podcast post-production pipeline

Wire AudD's enterprise endpoint into a repeatable podcast workflow — on every episode export, scan for music with ffmpeg, write credits to chapters and show notes, and flag unlicensed commercial tracks for review.

read →
02
Integration

Add music recognition to a React Native app

Record a few seconds of audio in a React Native app, upload it to your own backend, and identify the song with AudD's standard recognition endpoint.

read →
03
Integration

Add music recognition to an Electron desktop app

Capture a few seconds of audio in an Electron app and identify the song with AudD, keeping your API token in the main process and off the client.

read →
04
Integration

Build a Chrome extension that identifies the music playing in a tab

Capture a few seconds of tab audio with a Manifest V3 Chrome extension, send it to your own backend, and identify the song with AudD.

read →
05
Integration

Identify the music playing in a room with Home Assistant

Recognize the song playing in a room from Home Assistant or Music Assistant — capture a short audio clip on the server, send it to AudD, and expose artist and title as a sensor and a service you can automate on.

read →
06
Integration

Run a Reddit music-recognition bot (the AudD RedditBot template)

Deploy AudD's open-source Reddit bot — the one that powers u/auddbot — to answer 'what's this song?' on posts and comments by recognizing music in linked videos and streams.

read →
07
Integration

Run AudD music recognition in a Cloudflare Worker

Build a Cloudflare Worker that takes a URL or an uploaded file, calls the AudD API, and returns the recognized track as JSON — secret handling, fetch-based recognition, and CPU-time limits covered.

read →
08
Integration

Run AudD music recognition in a Vercel function

Build a Next.js route handler on Vercel that calls the AudD API — covering the Node runtime (full SDK, including bytes) and the Edge runtime (fetch-only, URL or in-memory bytes), with timeout and offload guidance.

read →
09
Integration

Run AudD music recognition in an AWS Lambda function

Build an AWS Lambda function in Node.js that identifies music with AudD, triggered by API Gateway or by new objects landing in S3.

read →
10
Integration

Run the AudD Discord bot (deploy the official template)

Deploy AudD's official open-source Discord bot: clone the Go repo, configure your Discord and AudD tokens, run it, invite it to a server, and keep it up.

read →
11
Integration

Show recognized music on a Twitch stream

Display the currently-playing song to Twitch viewers with AudD audio streams — subscribe a channel with addStream, consume matches via callback or longpoll, and render them in an overlay or a Twitch Extension.

read →

By role

Which capabilities map to the work you actually do.

01
Solution

AudD for AI startups

Identify and attribute music in user or training data, build music-aware product features, and enrich media datasets with artist, title, and ISRC using the AudD API.

read →
02
Solution

AudD for DJs

How DJs use AudD to build a timestamped tracklist from a recorded set, identify an unknown track in a recording, and credit tracks for a SoundCloud or Mixcloud upload.

read →
03
Solution

AudD for music distributors

How distributors use AudD to screen incoming releases for third-party copyrighted material, match delivered tracks against a catalog, and capture ISRC and UPC from recognition results.

read →
04
Solution

AudD for music lawyers and licensing investigators

Use AudD to gather evidence of unauthorized music use — artist, title, label, ISRC, UPC, and exact in-content timestamps — and to investigate where a recording appears across long-form and social content.

read →
05
Solution

AudD for podcast platforms and producers

Generate music credits and show notes, verify the licensing status of music in episodes, and detect copyrighted beds in submitted audio with AudD.

read →
06
Solution

AudD for PROs and rights organizations

How performing-rights organizations and collection societies use AudD to monitor broadcast and stream airplay for royalty allocation, identify works in large archives, and capture ISRC and UPC for logging.

read →
07
Solution

AudD for radio broadcasters

How radio stations and broadcasters use AudD to log airplay 24/7, build compliance reports, drive now-playing displays, and verify music-versus-ad separation.

read →
08
Solution

AudD for record labels and publishers

How labels and publishers use AudD to find unauthorized use of catalog tracks, detect leaks of unreleased music, spot samples and interpolations, and track radio airplay.

read →
09
Solution

AudD for Twitch streamers

Use AudD audio streams to show viewers the song that's playing, keep a log of music played on your channel, and drive a now-playing overlay or panel — with the twitch:<channel> shortcut, callbacks, and longpoll.

read →
10
Solution

AudD for video platforms and UGC moderation

Scan user-uploaded videos for copyrighted music at ingest, build moderation queues, and assemble takedown evidence with the AudD enterprise endpoint.

read →

Articles

Deeper reads on music recognition — how it works, what to build, how to choose.

Reference

Fields, error codes, payload shapes, and a glossary.

Migrating

Concept mapping and before/after from other tools.

For AI agents

Concentrated gotchas for AI coding agents.