Twitter

Creates a new, empty list on x (formerly twitter), for which the provided name must be unique for the authenticated user; accounts are added separately.

Creates a tweet on twitter; `text` is required unless `card uri`, `media media ids`, `poll options`, or `quote tweet id` is provided.

Permanently deletes a specified twitter list using its id, which must be owned by the authenticated user; this action is irreversible and the list must already exist.

Allows an authenticated user (path `id`) to follow another user (`target user id`), which results in a pending request if the target user's tweets are protected.

Retrieves user objects for accounts blocked by the specified user id; this is a read-only view of a user's block list.

Irreversibly deletes a specific tweet by its id; the tweet may persist in third-party caches after deletion.

Allows the authenticated `source user id` to unfollow an existing twitter user (`target user id`), which removes the follow relationship.

Fetches public profile information for a valid and existing twitter user by their username, optionally expanding related data like pinned tweets; results may be limited for protected profiles not followed by the authenticated user.

Returns profile information for the currently authenticated x user, customizable via request fields.

Adds a user to a specified twitter list; the list must be owned by the authenticated user.

Adds a specified, existing, and accessible tweet to a user's bookmarks, with success indicated by the 'bookmarked' field in the response.

Retrieves tweets bookmarked by the authenticated user, where the provided user id must match the authenticated user's id.

Creates a new group direct message (dm) conversation on twitter with specified participant ids and an initial message, which can include text and media attachments.

Creates a new compliance job to check the status of tweet or user ids; upload ids as a plain text file (one id per line) to the `upload url` received in the response.

Permanently deletes a specific twitter direct message (dm) event using its `event id` if the authenticated user sent it; this action is irreversible and does not delete entire conversations.

Fetches members of a specific twitter list, identified by its unique id.

Retrieves a list of users who purchased tickets for a specific, valid, and ticketed twitter space.

Retrieves a list of users who follow a specified public twitter user id.

Retrieves users followed by a specific twitter user, allowing pagination and customization of returned user and tweet data fields via expansions.

Allows the authenticated user (`id`) to follow a specific twitter list (`list id`) they are permitted to access, subscribing them to the list's timeline; this does not automatically follow individual list members.

Searches the full archive of public tweets from march 2006 onwards; use 'start time' and 'end time' together for a defined time window.

Returns a count of tweets from the full archive that match a specified query, aggregated by day, hour, or minute; `start time` must be before `end time` if both are provided, and `since id`/`until id` cannot be used with `start time`/`end time`.

Retrieves all twitter lists a specified user is a member of, including public lists and private lists the authenticated user is authorized to view.

Call this action to retrieve lists created (owned) by a specific twitter user, not lists they follow or are subscribed to.

Retrieves the lists a specific, existing twitter user has pinned to their profile to highlight them.

Fetches a specific direct message (dm) event by its unique id, allowing optional expansion of related data like users or tweets; ensure the `event id` refers to an existing dm event accessible to the authenticated user.

Fetches direct message (dm) events for a one-on-one conversation with a specified participant id, ordered chronologically newest to oldest; does not support group dms.

Fetches a list of users who follow a specific twitter list, identified by its id; ensure the authenticated user has access if the list is private.

Returns user objects muted by the x user identified by the `id` path parameter.

Retrieves users who publicly retweeted a specified public post id, excluding quote tweets and retweets from private accounts.

Returns recent direct message events for the authenticated user, such as new messages or changes in conversation participants.

Returns metadata (not tweets) for lists a specific twitter user follows, optionally including expanded owner details.

Hides or unhides an existing reply tweet.

Returns metadata for a specific twitter list, identified by its id; does not return list members but can expand the owner's user object via the `expansions` parameter.

Fetches the most recent tweets posted by members of a specified twitter list.

Retrieves users who have liked the post (tweet) identified by the provided id.

Mutes a target user on behalf of an authenticated user, preventing the target's tweets and retweets from appearing in the authenticated user's home timeline without notifying the target.

Pins a specified list to the authenticated user's profile, provided the list exists, the user has access rights, and the pin limit (typically 5 lists) is not exceeded.

Establishes a persistent stream of real-time events for when tweet labels are applied or removed, offering insights into content categorization.

Fetches comprehensive details for a single tweet by its unique id, provided the tweet exists and is accessible.

Retrieves detailed information for one or more posts (tweets) identified by their unique ids, allowing selection of specific fields and expansions.

Fetches tweet usage statistics for a project (e.g., consumption, caps, daily breakdowns for project & client apps) to monitor api limits; data can be retrieved for 1 to 90 days.

Searches tweets from the last 7 days matching a query (using x's search syntax), ideal for real-time analysis and trend monitoring.

Retrieves the count of tweets matching a specified search query within the last 7 days, aggregated by 'minute', 'hour', or 'day'.

Removes a tweet, specified by `tweet id`, from the authenticated user's bookmarks; the tweet must have been previously bookmarked by the user for the action to have an effect.

Removes a user from a twitter list; the response `is member` field will be `false` if removal was successful or the user was not a member, and the updated list of members is not returned.

Returns a list of recent compliance jobs, filtered by type (tweets or users) and optionally by status.

Retrieves status, download/upload urls, and other details for an existing twitter compliance job specified by its unique id.

Retrieves direct message (dm) events for a specific conversation id on twitter, useful for analyzing messages and participant activities.

Retrieves tweets from a specified twitter space id; the space must be accessible and results are batched (not streamed).

Retrieves tweets that quote a specified tweet, requiring a valid tweet id.

Retrieves tweets that retweeted a specified public or authenticated-user-accessible tweet id, optionally customizing the response with fields and expansions.

Retrieves tweets liked by a specified twitter user, provided their liked tweets are public or accessible.

Fetches the openapi specification (json) for twitter's api v2, used to programmatically understand the api's structure for developing client libraries or tools.

Retweets a tweet (`tweet id`) for a given user (`id`), provided the tweet is public (or user follows if protected), not already retweeted by the user, and its author has not blocked the user.

Searches for twitter spaces by a textual query, optionally filtering by state (live, scheduled, all) to discover audio conversations.

Sends a message, with optional text and/or media attachments (using pre-uploaded `media id`s), to a specified twitter direct message conversation.

Sends a new direct message with text and/or media (media id for attachments must be pre-uploaded) to a specified twitter user; this creates a new dm and does not modify existing messages.

Retrieves details for a twitter space by its id, allowing for customization and expansion of related data, provided the space id is valid and accessible.

Retrieves twitter spaces created by a list of specified user ids, with options to customize returned data fields.

Fetches detailed information for one or more twitter spaces (live, scheduled, or ended) by their unique ids; at least one space id must be provided.

Enables a user (via `id`) to unfollow a specific twitter list (via `list id`), which removes its tweets from their timeline and stops related notifications; the action reports `following: false` on success, even if the user was not initially following the list.

Allows an authenticated user (`id`) to remove their like from a specific post (`tweet id`); the action is idempotent and completes successfully even if the post was not liked.

Unmutes a `target user id` for the `source user id` (authenticated user), allowing the source user to see tweets and notifications from the target user again.

Unpins a list (specified by list id) from a user's profile (specified by id), provided the list is currently pinned by that user.

Removes a user's retweet of a specified post, if the user had previously retweeted it.

Updates an existing twitter list's name, description, or privacy status, requiring the list id and at least one mutable property.

Retrieves the most recent tweets and retweets posted by a specified twitter user in reverse chronological order, excluding replies/mentions unless part of self-threads/retweets; useful for showing latest activity without algorithmic sorting.

Allows the authenticated user (`id`) to like a specific, accessible tweet (`tweet id`), provided neither user has blocked the other and the authenticated user is not restricted from liking.

Retrieves detailed public information for a twitter user by their id, optionally expanding related data (e.g., pinned tweets) and specifying particular user or tweet fields to return.

Retrieves detailed information for specified x (formerly twitter) user ids, optionally customizing returned fields and expanding related entities.

Retrieves detailed information for 1 to 100 twitter users by their usernames (each 1-15 alphanumeric characters/underscores), allowing customizable user/tweet fields and expansion of related data like pinned tweets.