
iTunes Search APIで「あるのに出てこない」曲を拾う方法——曲名照合でハマった6つの落とし穴と対策
配信されているはずの曲が、iTunes Search APIで検索すると0件になる。原曲を指定したのに、ライブ版が返ってくる。アポストロフィを直したら、かえって見つからなくなった。
音楽×位置情報SNS「Sway」を運営する、テルパス株式会社です。Swayでは、SNSに載せる画像などで曲の情報を使うとき、公開されているiTunes Search APIで曲を照合しています。この記事では、その照合で実際にハマった6つの落とし穴と対策を、手順寄りにまとめます。曲名の照合を実装している開発者の方の参考になればうれしいです。
▶ 音楽×位置情報SNS「Sway」をダウンロード(iOS・無料)
最初に:ここで扱うのは「iTunes Search API」の話です
誤解のないように、最初に範囲をはっきりさせておきます。
対象: 公開のiTunes Search API(`itunes.apple.com/search` と `/lookup`)。主に `entity=song`、`country=jp`(引けないときは `us` も試す)、`limit=50` で使っています
対象外: Apple Music API(`api.music.apple.com/v1/catalog`)。こちらは別の経路で、同じ挙動が出るかは検証していません
以下の数字は、すべて2026年11月時点・私たちの検証です。カタログも検索の挙動も変わるので、ご自身の環境でも確かめてください。

落とし穴1:カタログにあるのに「アーティスト名+曲名」で0件
症状: 配信されている曲なのに、検索結果が0件。似た別の曲すら返ってきません。
実測: あるアーティストで、重複を除いた曲名51件を1つずつ「アーティスト名+曲名」で検索したところ、12件が0件、39件は正常に返りました(2026年11月17日実測)。アーティスト全体が消えるのではなく、曲単位で検索から落ちるのがポイントです。
原因: 分かっていません。検索インデックス側の問題だろうと推測しています。
対策: `/lookup` を併用して、「配信されていない」のか「検索から届かないだけ」なのかを切り分けます。
# アーティストIDやアルバムIDから、収録曲を直接引く
# ★limit を明示しないと既定値で切り捨てられる(実測: 省略時51件 → limit=200で58件)
https://itunes.apple.com/lookup?id=&entity=song&country=jp&limit=200
`/lookup` にも `limit` を必ず付けてください。 付けないと既定の件数で黙って打ち切られます。私たちの検証では、あるアーティストで `limit` を省くと51件、`limit=200` にすると58件が返りました(2026年11月19日実測)。切り分けのための道具で、また"見えない曲"をつくってしまうところでした。
検索から届かない曲は、クエリをいくら工夫しても出てこないことがあります。その場合は、別の曲に差し替えるしかありません。一番大事なのは「検索で0件=未配信」と判断しないことです。
落とし穴2:アーティスト名だけで曲を探すと、同名の別アーティストに埋もれる
症状: アーティスト名だけで曲を検索すると、上位50件に本人の曲が1件も出てこない(2026年11月17日実測)。
原因: 同じ名前や似た名前の別アーティストが、上位を占めてしまいます。
対策: 曲を探すときは、必ず曲名を一緒に入れる。アーティストがいるかどうかを確かめたいときは、`entity=musicArtist` で別に検索します(私たちの例では、こちらでは1件目に出てきました)。
落とし穴1と2は、どちらも「出てこない」ですが、原因が違う別の現象です。混ぜて考えると、対策を間違えます。
落とし穴3:アポストロフィの種類で結果が変わる(しかも曲ごとに逆)
症状: まっすぐな `'`(U+0027)で当たる曲と、カーブした `’`(U+2019)で当たる曲が、両方あります。合っていないほうで検索すると、0件になるか、別の曲が返ります。
原因: 不明です。登録されたときの表記が、そのまま検索に効いているのだと思われます。マクロン付きの文字でも、同じような例がありました。
対策: 正規化しない。両方のパターンで検索して、当たったほうを使います。
def variants(title):
a = title.replace("’", "'")
b = title.replace("'", "’")
return list(dict.fromkeys([title, a, b])) # 重複を除いて順番を保つ
このコードはアポストロフィだけを扱っています。アクセント付きの文字なども、同じように両方のパターンを試します。「表記をきれいに揃える」前処理は、照合では一番危ない処理でした。
落とし穴4:ライブ版・インスト・リマスターなど、別バージョンに化ける
症状: 原曲を指定したのに、ライブ版、インスト、リミックス、出どころの分からない音源が返ってくる。
原因: 検索の並び順で、派生バージョンが原曲より上に来ることがあります。
対策: 逆向きの2つの手を、両方試します。
(a) 版の名前を足して絞る: 「(2014 Remaster)」のような版名まで含めて検索する
(b) 逆に、曲名を短くする: 長い括弧付きの派生曲が上に来ているときは、括弧を落とすと原曲が当たる
(a)と(b)は効く場面が逆なので、片方だけだと詰まります。
落とし穴5:アーティスト表記の字種で、当たりが変わる
症状: アルファベット表記で0件なのに、カタカナ表記だと当たる。その逆もあります。
原因: 不明です。注意したいのは、アーティスト単位ではなく、曲単位で逆転することです。同じアーティストでも、曲Aはアルファベット、曲Bはカタカナが正解、ということが起きます。
対策: 両方試す。「このアーティストはカタカナが正解」と覚えて使い回すと、外します。
落とし穴6:「完全一致」でも別の曲、「似ていない」でも正しい曲
症状: 曲名の文字列が完全に一致しても、別バージョンや同名の別の曲が返る。逆に、文字列の似ている度合いが低くても、正しい曲が選ばれていることがある。
原因: 文字列の似ている度合いは、「同じ曲かどうか」を保証しません。たとえば、あるアーティストの有名曲を「アーティスト名+曲名」で検索すると、そのアーティスト名義の曲は返ってくるのに、全部が別の曲(別のシングルや別の作品の曲)だったことがあります。名義が一致していても、曲が合っているとは限りません。
対策: 機械の判定は、次の3つに分けます。
一致
近い別の曲に化けた
取得できない
「近い別の曲」「取得できない」を含む指定は、次の工程(画像の生成など)に進めません。そして、機械が自動で代わりの曲に差し替えない。最終確認は、できあがったものを人の目で見て行います。
補足:ほかに確認できたこと
外れたときの候補に、正しい表記が入っていることが多い: 大文字と小文字、feat.の括弧の付け方、半角スペースの有無など。候補に出てきた表記をそのまま検索し直すと当たります
国のストアで差がある: `jp` で引けず `us` で引ける曲があります。逆もあります
照会の間隔を空ける: 私たちは、連続の照会で403が返るのを避けるために間隔を空けています(403そのものの再現は検証していません)。1.6秒間隔で51件の照会は、最後まで通りました(2026年11月17日実測)
本人版が見つからない音源もある: たとえば安室奈美恵さんの代表曲や、RADWIMPSの『君の名は。』の楽曲は、曲名で検索しても本人版が返ってきません(2026年11月19日実測)。返ってくるのはカラオケ、オルゴール、別アーティストのカバーです。一方で、本人名義で引ける曲もあります(安室奈美恵さんでは『Come』、RADWIMPSでは『天気の子』の楽曲が返りました)。「配信されていない」と言えるのはApple Music側を確認したときだけで、この記事の範囲(iTunes Search API)で言えるのは「検索から本人版が返らない」までです
APIではなく、自分たちの実装の落とし穴も: 曲名が区切り記号で終わっていると、自分たちのプログラムの引数の読み取りが壊れたことがありました。APIを疑う前に、自分の側も確かめたほうがいいです
まとめ:照合の5つのルール
検索で0件でも、未配信と決めつけない。 `/lookup` で切り分ける
表記を正規化しない。 アポストロフィも字種も、両方試す
版名を足す/曲名を削る、の両方を試す
判定は「一致/近い別の曲/取得できない」の3つに分ける。 一致以外は先に進めない
自動で差し替えない。 最後は人の目で確かめる
曲の照合は地味な作業ですが、ここを間違えると、違う曲を「この街で聴かれている曲」として出してしまうことになります。同じところでハマっている方の役に立てばうれしいです。
お声がけください
ここまで読んでいただき、ありがとうございます。
音楽データを扱うサービスを作っている企業・開発者の方: 照合や自動化の知見を、私たちの失敗も含めて共有できます
音楽・ライブに関わる方: 位置情報×音楽の取り組みについて、お気軽にご相談ください
マーケティングに挑戦したい学生の方: マーケインターンを募集しています(募集の記事はこちら)
連絡先:
この記事へのコメント
各SNS(X・Instagram・Threads)のDM
メール: info@tell-path.com
音楽×位置情報SNS「Sway」を試す(iOS・無料)
https://apps.apple.com/jp/app/sway/id6738626019
代表・たかくのX(開発の裏側・最新デモはこちら)
https://x.com/Takaku819TP