# AudD resources

> Worked guides for the AudD music recognition API (https://audd.io): recipes, concepts, platform integrations, field references, and migration guides. Each link points at the markdown source so agents can read it directly. For the HTTP API reference and the 11 SDKs, see https://docs.audd.io and https://docs.audd.io/llms.txt.

## Recipes

- [Build a Discord bot that identifies songs in voice channels](/resources/recipes/discord-bot-song-id.md): 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
- [Build a Shazam-style music identification app](/resources/recipes/shazam-clone.md): Capture a few seconds of audio from the microphone and identify the song with AudD's standard recognition endpoint, including streaming links
- [Build a copyright scanner for user-uploaded content](/resources/recipes/ugc-copyright-scanner.md): Scan user uploads for copyrighted music with the AudD enterprise endpoint, capturing ISRC, UPC, label, and timestamps for every match
- [Build a now-playing widget for a livestream](/resources/recipes/now-playing-widget.md): 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
- [Detect samples and reuse of your own tracks](/resources/recipes/sample-detection.md): Detect when uploaded content reuses your own tracks — samples, leaks, or re-uploads — by matching against a private custom catalog with the AudD API
- [Generate DMCA takedown evidence](/resources/recipes/dmca-takedown-evidence.md): 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
- [Generate music credits for a podcast episode](/resources/recipes/podcast-music-credits.md): Produce a timestamped music credits list for a podcast episode with the AudD enterprise endpoint, collapsing repeated matches into one credit per song
- [Identify music in Instagram Reels and TikTok videos](/resources/recipes/instagram-tiktok-music-id.md): 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
- [Monitor radio airplay for your music catalog](/resources/recipes/radio-airplay-monitor.md): 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
- [Scan an archive of audio files and write metadata back](/resources/recipes/bulk-audio-archive-scan.md): Walk a directory of audio files, identify each one with AudD, and write artist, title, album, and ISRC to a resumable CSV
- [Turn a DJ set or mix into a tracklist](/resources/recipes/dj-set-tracklist.md): Build a timestamped tracklist from a recorded DJ set or mix with the AudD enterprise endpoint, reading each chunk's offset and per-chunk songs to place tracks and surface blends

## Concepts

- [Audio formats and quality for music recognition](/resources/concepts/audio-format-and-quality.md): 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
- [Controlling enterprise endpoint cost](/resources/concepts/enterprise-cost-control.md): How the AudD enterprise endpoint bills per 12 seconds of audio, and how limit, every, skip, and skip_first_seconds trade cost against completeness
- [Interpreting the recognition score](/resources/concepts/score-thresholds.md): 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
- [Public database vs your custom catalog](/resources/concepts/custom-vs-public-db.md): 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
- [Retries: what's safe to retry and what consumes a request](/resources/concepts/retry-strategy.md): 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
- [Standard, enterprise, or streams: how to choose](/resources/concepts/standard-vs-enterprise-vs-streams.md): Pick the right AudD recognition surface for your input: standard for a short clip, enterprise for long files, streams for continuous live audio
- [The song_link (lis.tn) universal music link](/resources/concepts/lisn-song-link.md): 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
- [Webhook callbacks vs longpoll for stream results](/resources/concepts/callback-vs-longpoll.md): Choose how to receive AudD stream recognition events: webhook callbacks when you can host a public HTTPS endpoint, longpoll when you can't

## Integrations

- [Add AudD to a podcast post-production pipeline](/resources/integrations/podcast-post-production.md): 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
- [Add music recognition to a React Native app](/resources/integrations/react-native.md): 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
- [Add music recognition to an Electron desktop app](/resources/integrations/electron-desktop.md): 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
- [Build a Chrome extension that identifies the music playing in a tab](/resources/integrations/chrome-extension.md): 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
- [Identify the music playing in a room with Home Assistant](/resources/integrations/home-assistant.md): 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
- [Run AudD music recognition in a Cloudflare Worker](/resources/integrations/cloudflare-workers.md): 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
- [Run AudD music recognition in a Vercel function](/resources/integrations/vercel-functions.md): 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
- [Run AudD music recognition in an AWS Lambda function](/resources/integrations/aws-lambda.md): Build an AWS Lambda function in Node.js that identifies music with AudD, triggered by API Gateway or by new objects landing in S3
- [Run a Reddit music-recognition bot (the AudD RedditBot template)](/resources/integrations/reddit-bot.md): 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
- [Run the AudD Discord bot (deploy the official template)](/resources/integrations/discord-bot.md): 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
- [Show recognized music on a Twitch stream](/resources/integrations/twitch-extension.md): 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

## Solutions by role

- [AudD for AI startups](/resources/for/ai-startups.md): 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
- [AudD for DJs](/resources/for/djs.md): 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
- [AudD for PROs and rights organizations](/resources/for/pros-and-rights-orgs.md): 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
- [AudD for Twitch streamers](/resources/for/twitch-streamers.md): 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
- [AudD for music distributors](/resources/for/music-distributors.md): 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
- [AudD for music lawyers and licensing investigators](/resources/for/lawyers-and-investigators.md): 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
- [AudD for podcast platforms and producers](/resources/for/podcasters.md): Generate music credits and show notes, verify the licensing status of music in episodes, and detect copyrighted beds in submitted audio with AudD
- [AudD for radio broadcasters](/resources/for/radio-broadcasters.md): 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
- [AudD for record labels and publishers](/resources/for/labels-and-publishers.md): 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
- [AudD for video platforms and UGC moderation](/resources/for/video-platforms.md): Scan user-uploaded videos for copyrighted music at ingest, build moderation queues, and assemble takedown evidence with the AudD enterprise endpoint

## Articles
Long-form reads on music recognition — how it works, what to build, comparisons, and concepts. Each links its markdown source.
- [AudD API walkthrough: get started in under 10 minutes](/resources/articles/audd-api-getting-started-walkthrough.md): An SDK-first walkthrough of the AudD music recognition API: get a token, run your first recognition in Python, Node, or PHP, read metadata, and handle errors leniently
- [How to use callbacks with the AudD API for real-time music alerts](/resources/articles/audd-api-webhooks-real-time-music-alerts.md): Configure AudD stream recognition with callback webhooks for instant song-detection notifications: register a stream, receive callbacks, parse payloads leniently, and build alerts
- [AudD vs ACRCloud vs Gracenote: music recognition API comparison](/resources/articles/audd-vs-acrcloud-vs-gracenote.md): Compares AudD, ACRCloud, and Gracenote across database coverage, integration speed, stream recognition, and developer experience
- [AudD vs ACRCloud: which music recognition API fits your project?](/resources/articles/audd-vs-acrcloud.md): Compares AudD and ACRCloud across authentication, endpoints, metadata, SDKs, and use-case fit
- [AudD vs. Gracenote: comparing music recognition and metadata solutions](/resources/articles/audd-vs-gracenote.md): How AudD and Gracenote differ across recognition, metadata depth, API access, and use-case fit
- [AudD vs PEX: music recognition and rights management compared](/resources/articles/audd-vs-pex.md): Where AudD and PEX fit for platform builders handling music: AudD is a developer-first recognition API across 160 million songs; PEX is a rights-management platform built around UGC compliance
- [How to handle audio recognition at scale: architecture and best practices](/resources/articles/audio-recognition-at-scale-architecture-best-practices.md): Architectural patterns for running audio recognition at scale — queue-based processing, caching, rate-limit handling, resilience, and cost control with AudD
- [Audio recognition for fitness apps: identify and sync workout music](/resources/articles/audio-recognition-for-fitness-apps.md): How to add song identification to a fitness app — recognize gym and workout music in real time and build music-aware features with AudD's recognition API and SDKs
- [How music streaming platforms use audio recognition to improve discovery](/resources/articles/audio-recognition-for-music-streaming-discovery.md): How streaming services use audio fingerprinting for catalog matching, duplicate detection, and discovery — and how to add the same recognition to your own platform with AudD
- [APIs to detect copyrighted music in user uploads, compared (2026)](/resources/articles/best-apis-to-detect-copyrighted-music-in-uploads.md): AudD, Audible Magic, Pex (Vobile), ACRCloud, and YouTube Content ID for platforms scanning user uploads: identification vs rights intermediaries, what each returns, who sets policy, and scanning cost
- [Radio and broadcast monitoring APIs compared (2026): AudD, ACRCloud, BMAT](/resources/articles/best-broadcast-monitoring-apis.md): How AudD, ACRCloud, and BMAT handle 24/7 radio and TV airplay monitoring for royalty reporting: adding stations, result contents, stream-health alerts, and per-station cost ($45 per stream per month on AudD, $25 against your own catalog)
- [Best music recognition APIs in 2026: a developer's comparison](/resources/articles/best-music-recognition-apis.md): A developer-focused comparison of the leading music recognition APIs in 2026 — AudD, ACRCloud, Gracenote, Shazam, and Musixmatch — across coverage, real-time support, metadata, and developer experience
- [Song recognition APIs for mobile apps compared (2026): ShazamKit, AudD, ACRCloud, AcoustID](/resources/articles/best-song-recognition-apis-for-mobile-apps.md): Which service to use for microphone song recognition in iOS and Android apps, compared on platforms, catalog, SDKs, server-side use, and cost
- [How to build a music monitoring dashboard for rights holders](/resources/articles/build-music-monitoring-dashboard-rights-holders.md): Track your catalog across radio and live streams with a dashboard built on AudD's streams API and SDKs
- [How to build a song recognition feature into your mobile app](/resources/articles/build-song-recognition-mobile-app.md): Wire music recognition into an iOS or Android app with the AudD API — capture, recognize, present results, and handle the edge cases
- [The business case for music recognition: ROI for labels, platforms, and developers](/resources/articles/business-case-for-music-recognition.md): Where music recognition saves money for labels, platforms, and engineering teams, with a framework for making the case internally
- [Copyright detection in user-generated content: an implementation guide](/resources/articles/copyright-detection-in-user-generated-content.md): How to build music copyright detection for a UGC platform with AudD: real-time vs batch architecture, SDK integration, rights workflows, appeals, and monitoring
- [Copyright takedowns and AudD](/resources/articles/copyright-takedowns.md): For rights holders: AudD stores fingerprints, not audio recordings; metadata is licensed from industry partners with contractual obligations to keep matching available; cover-art rights are certified by the album's publisher; DMCA notices go to dmca@audd.io (required elements listed); distribution complaints belong with the distributing platforms
- [How to detect copyrighted music in user-generated content](/resources/articles/detect-copyrighted-music-in-user-generated-content.md): Where to run copyright detection in your upload and live-stream pipeline, how audio fingerprinting works, and how to wire it up with the AudD API
- [The developer's guide to audio fingerprinting APIs](/resources/articles/developers-guide-to-audio-fingerprinting-apis.md): Core concepts, use cases, what to evaluate in a provider, and production patterns shown with the AudD SDKs
- [How to extract music metadata from audio using an API](/resources/articles/extract-music-metadata-api.md): A developer guide to extracting structured music metadata — artist, title, album, label, ISRC, and streaming links — from audio files, URLs, and live streams using AudD's recognition API and SDKs
- [GDPR and music recognition: is the audio you send personal data?](/resources/articles/gdpr-music-recognition.md): How the GDPR applies to audio sent for music recognition — the identifiability test, the CJEU's EDPS v SRB judgment, when a DPA is and isn't needed, AudD's infrastructure locations, and enterprise data-handling assurances
- [How AudD identifies songs: the technology behind the API](/resources/articles/how-audd-identifies-songs.md): A look at how AudD recognizes music — neural-network audio fingerprinting, matching against a 160-million-song database, handling real-world audio, and real-time recognition for live streams
- [Audio fingerprinting: how music recognition APIs work](/resources/articles/how-audio-fingerprinting-works.md): How audio fingerprinting turns a waveform into a searchable signature, how neural networks improve recognition, and how a music recognition API like AudD processes audio
- [How social media platforms detect and manage music in videos](/resources/articles/how-social-media-platforms-detect-music-in-videos.md): How TikTok, Instagram, and YouTube use audio fingerprinting to identify music in user-generated video at scale, and how to add the same capability with a music recognition API
- [How to identify music in live audio streams using an API](/resources/articles/identify-music-in-live-audio-streams.md): Identify songs in live radio and audio streams with AudD: register a stream once and receive every match by webhook or longpoll, or capture and send clips yourself when you can't hand over a URL. Architecture, code, formats, reliability, and cost
- [How to identify songs in audio files with the AudD API](/resources/articles/identify-songs-in-audio-files.md): Send an audio file or URL to AudD, parse the response, and handle no-match and error cases — a complete song-identification walkthrough with the Python SDK
- [ISRC codes explained: what they are and how to use them in your music app](/resources/articles/isrc-codes-explained-for-music-apps.md): What ISRC codes are, how they're structured, and how to retrieve and validate them in a music app using AudD's recognition API and SDKs
- [Building music recognition for mobile apps: iOS and Android guide](/resources/articles/mobile-music-recognition-ios-android.md): Add song identification to iOS and Android apps — capture audio with native recorders and recognize it with AudD's Swift and Kotlin SDKs, with permissions, errors, and performance covered
- [How to monitor music airplay across radio stations using an API](/resources/articles/monitor-radio-airplay-with-an-api.md): Build scalable radio airplay monitoring with a music recognition API: how stream recognition works, how to design the system, and how to control cost at scale with AudD
- [What is a music catalog and why catalog size affects recognition accuracy](/resources/articles/music-catalog-size-recognition-accuracy.md): What a music recognition catalog is, why its size and composition affect match rates, and how AudD's 160-million-song catalog plus custom catalogs cover real use cases
- [Music fingerprinting vs. audio watermarking: what developers need to know](/resources/articles/music-fingerprinting-vs-audio-watermarking.md): How audio fingerprinting and audio watermarking differ, when to use each, and how AudD's neural-network fingerprinting fits content recognition and monitoring
- [Music licensing 101: what developers and platform builders need to know](/resources/articles/music-licensing-for-developers.md): Music licensing for developers — composition vs. recording rights, performance, sync, mechanical, and master licenses, and where recognition fits into compliance
- [Music metadata extraction API: a complete guide for developers](/resources/articles/music-metadata-extraction-api-guide.md): How a metadata extraction API turns audio into artist, album, label, rights identifiers, and streaming links — with worked AudD SDK examples
- [Music recognition API integration: a developer guide](/resources/articles/music-recognition-api-integration-guide.md): Integrating a music recognition API with the AudD SDKs: setup, file and stream recognition, metadata, error handling, and production deployment
- [Music recognition API pricing: what to expect and how to choose](/resources/articles/music-recognition-api-pricing.md): How music recognition API pricing actually works — the cost drivers behind audio fingerprinting, the billing models to expect, and how to choose a provider as your volume grows
- [Top use cases for a music recognition API](/resources/articles/music-recognition-api-use-cases.md): Seven ways developers put a music recognition API to work — from UGC copyright screening to radio monitoring — and what to look for when choosing one
- [Music recognition in podcast apps: identifying background music and intros](/resources/articles/music-recognition-in-podcast-apps.md): How podcast platforms use a music recognition API to identify theme songs, stingers, and background music for copyright compliance, licensing, and listener features
- [How to build real-time music recognition for radio stations](/resources/articles/real-time-music-recognition-for-radio-stations.md): An architecture for automated radio airplay recognition with AudD streams: stream capture, webhook or longpoll results, a data pipeline, dashboards, and edge cases
- [How to add real-time song recognition to a web application](/resources/articles/real-time-song-recognition-web-app.md): Capture microphone audio in the browser, send it to a small backend that calls AudD's recognition API with the official SDK, and display the matched song in seconds — without exposing your API token
- [ShazamKit vs AudD: which to use for music recognition](/resources/articles/shazamkit-vs-audd.md): ShazamKit is Apple's free on-device SDK for the Shazam catalog; AudD is a REST API with SDKs for eleven languages, long-file and live-stream recognition, and custom catalogs
- [What is a music recognition API and how does it work?](/resources/articles/what-is-a-music-recognition-api.md): How music recognition APIs identify songs with neural-network audio fingerprinting, what a response looks like, and when to use one instead of building your own
- [What is broadcast music monitoring and why does it matter?](/resources/articles/what-is-broadcast-music-monitoring.md): How broadcast music monitoring works, who relies on it, and why API-based audio recognition has made continuous radio and TV airplay tracking accessible

## Reference

- [Apple Music metadata block](/resources/reference/apple-music.md): How to request and read the Apple Music metadata block on an AudD match: the track URL, AAC preview, artwork template, catalog ID, and ISRC
- [Deezer metadata block](/resources/reference/deezer.md): How to request and read the Deezer metadata block on an AudD match: the Deezer track link, MP3 preview, album cover art, and numeric IDs
- [Enterprise response and match fields](/resources/reference/enterprise-match-fields.md): The chunked response shape of the AudD enterprise endpoint (enterprise.audd.io): per-chunk offset, per-song score, ISRC/UPC, accurate offsets, and the request parameters that control chunking
- [Error codes reference](/resources/reference/errors.md): Every AudD API error code, grouped by category, with the typed SDK exception family each maps to and whether it is safe to retry
- [Glossary](/resources/reference/glossary.md): Concise definitions of AudD-specific terms an integrator or agent will encounter: endpoints, result fields, identifiers, streams, and request parameters
- [MusicBrainz metadata block](/resources/reference/musicbrainz.md): How to request and read the MusicBrainz metadata block on an AudD match: an array of recordings with MBIDs, ISRCs, match scores, and expanded releases
- [Napster metadata block (no longer available)](/resources/reference/napster.md): Napster ceased operations and `napster` was removed from the API — sending it adds warning #51 and returns no block; what to use instead
- [Provider metadata blocks (Apple Music, Spotify, Deezer, MusicBrainz)](/resources/reference/provider-metadata.md): How to request Apple Music, Spotify, Deezer, and MusicBrainz metadata on an AudD match, where each block's fields are documented, and when song_link is enough instead
- [Spotify metadata block](/resources/reference/spotify.md): How to request and read the Spotify metadata block on an AudD match: the track URI and open.spotify.com URL, preview, album artwork, and IDs
- [Recognition result fields](/resources/reference/result-fields.md): The fields of the result object returned by the standard AudD recognition endpoint (api.audd.io), including timecode, song_link, audio_id, and provider metadata blocks
- [Stream callback and longpoll payload reference](/resources/reference/streams-callback-shape.md): The exact JSON your callback receiver and longpoll consumer get from AudD streams: result bodies, notification bodies, the getStreams list, and the longpoll keepalive

## Migrating to AudD

- [Migrate from ACRCloud to AudD](/resources/migrate/from-acrcloud.md): Map ACRCloud's signed-request identification model to AudD's token-authenticated HTTP API, with before/after auth and recognition snippets
- [Migrate from ShazamKit to AudD](/resources/migrate/from-shazamkit.md): Map ShazamKit's on-device matching model to AudD's cross-platform HTTP API, with before/after Swift snippets and the on-device vs server trade-off
- [Replace YouTube Content ID for non-YouTube surfaces](/resources/migrate/from-content-id-for-non-youtube.md): Content ID only operates on YouTube. To detect copyrighted music on your own platform, app, or archive, run your own recognition with the AudD API

## Notes for AI agents

- [Agent notes: custom catalogs](/resources/agents/custom-catalog.md): Gotcha notes for AI agents working with AudD custom catalogs — the access requirement, how a custom match looks different, and why uploads must not be blindly retried
- [Agent notes: streams and longpoll](/resources/agents/streams.md): Gotcha notes for AI agents wiring up AudD stream monitoring — the account-wide callback URL, stream URL shortcuts, the longpoll callback-URL requirement, and notification codes
- [Agent notes: the enterprise endpoint](/resources/agents/enterprise.md): Gotcha notes for AI agents writing AudD enterprise-endpoint code — billing, the chunked response shape, and how to compute file-absolute timestamps

## Optional

- [AudD API reference](https://docs.audd.io/.md): the full HTTP API on one page
- [SDK index](https://docs.audd.io/sdks.md): all eleven official SDKs
- [Get an API token](https://dashboard.audd.io)