search_titles
Find a movie or show
Find a movie or TV show from its name, a remembered fragment or a typo. Resolve its exact version before recommendations or availability checks. Returns canonical IDs and rich title context: description, genres, subgenres, tags, subjects, keywords, cast, directors, language and runtime. Choices cover viewer-mentioned titles or assistant-chosen mood references.
輸入參數request必填
recommend_titles
Find what to watch next
Find movies like X, shows to watch after Y, or alternatives when someone liked one title but disliked another. Resolve names with search_titles first, then pass positive and disliked reference IDs plus any desired qualities. For an open-ended or mood-only start, use get_charts first. Returns up to twelve candidates with ReelRecs Score, descriptions, genres, subgenres, subjects, tags, keywords, cast, directors, runtime, reference overlaps and title links. General similarity supplies the neighborhood; intent selects the supporting evidence emphasis. Dislikes adjust comparable affinities; exclusions hide exact titles. The qualities_applied field identifies whether mood text affected ranking. Provider filters apply in the requested country; country alone does not filter availability. No account required.
輸入參數request必填
get_title_peers
Compare similar movies or shows
Find optional content references for one resolved movie or show when a comparison is useful. Returns ReelRecs Score out of 10, descriptions, tags, subgenres and links. Candidates are selected from content without audience-score or viewing/rating-affinity selection. They do not represent a shared group of raters, and no peer average is calculated. Missing scores are null. Streaming offers are not included.
輸入參數request必填
get_charts
Find trending movies and TV shows
Start here for "Netflix tonight", "What should I watch?", "Good shows", "Something light" or what's popular on streaming, including when an account is connected. Find current candidates first, then judge their fit for the viewer's mood. No reference title or preference questionnaire is needed. Returns up to twelve candidates from the latest available U.S. audience charts, with ReelRecs Score, descriptions, genres, subgenres, tags, keywords, subjects, cast, directors, runtime and links. An authorized connection can also add personal Rec Score predictions to these current choices. Streaming-service filtering uses constraints.providers with constraints.country; country alone does not establish availability. Also supports genre, runtime, first-release-year and exclusion filters. Trending and rising measure attention at chart_as_of; popular measures broader audience demand. chart_freshness and chart_age_days distinguish dated discovery snapshots from current rankings. Chart attention is distinct from new releases, and the chart market is distinct from availability country. Provides movie and series discovery, not live sports fixtures or broadcast schedules. No ReelRecs account required.
輸入參數request必填
get_watch_options
Find where to watch
Find where to watch a movie or show, including on the viewer's saved services. Resolve names with search_titles first, then pass up to ten exact IDs. Returns providers, offer types, observation dates and availability freshness. With personal access, also returns streaming_preferences.services and matches_saved_service on each offer. Lead with matching included offers; matching rentals and purchases still cost extra. Use saved services without asking the viewer to repeat them. Subscription, free/ad-supported, rental and purchase are separate. An empty or stale result does not prove worldwide unavailability. No ReelRecs account required for public offers.
輸入參數request必填
get_my_profile
Check my ReelRecs connection
Requires a connected ReelRecs account. Returns display identity, whether saved taste is available, and the viewer's saved streaming-service names in streaming_preferences.services. Use these when the viewer asks about their services. get_watch_options also matches offers to these preferences. Never exports full history.
無需輸入參數。
recommend_for_me
Recommend using my saved taste
Use when the viewer asks to explore their saved taste or the wider library, such as "recommend based on my ratings". For an open-ended "Netflix tonight", "What should I watch?" or mood-only start, use get_charts first even when connected; current chart candidates can include personal predictions too. This tool ranks the wider catalogue by saved taste, positive or disliked reference titles and desired qualities. Returns up to twelve candidates with rich title context, audience ReelRecs Score, personal Your Rec Score predictions and links. Both scores use a ten-point scale; missing predictions are null. Weigh personal fit with the viewing experience and tonight's mood. Excludes watched titles unless rewatch is requested and can use saved streaming services. Saved taste describes lasting preferences; the qualities_applied field identifies whether mood text affected ranking. Requires an authorized ReelRecs account and never accepts an account identifier.
輸入參數request必填
get_my_ratings
Browse and look up my saved ratings
Use for my ratings, all the movies and shows I rated, understand my taste, what I loved or disliked, and have I rated this title. Omit title_ids to browse the viewer's full rated list, independently of bookmarks. Browse with an optional title fragment, kind, highest/lowest/title sort, and next_offset; up to 50 titles per page. For a requested full-history taste analysis, read all pages and use both high and low ratings with the returned descriptions, genres, subgenres and tags. Curate a few picks using that evidence; personal predictions are secondary when requested. Alternatively supply up to ten resolved title_ids to check saved ratings or confirmed absence for those specific titles. Requires ratings:read. Saved ratings, audience scores and personal predictions are distinct. A successful lookup confirms the connection. Cannot read another account or change ratings.
輸入參數request必填
get_my_bookmarks
Browse my bookmarked movies and shows
Use for my bookmarks, my watchlist, saved movies or shows, did I save this title, and help me pick from my list. Lists the connected viewer's own saves, newest first; query searches the full list by title fragment, kind filters movies or shows, and next_offset retrieves another page. Start a simple browse with the default page and a short linked list; show remaining fetched titles before fetching more when requested or when it helps choose. matched_count is the total for the applied filters. If a movie/show breakdown is requested, use kind-filtered counts rather than estimating it. Returns saved dates, descriptions, genres, subgenres, tags, runtime, ReelRecs links and audience scores. With personal recommendation permission, also adds Your Rec Score predictions. Keep picks within the returned bookmarks when requested, check watch options, and curate a few fitting choices using available returned title links. Rated or watched titles can still be bookmarked; do not infer history or likes from a save. Requires bookmarks:read permission. Cannot read another account or add/remove saves.
輸入參數request必填
get_my_watchplus_groups
Find my Watch+ groups
Find the connected viewer's accepted Watch+ groups by group or member name, such as Jenna. Returns current accepted member IDs, display names and app usernames, never emails or pending invitees. Use these IDs for the people watching now, then recommend_for_group. Match usernames to distinguish duplicate names; when the same people share several groups, prefer the smallest matching group unless the viewer names one. Proceed directly when the people are clear. Requires watchplus:read permission.
輸入參數request必填
get_watchplus_context
Understand our Watch+ tastes
Explore the selected accepted group members' accessible tastes. Returns liked and less-liked examples and descriptive patterns. Supply up to ten resolved title IDs for each person's predicted rating, saved rating, Watch+ interest/pass and relevant saved references, including evidence beyond the overview examples. Helps explain shared appeal, differences, reservations and compromises. Profiles respect existing privacy and blocks. Missing evidence is unknown. Similar saved titles illustrate content overlap; they do not explain the scoring model's causes. Requires watchplus:read; cannot read strangers, pending invitations, private chats or change anything.
輸入參數request必填
recommend_for_group
Find something we will enjoy together
Choose what the accepted Watch+ members watching together might enjoy tonight. Resolve the group and people with get_my_watchplus_groups first. Returns up to twelve compact candidates for the assistant to curate into two or three, with rich title details, audience ReelRecs Score, separate per-person Rec Score predictions, saved ratings, Watch+ votes and related likes/dislikes. Prioritizes balanced fit and current interest by default; focus=all_titles explores the library. Pass votes lower priority without changing predictions. Excludes known seen titles unless allow_rewatch. Use current mood, positive/disliked references and streaming filters when known; do not demand a questionnaire. Predictions require fresh completed scores; missing coverage never means agreement. Requires watchplus:read and current accepted membership. Privacy and blocks are checked again before returning.
輸入參數request必填
report_recommendation_feedback
Share recommendation feedback with ReelRecs
Record a brief quality report about a meaningful acceptance, rejection, correction or concrete problem with ReelRecs results, when permitted by the viewer and host. At most one report per new signal across ReelRecs tools. Accepts the relevant result request_id and up to five affected title IDs copied from results when available; otherwise omit them. IDs must not be invented. The paraphrase is limited to 300 characters. User statements, actions and uncertain assistant inferences are separate evidence types; inference confidence must be low or medium. Silence or continued use is not evidence of a reaction. Transcripts, identity, credentials and sensitive personal details are outside the report's scope. Reports are unverified observations and cannot change saved ratings or taste. Returns receipt acknowledgement; host approval controls and viewer opt-out apply.
輸入參數request必填