ask_grok_web
ChatGPTAsk Grok (xAI) a research question answered from the public web using xAI Web Search. Returns a written answer and source citations. Does not use a connected account. The prompt is sent to xAI. Billed per request from ExTweets credits.
ask_grok_x
ChatGPTAsk Grok (xAI) a research question answered from public posts on X using xAI X Search. Returns a written answer and source citations. Does not use or act as a connected account. The prompt is sent to xAI. Billed per request from ExTweets credits.
delete_post
ChatGPTPermanently delete a post, or a direct message the account sent (dm_event_id). This can't be undone, so confirm with the user first. Requires delete permission for this client.
follow_user
ChatGPTFollow a user from a connected account. The follow is public and notifies the user. Billed per call plus one profile lookup.
get_bookmarks
ChatGPTGet the connected account's private bookmarks, most recently bookmarked first, one page per call. Pass meta.next_token as pagination_token for older bookmarks. Billed per post returned.
get_dm_history
ChatGPTRead the private direct message history between the connected account and one user, newest first, one page per call. X only returns DM events from the last 30 days. Requires DM permission on both the account and this client. Billed per event returned plus one profile lookup.
get_home_timeline
ChatGPTGet the connected account's home timeline (posts from accounts it follows), newest first, one page per call. X exposes only recent posts here (at most about 3,200). Pass meta.next_token as pagination_token for older posts. Billed per post returned.
get_lists
ChatGPTFind X lists. which: owned, followed, memberships (lists the user is on), or pinned, for user (default the connected account); or details for one list_id. Read a list's posts with get_timeline and its members with get_users. Billed per list returned.
get_mentions
ChatGPTGet posts that mention the connected account (incoming replies and tags), newest first, one page per call. X only exposes the 800 most recent mentions. Pass meta.next_token as pagination_token for older ones. Billed per post returned.
get_my_profile
ChatGPTGet the profile of the selected connected account. Billed per call.
get_posts
ChatGPTGet one or more posts by ID or link, with author, media, and public metrics. For a single post, include can also fetch its replies (last 7 days), quote posts, who reposted it, who liked it, and analytics (impressions, engagements; only for the connected account's own posts). Billed per item returned.
get_recent_dms
ChatGPTRead the connected account's recent private direct message events across all conversations, newest first, one page per call. X only returns DM events from the last 30 days. Requires DM permission on both the account and this client. Billed per event returned.
get_timeline
ChatGPTRead a feed of posts, newest first. source: home (the account's home timeline), user (a user's posts; the latest 3,200 at most), mentions (the latest 800), likes (posts a user liked), bookmarks, bookmark_folders (lists folders; with folder_id, the posts in one), list (a list's posts), or space (posts shared in a Space). user defaults to the connected account. Billed per item returned.
get_trends
ChatGPTGet trending topics: personalized for the connected account (default), or for a location by Yahoo WOEID (1 = worldwide, 23424977 = United States, 23424775 = Canada, 23424975 = United Kingdom). Billed per request.
get_user_profile
ChatGPTLook up a public Twitter profile by username: bio, follower and post counts, verification. Billed per call.
get_user_timeline
ChatGPTGet posts authored by a user, newest first, one page per call. X only exposes a user's 3,200 most recent posts; older history is not available. Pass meta.next_token as pagination_token to page back. Billed per post returned plus one profile lookup.
get_users
ChatGPTLook up public Twitter accounts, as the connected account. relation: by_username (the accounts with the given usernames), me (the connected account itself), followers or following (one page of an account's followers or followed accounts, default the connected account), muted or blocked (the connected account's own mute and block lists), list_members or list_followers (of the list in list_id). Returns public account fields: name, username, bio, website, join date, and follower counts. Billed per account returned.
interact_with_post
ChatGPTAct on one or more posts from a connected account: like, unlike, repost, undo_repost, bookmark, remove_bookmark, hide_reply (hide a reply to one of your posts), or unhide_reply. Visible to others where X shows it. Confirm with the user first. Each post is billed separately.
list_x_accounts
ChatGPTList the Twitter (X) accounts connected to this ExTweets user and the permissions each one granted (read, post, engage, dm). Free. Call this before account-specific tools: when more than one account is connected, every Twitter tool needs the account parameter.
manage_lists
ChatGPTManage X lists for a connected account: create, update (name, description, private), delete, add_members, remove_members, follow, unfollow, pin, or unpin. Confirm with the user first. Each change is billed separately.
manage_relationship
ChatGPTChange how a connected account relates to other accounts: follow, unfollow, mute, or unmute one or more users by username. (X doesn't let apps block or unblock; get_users can still list blocked accounts.) Confirm with the user first. Each user is billed separately, plus one profile lookup.
publish_post
ChatGPTPublish from a connected account. Visible to everyone immediately, so confirm the exact text and the account with the user first. One item in posts publishes a post; several publish a thread in order. Also: reply_to (reply to a post), quote (quote a post), edit (edit a recent post of yours; X Premium), images or a video per post from links (uploaded for you), polls, reply restrictions, and communities. Posts over 280 characters need X Premium. X only lets apps reply to or quote posts that mention the account or that it wrote. An identical post is refused for 10 minutes so a retry can't publish twice. Posts with a link are billed at X's higher link rate.
read_messages
ChatGPTRead the connected account's direct messages, newest first: recent messages across all conversations (default), the conversation with one user (with), or one conversation by conversation_id (including groups). X keeps the last 30 days available. Requires DM permission on both the account and this client. Billed per message returned.
research
ChatGPTAsk Grok (xAI) a research question and get a written answer with source citations. sources "x" answers from public posts on X (optionally limited to handles or dates); "web" answers from the public web. Does not act as a connected account. The question is sent to xAI. Billed per request by the work it takes.
search_x
ChatGPTSearch X for posts, people, news stories, Spaces, or communities (type, default posts). Post search covers the last 7 days; only when the user asks about something older, set start_time (and end_time) to search the full archive back to 2006, which is slower. Post search supports X operators such as from:, to:, conversation_id:, and -is:retweet. Billed per item returned.
send_dm
ChatGPTSend a private direct message from a connected account to one user. It is delivered immediately and cannot be unsent through ExTweets. Confirm the recipient, text, and sending account with the user first. An identical message to the same recipient is refused for 10 minutes so a retry cannot send twice. Requires DM permission on both the account and this client.
send_message
ChatGPTSend a direct message from a connected account: to one user, to several (starts a group conversation), or into an existing conversation_id. Can include one image or video by link. Private but can't be unsent by the recipient, so confirm the text and recipients first. Requires DM permission on the account and this client. An identical message is refused for 10 minutes so a retry can't send twice.
unfollow_user
ChatGPTUnfollow a user from a connected account. Billed per call plus one profile lookup.