Dev.to
7/14/2026

Why Music Metadata Matching Is Harder Than It Looks
Short summary
A detailed autopsy of why a track available on every major music platform failed to match in a metadata pipeline. Three root causes are identified: punctuation and Unicode dash variants breaking string comparison, the iTunes Search API being a partial rather than complete catalog view, and a third issue. Each fix is explained with concrete code, including a normalization fold function that collapses strings to canonical form before comparison.
- •Trailing periods and Unicode dash variants silently break exact string matching across music databases
- •A normalization fold using NFKD decomposition and punctuation stripping collapses titles to comparable canonical forms
- •The iTunes Search API is partial and recency-biased, not a full catalog window — direct ID lookups surface tracks search misses
Generated with AI, which can make mistakes.
Is this a good recommendation for you?
