How to implement Deep Linking in webOS TV app so content from LG Home Search opens and plays movie automatically?

Hello LG webOS TV Developers and Moderators,

I have developed an OTT video streaming app for LG webOS TV and I want to make our movies and TV shows appear in the LG TV Home Page Global Search (Universal Search).

My goal is:

  • When a user searches for a movie name on the LG TV home screen search bar, our content should show up in the results (with poster, title, etc.).

  • When the user clicks on our content card, it should deep-link directly into our app and automatically start playing that exact movie.

I have already implemented basic app functionality, but I need help with the deep linking part.

My questions:

  1. What is the correct way to handle deep linking / launch parameters in a webOS TV app so it receives the movie ID or content ID from LG Universal Search?

  2. Can someone share a working code example (JavaScript) for listening to deep link parameters on app launch? (I saw mentions of webOSLaunch event and webOS.launchParams — is that the right approach?)

  3. What steps do I need to follow to test deep linking right now (using webOS CLI / ares-launch or emulator)?

  4. Before I approach LG for Universal Search / Content Discovery partnership, what should I prepare in my app? (For example: specific deep link format, content feed, etc.)

  5. Is there any official documentation or sample app for OTT deep linking from Universal Search?

I am ready to provide any required information (app ID, sample code, etc.) and follow all guidelines.

Any help or guidance would be greatly appreciated. Thank you in advance!

Best regards,

Please contact LG Seller Lounge > 1:1 Q&A > Partnership. Thank you.