moviegroupies

Add movies to one of your movie lists from another source — a movie list, a group's grouplist, a curated list, or a search — skipping ones already there. Only the movies are copied, never anyone's ratings or comments. Optional filters (title, genre, years, language, minimum votes, and rating for movie lists and grouplists) narrow whatever the source is. Imports every match across all pages, not just the first page, so check the count with view_movielist, view_grouplist or search_movies first. A search needs at least one filter. Omit both list_id and list_name to import into your default list. Returns how many movies were added and the target list, with ids.

import_movies

Invite someone to one of your groups by email — they'll receive an invitation email whether or not they already have a moviegroupies account. Returns confirmation naming the invited email (plus their user id if they already have an account) and the group, with its id.

invite_to_group

Join a group — either by pasting an invite link's token, or by accepting an existing pending invitation by group_id/group_name. Whether your default list gets shared with the group defaults to your saved sharing preference unless share_default_list is given explicitly. Returns confirmation with the joined group's name and id, noting if your default list (with its id) was shared with it.

join_group

Leave one of your groups. If you're the group's only admin, promote someone else first. Returns confirmation naming the group you left and its id.

leave_group

Share or unshare one of your movie lists with one of your groups. Unsharing revokes the group's access to the list. Returns confirmation naming the list and group, with both ids.

manage_list_sharing

Full details for one movie — genres, rating, overview, which of your lists it's on, and how your groups have rated it. Returns title, genres, rating, popularity, overview, ids (movie/tmdb/imdb/rt), links (TMDB/IMDb/RT/poster), which of your lists it's on, and your groups' average ratings.

movie_detail

Your moviegroupies groups — name, your role, and when you joined. Returns one line per group: name, your role, join date, and group id.

my_groups

Your movie lists — name, item count, and which one is your default. Returns one line per list: name, default flag, item count, and list id.

my_movielists

Your account info — email, tier, tier limits, and saved search preferences. Returns email, tier and its limits, your share-on-join preference, and your search preferences (language, minimum votes).

my_profile

Promote a member to admin in a group. Admins only. Returns confirmation naming the promoted member (with user id) and the group (with id).

promote_group_member

Set your rating, want-to-watch level, and/or a comment on a movie in your default list. All fields optional and independent — with none given, this just adds the movie to your default list. Use clear_rating/clear_want/clear_comment to remove a field instead of setting it. Returns confirmation naming the movie, what was set/cleared, the movie id, and your default list's id.

rate_movie

Recent ratings and wants from your moviegroupies groups, paginated and optionally filtered to one group by id or name. Returns one line per event: username and user id, rating/want, movie title and id, which group(s) with ids, and timestamp.

recent_activity

Remove a member from a group. Admins only. Returns confirmation naming the removed member (with user id) and the group (with id).

remove_group_member

Remove a movie from one of your movie lists. Also deletes the rating and comment on that entry. Omit both list_id and list_name to remove from your default list. Returns confirmation naming the movie and list, with both ids.

remove_movie_from_list

Rename one of your groups. Admins only. Returns confirmation with the group's id and its old/new name.

rename_group

Rename one of your movie lists. Only changes the name; does not touch the movies or who the list is shared with. Returns confirmation with the list's id and its old/new name.

rename_movielist

Search the movie catalog with optional filters for title text, genre, year range, original language, minimum vote count, and sort order. Returns one line per movie: title, year, genres, popularity, and movie id.

search_movies

Update your username and/or saved preferences: default search language filter, default minimum vote count filter, and whether new groups get your default list shared automatically. All fields optional — only what's passed is changed, and the previous values are replaced (use the clear_* fields to remove a setting). A username is just a display name and need not be unique; your email identifies your account. Returns confirmation of what changed plus your resulting username and preferences.

update_profile

See the movies in one curated list, from view_curated_lists. Returns the list's name and id, then one line per movie: rank, title, year, genres, and movie id.

view_curated_list

Browse available curated movie lists: TMDB Upcoming, TMDB Top 250, IMDb Top 250, NYT 100 Best Movies of the 21st Century, NYT 100 Top Movies According to Readers, AFI 100 Greatest American Films (2007), and Moviegroupies Crème de la Crème. Returns one line per list: name, movie count, curated list id, slug, and description.

view_curated_lists

See who's in a group — username, role, and when they joined. Returns one line per member: username, role, join date, and user id.

view_group_members

See every list shared with a group, by any member — not just your own. Pair with view_movielist(list_id=...) to browse one of them. Returns one line per shared list: the owner's username and user id, the list's name and id, and the share date.

view_group_shared_lists

Browse the movies shared across a group's lists, with the same filters as the grouplist page: title text, genre, year range, rating, sort order. Requires either group_id or group_name. Returns the group's name and id, then one line per movie: title, year, genres, the group's average rating/want, comment count, and movie id. Sorting by avg_rating or avg_want also weighs how many members rated, so a 4.8 from six ratings ranks above a single 5; the averages shown are the plain ones.

view_grouplist

See which of your movie lists are shared with which of your groups. Optionally narrow to one list and/or one group. Returns one line per list: its name, id, and which of your groups it's shared with (with ids).

view_list_sharing

Browse the movies in one of your movie lists, with the same filters as the list page: title text, genre, year range, rating, sort order. Omit list_id and list_name to browse your default list. Also works on another member's list as long as it's shared with a group you're both in — pass that list's id (e.g. from view_group_shared_lists). Returns the list's name and id, then one line per movie: title, year, genres, the viewed owner's rating/want/comment, and movie id.

view_movielist

See your pending group invitations — join_group and decline_invitation both work off these. Returns one line per invitation: the group's name and id, who invited you (with their user id), and the date.

view_pending_invitations

See invitations you've sent to join your groups — to existing users and to new sign-ups alike — with their status. Optionally narrow to one group. Returns one line per invitation: the invitee's email (and user id if they have an account), status, the group's name and id, and the date.

view_sent_invitations