← Underholdning

iTunes-søgning

GET /music/itunes

Søg i Apple iTunes-kataloget efter musik, podcasts, film, TV-serier, lydbøger og andre medier. Returnerer titler, kunstnernavne, artwork-URL'er, forhåndsvisningslinks og priser. Understøtter filtrering efter medietype. Nyttigt til opbygning af mediesøgefunktioner, sammenligning af indhold på tværs af platforme og oprettelse af rige medieopdagelsesoplevelser. Data fra iTunes Search API.

Parametre

q påkrævet

Query

media valgfri standard: music

Media type

Eksempelforespørgsler

Grundlæggende brug
curl "https://nordapi.ee/api/v1/music/itunes?q=Radiohead"
Search iTunes for Radiohead music
curl "https://nordapi.ee/api/v1/music/itunes?q=Radiohead"
Search for podcasts about technology
curl "https://nordapi.ee/api/v1/music/itunes?q=technology&media=podcast"
Search for audiobooks
curl "https://nordapi.ee/api/v1/music/itunes?q=harry+potter&media=audiobook"

Livesvar

HTTP 500: "# FunctionClauseError at GET /api/v1/music/itunes\n\nException:\n\n    ** (FunctionClauseError) no function clause matching in Access.get/3\n        (elixir 1.19.2) lib/access.ex:324: Access.get(\"\\n\\n\\n{\\n \\\"resultCount\\\":21,\\n \\\"results\\\": [\\n{\\\"wrapperType\\\":\\\"track\\\", \\\"kind\\\":\\\"song\\\", \\\"artistId\\\":657515, \\\"collectionId\\\":1097861387, \\\"trackId\\\":1097861834, \\\"artistName\\\":\\\"Radiohead\\\", \\\"collectionName\\\":\\\"OK Computer\\\", \\\"trackName\\\":\\\"Let Down\\\", \\\"collectionCensoredName\\\":\\\"OK Computer\\\", \\\"trackCensoredName\\\":\\\"Let Down\\\", \\\"artistViewUrl\\\":\\\"https://music.apple.com/us/artist/radiohead/657515?uo=4\\\", \\\"collectionViewUrl\\\":\\\"https://music.apple.com/us/album/let-down/1097861387?i=1097861834&uo=4\\\", \\\"trackViewUrl\\\":\\\"https://music.apple.com/us/album/let-down/1097861387?i=1097861834&uo=4\\\", \\n\\\"previewUrl\\\":\\\"https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview115/v4/66/13/3c/66133c2c-59a6-f17b-0b88-7f61e1edc181/mzaf_12936594904953407247.plus.aac.p.m4a\\\", \\\"artworkUrl30\\\":\\\"https://is1-ssl.mzstatic.com/image/thumb/Music116/v4/07/60/ba/0760ba0f-148c-b18f-d0ff-169ee96f3af5/634904078164.png/30x30bb.jpg\\\", \\\"artworkUrl60\\\":\\\"https://is1-ssl.mzstatic.com/image/thumb/Music116/v4/07/60/ba/0760ba0f-148c-b18f-d0ff-169ee96f3af5/634904078164.png/60x60bb.jpg\\\", \\\"artworkUrl100\\\":\\\"https://is1-ssl.mzstatic.com/image/thumb/Music116/v4/07/60/ba/0760ba0f-148c-b18f-d0ff-169ee96f3af5/634904078164.png/100x100bb.jpg\\\", \\\"collectionPrice\\\":9.99, \\\"trackPrice\\\":1.29, \\\"releaseDate\\\":\\\"1997-05-21T07:00:00Z\\\", \\\"collectionExplicitness\\\":\\\"notExplicit\\\", \\\"trackExplicitness\\\":\\\"notExplicit\\\", \\\"discCount\\\":1, \\\"discNumber\\\":1, \\\"trackCount\\\":12, \\\"trackNumber\\\":5, \\\"trackTimeMillis\\\":299560, \\\"country\\\":\\\"USA\\\", \\\"currency\\\":\\\"USD\\\", \\\"primaryGenreName\\\":\\\"Alternative\\\", \\\"isStreamable\\\":true}, \\n{\\\"wrapperType\\\":\\\"track\\\", \\\"kind\\\":\\\"song\\\", \\\"artistId\\\":657515, \\\"collectionId\\\":1097861387, \\\"trackId\\\":1097861842, \\\"artistName\\\":\\\"Radiohead\\\", \\\"collectionName\\\":\\\"OK Computer\\\", \\\"trackName\\\":\\\"No Surprises\\\", \\\"collectionCensoredName\\\":\\\"OK Computer\\\", \\\"trackCensoredName\\\":\\\"No Surprises\\\", \\\"artistViewUrl\\\":\\\"https://music.apple.com/us/artist/radiohead/657515?uo=4\\\", \\\"collectionViewUrl\\\":\\\"https://music.apple.com/us/album/no-surprises/1097861387?i=1097861842&uo=4\\\", \\\"trackViewUrl\\\":\\\"https://music.apple.com/us/album/no-surprises/1097861387?i=1097861842&uo=4\\\", \\n\\\"previewUrl\\\":\\\"https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview125/v4/ef/02/b7/ef02b776-f887-f1f0-acfb-e7d9776ba503/mzaf_2515606267255808294.plus.aac.p.m4a\\\", \\\"artworkUrl30\\\":\\\"https://is1-ssl.mzstatic.com/image/thumb/Music116/v4/07/60/ba/0760ba0f-148c-b18f-d0ff-169ee96f3af5/634904078164.png/30x30bb.jpg\\\", \\\"artworkUrl60\\\":\\\"https://is1-ssl.mzstatic.com/image/thumb/Music116/v4/07/60/ba/0760ba0f-148c-b18f-d0ff-169ee96f3af5/634904078164.png/60x60bb.jpg\\\", \\\"artworkUrl100\\\":\\\"https://is1-ssl.mzstatic.com/image/thumb/Music116/v4/07/60/ba/0760ba0f-148c-b18f-d0ff-169ee96f3af5/634904078164.png/100x100bb.jpg\\\", \\\"collectionPrice\\\":9.99, \\\"trackPrice\\\":1.29, \\\"releaseDate\\\":\\\"1997-05-21T07:00:00Z\\\", \\\"collectionExplicitness\\\":\\\"notExplicit\\\", \\\"trackExplicitness\\\":\\\"notExplicit\\\", \\\"discCount\\\":1, \\\"discNumber\\\":1, \\\"trackCount\\\":12, \\\"trackNumber\\\":10, \\\"trackTimeMillis\\\":229120, \\\"country\\\":\\\"USA\\\", \\\"currency\\\":\\\"USD\\\", \\\"primaryGenreName\\\":\\\"Alternative\\\", \\\"isStreamable\\\":true}, \\n{\\\"wrapperType\\\":\\\"track\\\", \\\"kind\\\":\\\"song\\\", \\\"artistId\\\":657515, \\\"collectionId\\\":1097862703, \\\"trackId\\\":1097862845, \\\"artistName\\\":\\\"Radiohead\\\", \\\"collectionName\\\":\\\"The Bends\\\", \\\"trackName\\\":\\\"Fake Plastic Trees\\\", \\\"collectionCensoredName\\\":\\\"The Bends\\\", \\\"trackCensoredName\\\":\\\"Fake Plastic Trees\\\", \\\"artistViewUrl\\\":\\\"https://music.apple.com/us/artist/radiohead/657515?uo=4\\\", \\\"collectionViewUrl\\\":\\\"https://music.apple.com/us/album/fake-plastic-trees/1097862703?i=1097862845&uo=4\\\", \\\"trackViewUrl\\\":\\\"https://music.apple.com/us/album/fake-plastic-trees/1097862703?i=1097862845&uo=4\\\", \\n\\\"previewUrl\\\":\\\"https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview126/v4/88/7c/92/887c92d6-0979-9f01-1e9b-6762fca517bd/mzaf_1998812167371306210.plus.aac.p.m4a\\\", \\\"artworkUrl30\\\":\\\"https://is1-ssl.mzstatic.com/image/thumb/Music126/v4/1b/a9/5c/1ba95cac-b245-d386-63fb-6b857aa9dce8/634904078065.png/30x30bb.jpg\\\", \\\"artworkUrl60\\\":\\\"https://is1-ssl.mzstatic.com/image/thumb/Music126/v4/1b/a9/5c/1ba95cac-b245-d386-63fb-6b857aa9dce8/634904078065.png/60x60bb.jpg\\\", \\\"artworkUrl100\\\":\\\"https://is1-ssl.mzstatic.com/image/thumb/Music126/v4/1b/a9/5c/1ba\" <> ..., \"results\", nil)\n        (app 0.1.0) lib/app/music.ex:103: App.Music.itunes_search/2\n        (app 0.1.0) lib/app_web/controllers/api/v1/music_controller.ex:48: AppWeb.API.V1.MusicController.itunes/2\n        (app 0.1.0) lib/app_web/controllers/api/v1/music_controller.ex:1: AppWeb.API.V1.MusicController.action/2\n        (app 0.1.0) lib/app_web/controllers/api/v1/music_controller.ex:1: AppWeb.API.V1.MusicController.phoenix_controller_pipeline/2\n        (phoenix 1.8.5) lib/phoenix/router.ex:416: Phoenix.Router.__call__/5\n        (app 0.1.0) lib/app_web/endpoint.ex:1: AppWeb.Endpoint.plug_builder_call/2\n        (app 0.1.0) deps/plug/lib/plug/debugger.ex:155: AppWeb.Endpoint.\"call (overridable 3)\"/2\n        (app 0.1.0) lib/app_web/endpoint.ex:1: AppWeb.Endpoint.call/2\n        (phoenix 1.8.5) lib/phoenix/endpoint/sync_code_reload_plug.ex:22: Phoenix.Endpoint.SyncCodeReloadPlug.do_call/4\n        (bandit 1.10.3) lib/bandit/pipeline.ex:131: Bandit.Pipeline.call_plug!/2\n        (bandit 1.10.3) lib/bandit/pipeline.ex:42: Bandit.Pipeline.run/5\n        (bandit 1.10.3) lib/bandit/http1/handler.ex:13: Bandit.HTTP1.Handler.handle_data/3\n        (bandit 1.10.3) lib/bandit/delegating_handler.ex:18: Bandit.DelegatingHandler.handle_data/3\n        (bandit 1.10.3) lib/bandit/delegating_handler.ex:8: Bandit.DelegatingHandler.handle_continue/2\n        (stdlib 7.1) gen_server.erl:2424: :gen_server.try_handle_continue/3\n        (stdlib 7.1) gen_server.erl:2291: :gen_server.loop/4\n        (stdlib 7.1) proc_lib.erl:333: :proc_lib.init_p_do_apply/3\n    \n\n## Connection details\n\n### Params\n\n    %{\"q\" => \"Radiohead\"}\n\n### Request info\n\n  * URI: http://localhost:4000/api/v1/music/itunes\n  * Query string: q=Radiohead\n\n### Headers\n  \n  * accept-encoding: gzip\n  * host: localhost:4000\n  * user-agent: req/0.5.17\n\n### Session\n\n    %{}\n"