AppleTV Integration Deep Link URLs - Which Are Working?

Configuration
1

Updated June 19 16, 2025
I’m going to stop the running updates and just try and keep this first post updated as things change.

Workarounds to try
A number of the URLs below have stopped working over time. At this point it feels like more and more apps are not supporting deep links anymore, or are doing it in a way that’s very hard to figure out. For many of my shows, I’ve just switched to using the link that the Apple TV app provides and then having my scripts launch the TV app on the AppleTV and goes to the right show. I then use that to launch the needed app on the AppleTV.

Even with that, some apps work sometimes with that and then don’t again (like AMC+). And Netflix doesn’t support it at all. Those two I just launch the app and look for the show by hand.

Working DeepLink URLs
I’ve finally got a system setup for Kodi to pass deep link URLs to Home Assistant so that the AppleTV integration can open specific episodes or movies. Here are the ones I’ve found that work:

Netflix movie (web site link):
DOES NOT WORK AS OF LATEST NETFLIX UPDATE IN SEPT 2025
https://www.netflix.com/watch/81587873

Netflix show (web site link - can’t do episodes, just show page)
DOES NOT WORK AS OF LATEST NETFLIX UPDATE IN SEPT 2025
https://www.netflix.com/title/81591296

Disney+ episode/movie (web site link):
https://www.disneyplus.com/video/afdc98f1-26bf-48d8-8866-af185ba5d5ac

AppleTV+ episode (from share panel in Mac/iOS apps):
https://tv.apple.com/us/episode/in-seldons-shadow/umc.cmc.4tale27biojjpu69b5c22euge

AppleTV+ movie (from share panel in Mac/iOS apps):
https://tv.apple.com/us/movie/spirited/umc.cmc.3lp7wqowerzdbej98tveildi3

Paramount+ shows/movies (from the share link on the iOS app):
DOES NOT WORK ANYMORE
Paramount has a new deep link URL, but it doesn’t trigger the AppleTV app.
https://link.us.paramountplus.com/kLWgjEgkFBb

Hulu movie/episode (thanks to johaywood):
hulu://watch/73df1fcf-09ed-4717-a9d2-14d3138afd7e

Hulu series page (thanks to johaywood):
Note that if you have both Hulu and Disney+ in one subscription you can just use Disney+ links
hulu://series/73df1fcf-09ed-4717-a9d2-14d3138afd7e

YouTube:
youtube://www.youtube.com/watch?v=dQw4w9WgXcQ

PeacockTV Episode/Movie:
https://www.peacocktv.com/deeplink?deeplinkData=%7B%22pvid%22%3A%2204569a08-33e0-3835-9a21-76af2e31fa69%22%2C%22type%22%3A%22PROGRAMME%22%2C%22action%22%3A%22PLAY%22%7D

PeacockTV Show Page
https://www.peacocktv.com/deeplink?deeplinkData=%7B%22providerSeriedId%22%3A%227377906371406790112%22%2C%22type%22%3A%22SERIES%22%2C%22action%22%3A%22PLAY%22%7D

Details about Peacock TV in this post from johaywood.

2

I’m interested in this as well. Trying to get YouTube deep link to work and not having much luck.

3

Just an update that I figured out Paramount+ and updated the first post.

4

Is Netflix still working for you? I can get it to launch the app, but it will not start a show, episode, movie, etc.

YouTube works great.

5

Nope. Paramount+ stopped working about two months ago. Netflix stopped working a couple weeks ago. They’ve both either changed the way they do deep links or they removed support for deep links out of spite. I spent several hours researching the Paramount+ side and finally just gave up. I haven’t even bothered with Netflix.

6

Ok, thanks. I guess I’ll need to try pinning/saving shows on Netflix and use the remote commands (up, left, down, etc) to navigate and see if that works.

Trying to get a “kid shows” randomizer via NFC card scan, lol.

7

Can you post how you got YouTube deep linking to work? I keep getting an “Unknown Error”.

service: media_player.play_media
data:
  media_content_id: youtube://www.youtube.com/watch?v=35kwlY_RR08
  media_content_type: url
target:
  entity_id: media_player.living_room_apple_tv
9

Looks like how I have it setup. Later today I can construct the actual service call (I’m doing it via NodeRed and NFC tags with tag ID as YouTube URL) and double check.

Maybe check to be sure you have the Apple TV properly authorized and Home Assistant shows as a remote in apple tv → settings → remotes; should see something like “pyatv”.

Also, just to be sure, you’ve got the YouTube app installed on Apple TV, and you’re trying to use actual YouTube videos, not YouTube TV?

10

Thanks for the reply. Everything you stated/asked was correct.

I was able to get it to work after removing the Apple TV and re-adding it to Home Assistant. Not sure what changed other than the entity id is now the numerical id rather than the friendly name…

service: media_player.play_media
data:
  media_content_id: youtube://www.youtube.com/watch?v=35kwlY_RR08
  media_content_type: url
target:
  device_id: 54c648cc09fdd16426d6ae900435495f
11

you should still be able to use the entity_id if you want.
I read that entity_id’s are preferred over device_id’s in general.

12

Does anybody got spotify deep links working for apple tv?

service: media_player.play_media
data:
  media_content_type: url
  media_content_id: https://open.spotify.com/track/0L8LOav65XwLjCLS11gNPD?si=X6034tcsRG6V2rg9KKHiHw
target:
  entity_id: media_player.appletv

When I try to run this it shows “unknown error”.

13

I’m trying to build the same thing for my kids - an NFC show randomizer. Netflix deep linking isnt working at all anymore, so wondering if you ended up finding a solution to this?

14

I have not. In fact, I really need to update the first post, as the only deep linking that works anymore is the AppleTV+ deep links. For services that support the tie in with the TV app (which is basically everything except Netflix), I now use the TV app deep link to get to the episode and then click the play button there so that the TV app can open the other app. It’s not ideal, but it’s better than nothing.

Netflix wants to force you to look at all their suggestions and crap, so the only thing I can do with Netflix stuff is open the app and then navigate around to find what I’m trying to watch. It’s one of the reasons I cancelled my Netflix subscription (the other being the never ending price increases), so now I only subscribe to Netflix a couple months a year to go through and watch the stuff that’s piled up.

15

Hello,

wich app do you use for deep link netflix? It’s an app from the tvos store? You say " tv app deep link" its the complete name of the app?

16

It’s Apple’s app that has the name TV. There is no way to do it for Netflix though. Netflix doesn’t integrate with Apple’s TV app because Netflix wants you to see all their suggested crap. So the only think I can do with my setup is open the Netflix app automatically for a show the system knows is on Netflix. Netflix deep linking worked for a while, but then they “fixed” that during an update too.

It’s one of the many reasons I dropped my Netflix subscription and now just subscribe for two or three months a year and binge everything that’s come out in the last year that I want to watch.

17

I understand, thank you for all the details, I will try to use my jellyfin media server, if it works it will definitely replace Netflix

18

Pluto and Disney+ normal web URL’s work just fine:

https://pluto.tv/us/live-tv/65d92a8c8b24c80008e285c0
https://www.disneyplus.com/browse/entity-cac75c8f-a9e2-4d95-ac73-1cf1cc7b9568
19

For Spotify, this format has been working for me. You need to use a URI rather than a Spotify URL directly. The play=true parameter makes it autoplay rather than just opening the details.

Unfortunately, this (as of time of writing) does not work with tracks or episodes for some reason. Playlists, albums, artists, and shows all work however (with the annoying caveat that a “show”/podcast starts from the first episode every time).

So your best bet is probably to make a playlist with the track you’d like, and deeplink to that unless someone else finds a way to make links to specific tracks work.

service: media_player.play_media
data:
  media_content_id: spotify:?uri=spotify:album:2lIZef4lzdvZkiiCzvPKj7&play=true
  media_content_type: url
target:
  entity_id: media_player.apple_tv
20

How do you get the deep link for the TV app page? :slight_smile:

21

For AppleTV+ shows you can use the TV app on MacOS or iOS for this. Once you find the show, in the list of episodes there will be a menu under the three dots, and one of the options is SHARE EPISODE. From there you have the option to copy the link.

Be aware that the link contains some characters that you probably have to URL encode so that the link can be passed. For instance, ?showID= has to be changed to %3FshowId%3D.

If you have other apps linked to your TV app (like Paramount+), you have to do this from an iOS device that has the TV app and the third party app. The MacOS TV app won’t show you shows from other apps.