News Help

How-to guides and documentation for News features.

37 articles

Add Topic

Add a new topic to the saved list and switch to it.

Close Hot Topics Modal

Close the Hot Topics modal (also stops any hot topics TTS playback).

Generate Hot Topics

Fetch a fresh list of trending hot topics across all categories (Tech, Politics, Business, Science, Entertainment, Sport

Generate Missing Audio

Generate AI narration (TTS) for all topics that have carousel slides but no audio yet. This costs credits.

Generate Missing Backgrounds

Generate AI background images for all carousel slides that are missing one. This costs credits.

Generate Topic Audio

Generate AI audio narration (TTS) for a specific topic. If no topic is provided, generates for the current topic.

Get Audience Profile

Return the current audience profile (publisher, tone, description, ageRange, location, occupation, concerns).

Get Current Topic

Return the currently selected news topic and a summary of its latest review.

Get Missing Audio Count

Return how many topics have carousel slides but no generated audio narration yet, and their names.

Get Missing Background Count

Return how many carousel slides across all topics are missing a generated background image.

Get Review Summary

Return the full structured review data (sections, who/what/where/when/how/why, articles list) for the current topic.

Get Settings

Return all current app settings (image toggles, etc.).

Get Stale Topics Count

Return how many saved topics have outdated news (stale) and their names. Use before calling refreshStaleTopics.

Hot Topics Skip Back Category

Skip back to the first topic of the previous category during hot topics TTS playback.

Hot Topics Skip Back Topic

Skip back to the previous topic within the current category during hot topics TTS playback.

Hot Topics Skip Category

Skip to the first topic of the next category during hot topics TTS playback.

Hot Topics Skip Topic

Skip to the next topic within the current category during hot topics TTS playback.

Hot Topics Tts Get State

Return the current hot topics TTS state (idle/playing/paused), the active category index, topic index, and total categor

Hot Topics Tts Pause

Pause hot topics TTS playback.

Hot Topics Tts Play

Open the Hot Topics modal and start or resume reading hot topic titles and reasons aloud, category by category.

Hot Topics Tts Stop

Stop hot topics TTS playback and reset to the beginning.

List Hot Topics

Return the current hot topics list organised by category, as last fetched.

List Topics

Return the list of all saved news topics.

Navigate History

Navigate backwards or forwards through the review history for the current topic.

Open Audience Profile Modal

Open the Audience Profile modal so the user can view and edit their audience settings.

Open Hot Topics Modal

Open the Hot Topics modal so the user can see the topics list.

Refresh News

Fetch fresh news for a topic (or the current topic if none specified). This costs credits.

Refresh Stale Topics

Fetch fresh news for all outdated topics at once. This costs credits (one refresh per stale topic).

Remove Topic

Remove a topic from the saved list.

Set Audience Profile

Update one or more audience profile fields. Available fields: publisher, tone, description, ageRange, location, occupati

Set Setting

Toggle or set a named app setting. Available keys: autoplay, partnershipWithReloadium.

Switch Topic

Switch the app to display a different saved topic. Use listTopics first to see available options.

Tts Get State

Return the current audio player state (idle/playing/paused), currentTime (seconds), and total duration (seconds).

Tts Pause

Pause TTS playback.

Tts Play

Start or resume reading the current press review aloud using text-to-speech.

Tts Skip

Skip forward or backward in audio playback. Each unit = 30 seconds.

Tts Stop

Stop TTS playback and reset position to the beginning.