App Logo
x.com

Create an X (Twitter) List

Automatically create an X (Twitter) List on x.com. Create an X (Twitter) List with a name (25 characters at most), an optional description (100) and public or private visibility. Returns the new list_id, its url, the name, the description and whether it is private. Add accounts to it with add_to_list.

Input

name required

The List's display name. X caps this at 25 characters — the composer itself refuses more.

private optional

When true, only this account can see the List (its members and its posts). When false, it's public.

Default: false
description optional

Optional description shown on the List's page. X caps this at 100 characters.

Output

url required
name required
list_id required
private required
description optional

FAQ

Create an X (Twitter) List with a name (25 characters at most), an optional description (100) and public or private visibility. Returns the new list_id, its url, the name, the description and whether it is private. Add accounts to it with add_to_list.
Ask an AI agent connected to Reduck to run reduck/x.com/create_list, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/x.com/create_list
You do not need one. "Create an X (Twitter) List" drives the real x.com pages in a browser, so it works whether or not x.com offers an API for this.
Required: name. Optional: private, description.
It returns url, name, list_id, private, description.
Yes. It acts as you on x.com: on your own Chrome it reuses your session, and on a Reduck-hosted browser it loads the x.com cookies saved by the Reduck extension.
It makes changes on x.com, like sending, posting, booking or buying something.
Ask an AI agent connected to Reduck to run reduck/x.com/create_list, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/x.com/create_list
It is part of Reduck's official curated catalogue.

Related scripts

x.com

X (Twitter) search unofficial API: search tweets, no API key

Search X (Twitter) for tweets with every X search operator, from the Top tab (a ranked sample, the default) or the Latest tab (chronological), picked by the tab arg. Returns per tweet a canonical record: id, url, author {id, handle, name}, text, created_at, lang, likes, retweets, replies, quotes, bookmarks, views, is_retweet, is_quote, plus followers (the author's follower count, a search-only enrichment), and the top-level query and count. Top is a ranked sample, not exhaustive.

x.com

Get a tweet and its replies on X (Twitter)

Get a tweet on X (Twitter) by URL, with the conversation around it: `tweet` (the post itself) and `replies` (every other post of its conversation on the page: the thread above it when it is a reply, and the replies below; use in_reply_to to rebuild the thread). Each post has id, url, author, text, created_at, lang, counts, in_reply_to and quoted_tweet. With count, it loads more replies until it has count or X reaches the end. complete is true only when X reached the end and left no folded replies (Show replies, hidden or probable-spam sections), which this script does not open. A deleted or unavailable tweet is an error. Requires being signed in to X.

x.com

X (Twitter) profile unofficial API: get a user's bio and followers

Look up an X (Twitter) user's profile by handle. Returns handle, user_id, name, bio, location, website, joined, followers_count, following_count, is_verified, is_self, is_following, follows_you. Counts are exact integers. bio and website carry the real destination URLs, with X's shortlinks resolved. is_following is null on your own profile. Any of is_self, is_following, follows_you and is_verified is null when X does not say. Requires being signed in to X; a missing or suspended account is an error that says which.

Start building not clicking

Get started for free