Skip to content
Scalekit Docs
Talk to an EngineerDashboard

Twitter / X connector

OAuth 2.0CommunicationMarketing

Connect to Twitter using OAuth 2.0 (Authorization Code with PKCE) to read and write Tweets on behalf of the authenticated user, manage users, follows...

Twitter / X connector

  1. Install the SDK

    Section titled “Install the SDK”
    Terminal window
    npm install @scalekit-sdk/node

    Full SDK reference: Node.js | Python

  2. Set your credentials

    Section titled “Set your credentials”

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>

  3. Set up the connector

    Section titled “Set up the connector”

    Register your Twitter / X credentials with Scalekit so it handles the token lifecycle. You do this once per environment.

    Dashboard setup steps

    Register your Twitter app credentials with Scalekit so it can manage the OAuth 2.0 authentication flow and token lifecycle on your behalf. You’ll need a Client ID and Client Secret from an app in the X Developer Console.

    1. Create a Twitter OAuth connection in Scalekit

      • In Scalekit dashboard, go to AgentKit > Connections > Create Connection. Search for Twitter OAuth and click Create.

      • In the Configure Twitter OAuth Connection panel, copy the Redirect URI. It looks like https://<SCALEKIT_ENVIRONMENT_URL>/sso/v1/oauth/<CONNECTION_ID>/callback. You’ll paste this into your X app in the next step.

    2. Choose or create an app in the X Developer Console

      • Go to the X Developer Console and sign in.

      • Under Access > Apps, either select an existing app or click + Create App.

        X Developer Console Create New Client Application dialog

    3. Configure user authentication settings

      • Open your app, go to Settings, and find User authentication settings.

      • Set the following values:

        SettingValue
        App permissionsRead and Write — needed to post and manage content on behalf of users
        Type of AppWeb App, Automated App or Bot
        Callback URI / Redirect URLPaste the Redirect URI from Scalekit
        Website URLYour application’s public homepage

        X app authentication settings showing App permissions, Type of App, and Callback URI fields

      • Click Save.

    4. Copy OAuth 2.0 credentials

      • In your app, go to the Keys & Tokens tab.

      • Under OAuth 2.0 Keys, copy the Client ID. Click Regenerate next to Client Secret if you haven’t generated one yet, then copy it.

        X app Keys and Tokens tab with Consumer Key, Secret Key, and Bearer Token values redacted

    5. Add credentials in Scalekit

      • In Scalekit dashboard, go to AgentKit > Connections and open the Twitter OAuth connection you created.

      • Enter your credentials:

        • Client ID — from the OAuth 2.0 Keys section
        • Client Secret — copied in the previous step
        • Scopes — select the permissions your app needs:
          • tweet.read — read tweets and timelines
          • tweet.write — create, delete, and manage tweets
          • users.read — read user profile data
          • follows.read — read follower/following lists
          • follows.write — follow and unfollow users
          • like.read — read liked tweets
          • like.write — like and unlike tweets
          • bookmark.read — read bookmarked tweets
          • bookmark.write — add and remove bookmarks
          • list.read — read list membership and tweets
          • list.write — create, update, and delete lists
          • dm.read — read direct messages
          • dm.write — send direct messages
          • mute.read — read muted users
          • mute.write — mute and unmute users
          • block.read — read blocked users
          • block.write — block and unblock users
          • offline.access — obtain refresh tokens for long-lived access

      • Click Save.

  4. Authorize and make your first call

    Section titled “Authorize and make your first call”
    quickstart.ts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    

    const scalekit = new ScalekitClient(
      process.env.SCALEKIT_ENV_URL,
      process.env.SCALEKIT_CLIENT_ID,
      process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    

    const connector = 'twitteroauth'
    const identifier = 'user_123'
    

    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Twitter / X:', link)
    process.stdout.write('Press Enter after authorizing...')
    await new Promise(r => process.stdin.once('data', r))
    

    // Make your first call
    const result = await actions.executeTool({
      connector,
      identifier,
      toolName: 'twitteroauth_activity_subscriptions_list',
      toolInput: {},
    })
    console.log(result)

What you can do

Section titled “What you can do”

Connect this agent connector to let your agent:

  • Search users, spaces, recent — Searches for users matching the provided query string, ranked by relevance
  • Username users lookup by, user lookup by — Retrieves detailed information for 1 to 100 Twitter users by their usernames (each 1-15 alphanumeric characters/underscores)
  • Lookup users, user, posts — Retrieves detailed information for specified X (formerly Twitter) user IDs
  • Unmute user — Unmutes a target user for the authenticated user, allowing them to see Tweets and notifications from the target user again
  • Unfollow user — Allows the authenticated user to unfollow an existing Twitter user, which removes the follow relationship
  • Get user timeline, user reposts of me, user posts — Retrieves the home timeline (reverse chronological feed) for the authenticated Twitter user

Tool list

Section titled “Tool list”

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

twitteroauth_activity_subscription_create#Creates a subscription for a single X activity event type, scoped to exactly one of a user (filter_user_id) or a keyword (filter_keyword) - Twitter rejects requests providing neither or both - delivered to a registered webhook. OAuth2 user-context tokens must hold the scope matching the requested event_type: dm.read for chat.* and dm.* events, like.read for like.* events, mute.read for mute.* events, block.read for block.* events, and tweet.read for all other event types. Mute and block subscriptions are actor-only.6 params

Creates a subscription for a single X activity event type, scoped to exactly one of a user (filter_user_id) or a keyword (filter_keyword) - Twitter rejects requests providing neither or both - delivered to a registered webhook. OAuth2 user-context tokens must hold the scope matching the requested event_type: dm.read for chat.* and dm.* events, like.read for like.* events, mute.read for mute.* events, block.read for block.* events, and tweet.read for all other event types. Mute and block subscriptions are actor-only.

NameTypeRequiredDescription
event_typestringrequiredActivity event type in dot notation
filter_directionstringoptionalOptional direction filter for directional events. Not supported for mute.* or block.* events.
filter_keywordstringoptionalOptional keyword filter
filter_user_idstringoptionalUser the subscription is scoped to. For mute.* and block.* events, this must be the authenticated source user.
tagstringoptionalOptional caller-defined tag
webhook_idstringoptionalWebhook to deliver the subscription events to
twitteroauth_activity_subscriptions_list#List existing X activity subscriptions for the authenticated app. Complements Create Activity Subscription, which only covers creating new subscriptions on this same resource.0 params

List existing X activity subscriptions for the authenticated app. Complements Create Activity Subscription, which only covers creating new subscriptions on this same resource.

twitteroauth_article_draft_create#Creates a draft X Article (long-form post) with a title and rich-text content, which can later be published with Publish Article. Requires an X Premium subscription on the posting account.3 params

Creates a draft X Article (long-form post) with a title and rich-text content, which can later be published with Publish Article. Requires an X Premium subscription on the posting account.

NameTypeRequiredDescription
content_stateobjectrequiredDraftJS content structure for the Article body: an object with a 'blocks' array (text blocks with text/type) and an 'entities' array (formatting entities such as links or embeds).
titlestringrequiredHeadline of the Article
cover_media_idstringoptionalMedia ID to use as the Article's cover image, from a prior media upload
twitteroauth_article_publish#Publishes a previously created draft X Article, making it publicly visible as a Post. Use Create Article Draft first to get an article_id.1 param

Publishes a previously created draft X Article, making it publicly visible as a Post. Use Create Article Draft first to get an article_id.

NameTypeRequiredDescription
article_idstringrequiredID of the draft Article to publish
twitteroauth_blocked_users_get#Retrieves the authenticated user's block list. The id parameter must be the authenticated user's ID. Use Get Authenticated User action first to obtain your user ID.5 params

Retrieves the authenticated user's block list. The id parameter must be the authenticated user's ID. Use Get Authenticated User action first to obtain your user ID.

NameTypeRequiredDescription
idstringrequiredAuthenticated user's Twitter ID — must match the authenticated user
expansionsstringoptionalComma-separated expansions
max_resultsintegeroptionalMax results per page (1-1000)
pagination_tokenstringoptionalPagination token for next page
user_fieldsstringoptionalComma-separated user fields
twitteroauth_bookmark_add#Adds a specified, existing, and accessible Tweet to a user's bookmarks. Success is indicated by the 'bookmarked' field in the response.2 params

Adds a specified, existing, and accessible Tweet to a user's bookmarks. Success is indicated by the 'bookmarked' field in the response.

NameTypeRequiredDescription
idstringrequiredAuthenticated user's Twitter ID
tweet_idstringrequiredID of the Tweet to bookmark
twitteroauth_bookmark_remove#Removes a Tweet from the authenticated user's bookmarks. The Tweet must have been previously bookmarked by the user for the action to have an effect.2 params

Removes a Tweet from the authenticated user's bookmarks. The Tweet must have been previously bookmarked by the user for the action to have an effect.

NameTypeRequiredDescription
idstringrequiredAuthenticated user's Twitter ID
tweet_idstringrequiredID of the bookmarked tweet to remove
twitteroauth_bookmarks_get#Retrieves Tweets bookmarked by the authenticated user. The provided User ID must match the authenticated user's ID.5 params

Retrieves Tweets bookmarked by the authenticated user. The provided User ID must match the authenticated user's ID.

NameTypeRequiredDescription
idstringrequiredAuthenticated user's Twitter ID
expansionsstringoptionalComma-separated expansions
max_resultsintegeroptionalMax results per page (1-100)
pagination_tokenstringoptionalPagination token for next page
tweet_fieldsstringoptionalComma-separated tweet fields
twitteroauth_community_get#Get details of an X Community by its ID: name, description, access type, join policy, and member count.2 params

Get details of an X Community by its ID: name, description, access type, join policy, and member count.

NameTypeRequiredDescription
idstringrequiredCommunity ID to look up
community_fieldsstringoptionalComma-separated Community fields to include, e.g. access,created_at,description,member_count,name
twitteroauth_dm_block#Blocks the specified user from sending Direct Messages to the authenticated user, without fully blocking the account.1 param

Blocks the specified user from sending Direct Messages to the authenticated user, without fully blocking the account.

NameTypeRequiredDescription
idstringrequiredUser ID whose Direct Messages should be blocked
twitteroauth_dm_conversation_events_get#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.6 params

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.

NameTypeRequiredDescription
participant_idstringrequiredUser ID of the DM conversation participant
dm_event_fieldsstringoptionalComma-separated DM event fields
event_typesstringoptionalFilter by event types
expansionsstringoptionalComma-separated expansions
max_resultsintegeroptionalMax results per page (1-100)
pagination_tokenstringoptionalPagination token for next page
twitteroauth_dm_conversation_retrieve#Retrieves Direct Message (DM) events for a specific conversation ID on Twitter. Useful for analyzing messages and participant activities.5 params

Retrieves Direct Message (DM) events for a specific conversation ID on Twitter. Useful for analyzing messages and participant activities.

NameTypeRequiredDescription
dm_conversation_idstringrequiredDM conversation ID
dm_event_fieldsstringoptionalComma-separated DM event fields
expansionsstringoptionalComma-separated expansions
max_resultsintegeroptionalMax results per page (1-100)
pagination_tokenstringoptionalPagination token for next page
twitteroauth_dm_conversation_send#Sends a message with optional text and/or media attachments (using pre-uploaded media_ids) to a specified Twitter Direct Message conversation.3 params

Sends a message with optional text and/or media attachments (using pre-uploaded media_ids) to a specified Twitter Direct Message conversation.

NameTypeRequiredDescription
dm_conversation_idstringrequiredDM conversation ID to send the message to
media_idstringoptionalPre-uploaded media ID to attach
textstringoptionalMessage text
twitteroauth_dm_delete#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.1 param

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.

NameTypeRequiredDescription
event_idstringrequiredID of the DM event to delete
twitteroauth_dm_event_get#Fetches a specific Direct Message (DM) event by its unique ID. Allows optional expansion of related data like users or tweets.3 params

Fetches a specific Direct Message (DM) event by its unique ID. Allows optional expansion of related data like users or tweets.

NameTypeRequiredDescription
event_idstringrequiredDM event ID
dm_event_fieldsstringoptionalComma-separated DM event fields
expansionsstringoptionalComma-separated expansions
twitteroauth_dm_events_get#Returns recent Direct Message events for the authenticated user, such as new messages or changes in conversation participants.5 params

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

NameTypeRequiredDescription
dm_event_fieldsstringoptionalComma-separated DM event fields
event_typesstringoptionalFilter by event types
expansionsstringoptionalComma-separated expansions
max_resultsintegeroptionalMax results per page (1-100)
pagination_tokenstringoptionalPagination token for next page
twitteroauth_dm_group_conversation_create#Creates a new group Direct Message (DM) conversation on Twitter. The conversation_type must be 'Group'. Include participant_ids and an initial message with text and optional media attachments using media_id (not media_url). Media must be uploaded first.3 params

Creates a new group Direct Message (DM) conversation on Twitter. The conversation_type must be 'Group'. Include participant_ids and an initial message with text and optional media attachments using media_id (not media_url). Media must be uploaded first.

NameTypeRequiredDescription
message_textstringrequiredInitial message text
participant_idsarrayrequiredList of Twitter user IDs to include
message_media_idsarrayoptionalMedia IDs to attach to initial message
twitteroauth_dm_send#Sends a new Direct Message with text and/or media (media_id for attachments must be pre-uploaded) to a specified Twitter user. Creates a new DM and does not modify existing messages.3 params

Sends a new Direct Message with text and/or media (media_id for attachments must be pre-uploaded) to a specified Twitter user. Creates a new DM and does not modify existing messages.

NameTypeRequiredDescription
participant_idstringrequiredTwitter user ID of the DM recipient
media_idstringoptionalPre-uploaded media ID to attach
textstringoptionalMessage text
twitteroauth_dm_unblock#Removes a Direct Message block on the specified user, allowing them to send Direct Messages to the authenticated user again.1 param

Removes a Direct Message block on the specified user, allowing them to send Direct Messages to the authenticated user again.

NameTypeRequiredDescription
idstringrequiredUser ID whose Direct Messages should be unblocked
twitteroauth_followers_get#Retrieves a list of users who follow a specified public Twitter user ID.5 params

Retrieves a list of users who follow a specified public Twitter user ID.

NameTypeRequiredDescription
idstringrequiredTwitter user ID to get followers for
expansionsstringoptionalComma-separated expansions
max_resultsintegeroptionalMax results per page (1-1000)
pagination_tokenstringoptionalPagination token for next page
user_fieldsstringoptionalComma-separated user fields
twitteroauth_following_get#Retrieves users followed by a specific Twitter user, allowing pagination and customization of returned user and tweet data fields via expansions.5 params

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

NameTypeRequiredDescription
idstringrequiredTwitter user ID
expansionsstringoptionalComma-separated expansions
max_resultsintegeroptionalMax results per page (1-1000)
pagination_tokenstringoptionalPagination token for next page
user_fieldsstringoptionalComma-separated user fields
twitteroauth_list_create#Creates a new, empty List on X (formerly Twitter). The provided name must be unique for the authenticated user. Accounts are added separately.3 params

Creates a new, empty List on X (formerly Twitter). The provided name must be unique for the authenticated user. Accounts are added separately.

NameTypeRequiredDescription
namestringrequiredUnique name for the new list
descriptionstringoptionalDescription of the list
privatebooleanoptionalWhether the list should be private
twitteroauth_list_delete#Permanently deletes a specified Twitter List using its ID. The list must be owned by the authenticated user. This action is irreversible.1 param

Permanently deletes a specified Twitter List using its ID. The list must be owned by the authenticated user. This action is irreversible.

NameTypeRequiredDescription
list_idstringrequiredID of the Twitter List to delete
twitteroauth_list_follow#Allows the authenticated user to follow a specific Twitter List they are permitted to access, subscribing them to the list's timeline. This does not automatically follow individual list members.2 params

Allows the authenticated user to follow a specific Twitter List they are permitted to access, subscribing them to the list's timeline. This does not automatically follow individual list members.

NameTypeRequiredDescription
idstringrequiredAuthenticated user's Twitter ID
list_idstringrequiredID of the list to follow
twitteroauth_list_followers_get#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.5 params

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.

NameTypeRequiredDescription
idstringrequiredTwitter List ID
expansionsstringoptionalComma-separated expansions
max_resultsintegeroptionalMax results per page (1-100)
pagination_tokenstringoptionalPagination token for next page
user_fieldsstringoptionalComma-separated user fields
twitteroauth_list_lookup#Returns metadata for a specific Twitter List, identified by its ID. Does not return list members. Can expand the owner's User object via the expansions parameter.4 params

Returns metadata for a specific Twitter List, identified by its ID. Does not return list members. Can expand the owner's User object via the expansions parameter.

NameTypeRequiredDescription
idstringrequiredTwitter List ID
expansionsstringoptionalComma-separated expansions
list_fieldsstringoptionalComma-separated list fields
user_fieldsstringoptionalComma-separated user fields
twitteroauth_list_member_add#Adds a user to a specified Twitter List. The list must be owned by the authenticated user.2 params

Adds a user to a specified Twitter List. The list must be owned by the authenticated user.

NameTypeRequiredDescription
list_idstringrequiredID of the Twitter List
user_idstringrequiredID of the user to add
twitteroauth_list_member_remove#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. The updated list of members is not returned.2 params

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. The updated list of members is not returned.

NameTypeRequiredDescription
idstringrequiredTwitter List ID
user_idstringrequiredID of the user to remove from the list
twitteroauth_list_members_get#Fetches members of a specific Twitter List, identified by its unique ID.5 params

Fetches members of a specific Twitter List, identified by its unique ID.

NameTypeRequiredDescription
idstringrequiredTwitter List ID
expansionsstringoptionalComma-separated expansions
max_resultsintegeroptionalMax results per page (1-100)
pagination_tokenstringoptionalPagination token for next page
user_fieldsstringoptionalComma-separated user fields
twitteroauth_list_pin#Pins a specified List to the authenticated user's profile. The List must exist, the user must have access rights, and the pin limit (typically 5 Lists) must not be exceeded.2 params

Pins a specified List to the authenticated user's profile. The List must exist, the user must have access rights, and the pin limit (typically 5 Lists) must not be exceeded.

NameTypeRequiredDescription
idstringrequiredAuthenticated user's Twitter ID
list_idstringrequiredID of the list to pin
twitteroauth_list_timeline_get#Fetches the most recent Tweets posted by members of a specified Twitter List.6 params

Fetches the most recent Tweets posted by members of a specified Twitter List.

NameTypeRequiredDescription
idstringrequiredTwitter List ID
expansionsstringoptionalComma-separated expansions
max_resultsintegeroptionalMax results per page (1-100)
pagination_tokenstringoptionalPagination token for next page
tweet_fieldsstringoptionalComma-separated tweet fields
user_fieldsstringoptionalComma-separated user fields
twitteroauth_list_unfollow#Enables a user to unfollow a specific Twitter List, which removes its tweets from their timeline and stops related notifications. Reports following: false on success, even if the user was not initially following the list.2 params

Enables a user to unfollow a specific Twitter List, which removes its tweets from their timeline and stops related notifications. Reports following: false on success, even if the user was not initially following the list.

NameTypeRequiredDescription
idstringrequiredAuthenticated user's Twitter ID
list_idstringrequiredID of the list to unfollow
twitteroauth_list_unpin#Unpins a List from the authenticated user's profile. The user ID is automatically retrieved if not provided.2 params

Unpins a List from the authenticated user's profile. The user ID is automatically retrieved if not provided.

NameTypeRequiredDescription
idstringrequiredAuthenticated user's Twitter ID
list_idstringrequiredID of the list to unpin
twitteroauth_list_update#Updates an existing Twitter List's name, description, or privacy status. Requires the List ID and at least one mutable property.4 params

Updates an existing Twitter List's name, description, or privacy status. Requires the List ID and at least one mutable property.

NameTypeRequiredDescription
idstringrequiredTwitter List ID to update
descriptionstringoptionalNew description
namestringoptionalNew name for the list
privatebooleanoptionalSet to true to make private, false for public
twitteroauth_media_analytics_get#Retrieves organic engagement analytics for one or more pieces of media owned by the authenticated user over a time window.5 params

Retrieves organic engagement analytics for one or more pieces of media owned by the authenticated user over a time window.

NameTypeRequiredDescription
end_timestringrequiredISO 8601 end time for the analytics window
media_keysstringrequiredComma-separated list of media keys (up to 100)
start_timestringrequiredISO 8601 start time for the analytics window
granularitystringoptionalAggregation granularity: hourly, daily, or total
media_analytics_fieldsstringoptionalComma-separated media analytics fields
twitteroauth_media_batch_lookup#Retrieves details for one or more pieces of media identified by their media keys.2 params

Retrieves details for one or more pieces of media identified by their media keys.

NameTypeRequiredDescription
media_keysstringrequiredComma-separated list of media keys (up to 100)
media_fieldsstringoptionalComma-separated media fields
twitteroauth_media_lookup#Retrieves details for a single piece of media by its media key.2 params

Retrieves details for a single piece of media by its media key.

NameTypeRequiredDescription
media_keystringrequiredMedia key to look up
media_fieldsstringoptionalComma-separated media fields
twitteroauth_media_metadata_create#Sets metadata, such as accessibility alt text, on a previously uploaded piece of media before it is attached to a Post.2 params

Sets metadata, such as accessibility alt text, on a previously uploaded piece of media before it is attached to a Post.

NameTypeRequiredDescription
alt_textstringrequiredAccessibility alt text describing the media (up to 1000 characters)
media_idstringrequiredThe media ID the metadata is attached to
twitteroauth_media_subtitles_create#Associates a subtitle (closed caption) track with a previously uploaded video.5 params

Associates a subtitle (closed caption) track with a previously uploaded video.

NameTypeRequiredDescription
language_codestringrequiredBCP47 language code of the subtitle track
media_categorystringrequiredMedia category of the target media: AmplifyVideo or TweetVideo
media_idstringrequiredThe media ID of the video the subtitles belong to
subtitle_media_idstringrequiredThe media ID of the previously uploaded subtitle (.srt/.vtt) file
display_namestringoptionalLanguage name of the subtitle track in a human readable form
twitteroauth_media_subtitles_delete#Removes a subtitle (closed caption) track of a specific language from a video.3 params

Removes a subtitle (closed caption) track of a specific language from a video.

NameTypeRequiredDescription
language_codestringrequiredThe language code of the subtitles to delete
media_categorystringrequiredMedia category of the target media: AmplifyVideo or TweetVideo
media_idstringrequiredThe media ID of the video the subtitles belong to
twitteroauth_media_upload#Uploads media (images only) to X/Twitter using the v2 API. Only supports images (tweet_image, dm_image) and subtitle files. For GIFs, videos, or any file larger than ~5 MB, use twitter_media_upload_large instead.3 params

Uploads media (images only) to X/Twitter using the v2 API. Only supports images (tweet_image, dm_image) and subtitle files. For GIFs, videos, or any file larger than ~5 MB, use twitter_media_upload_large instead.

NameTypeRequiredDescription
mediastringrequiredBase64-encoded image data
media_typestringrequiredMIME type, e.g. image/jpeg or image/png
media_categorystringoptionalMedia category for use context
twitteroauth_media_upload_append#Appends a data chunk to an ongoing media upload session on X/Twitter. Use during chunked media uploads to append each segment of media data in sequence.3 params

Appends a data chunk to an ongoing media upload session on X/Twitter. Use during chunked media uploads to append each segment of media data in sequence.

NameTypeRequiredDescription
media_datastringrequiredBase64-encoded chunk data
media_idstringrequiredMedia ID from the INIT step
segment_indexintegerrequiredZero-based index of the chunk segment
twitteroauth_media_upload_base64#Uploads media to X/Twitter using base64-encoded data. Use when you have media content as a base64 string. Only supports images and subtitle files. For videos or GIFs, use twitter_media_upload_large.3 params

Uploads media to X/Twitter using base64-encoded data. Use when you have media content as a base64 string. Only supports images and subtitle files. For videos or GIFs, use twitter_media_upload_large.

NameTypeRequiredDescription
media_datastringrequiredBase64-encoded media data
media_typestringrequiredMIME type, e.g. image/jpeg
media_categorystringoptionalMedia category for use context
twitteroauth_media_upload_init#Initializes a media upload session for X/Twitter. Returns a media_id for subsequent APPEND and FINALIZE commands. Required for uploading large files or when using the chunked upload workflow.4 params

Initializes a media upload session for X/Twitter. Returns a media_id for subsequent APPEND and FINALIZE commands. Required for uploading large files or when using the chunked upload workflow.

NameTypeRequiredDescription
media_typestringrequiredMIME type, e.g. video/mp4 or image/gif
total_bytesintegerrequiredTotal size of the media file in bytes
additional_ownersstringoptionalComma-separated user IDs to also own the media
media_categorystringoptionalMedia category for use context
twitteroauth_media_upload_large#Uploads media files to X/Twitter. Automatically uses chunked upload for GIFs, videos, and images larger than 5 MB. Use for videos, GIFs, or any file larger than 5 MB.5 params

Uploads media files to X/Twitter. Automatically uses chunked upload for GIFs, videos, and images larger than 5 MB. Use for videos, GIFs, or any file larger than 5 MB.

NameTypeRequiredDescription
media_datastringrequiredBase64-encoded media file data
media_typestringrequiredMIME type, e.g. video/mp4 or image/gif
total_bytesintegerrequiredTotal size of the file in bytes
additional_ownersstringoptionalComma-separated user IDs to also own the media
media_categorystringoptionalMedia category for use context
twitteroauth_media_upload_status_get#Gets the status of a media upload for X/Twitter. Use to check the processing status of uploaded media, especially for videos and GIFs. Only needed if the FINALIZE command returned processing_info.1 param

Gets the status of a media upload for X/Twitter. Use to check the processing status of uploaded media, especially for videos and GIFs. Only needed if the FINALIZE command returned processing_info.

NameTypeRequiredDescription
media_idstringrequiredMedia ID from the upload INIT step
twitteroauth_muted_users_get#Returns user objects muted by the X user identified by the id path parameter.5 params

Returns user objects muted by the X user identified by the id path parameter.

NameTypeRequiredDescription
idstringrequiredTwitter user ID
expansionsstringoptionalComma-separated expansions
max_resultsintegeroptionalMax results per page (1-1000)
pagination_tokenstringoptionalPagination token for next page
user_fieldsstringoptionalComma-separated user fields
twitteroauth_post_analytics_get#Retrieves analytics data for specified Posts within a defined time range. Returns engagement metrics, impressions, and other analytics. Requires OAuth 2.0 with tweet.read and users.read scopes.4 params

Retrieves analytics data for specified Posts within a defined time range. Returns engagement metrics, impressions, and other analytics. Requires OAuth 2.0 with tweet.read and users.read scopes.

NameTypeRequiredDescription
end_timestringrequiredISO 8601 end time
start_timestringrequiredISO 8601 start time
tweet_idsstringrequiredComma-separated list of Tweet IDs
granularitystringoptionalTime granularity of the returned analytics data
twitteroauth_post_create#Creates a Tweet on Twitter. The `text` field is required unless card_uri, media_media_ids, poll_options, or quote_tweet_id is provided. Supports media, polls, geo, and reply targeting.7 params

Creates a Tweet on Twitter. The `text` field is required unless card_uri, media_media_ids, poll_options, or quote_tweet_id is provided. Supports media, polls, geo, and reply targeting.

NameTypeRequiredDescription
geo_place_idstringoptionalPlace ID for geo tag
media_media_idsarrayoptionalMedia IDs to attach
poll_duration_minutesintegeroptionalDuration of poll in minutes
poll_optionsarrayoptionalUp to 4 poll options
quote_tweet_idstringoptionalID of the tweet to quote
reply_in_reply_to_tweet_idstringoptionalID of the tweet to reply to
textstringoptionalText content of the tweet
twitteroauth_post_delete#Irreversibly deletes a specific Tweet by its ID. The Tweet may persist in third-party caches after deletion.1 param

Irreversibly deletes a specific Tweet by its ID. The Tweet may persist in third-party caches after deletion.

NameTypeRequiredDescription
idstringrequiredID of the Tweet to delete
twitteroauth_post_like#Allows the authenticated user to like a specific, accessible Tweet. The authenticated user's ID is automatically determined from the OAuth token — you only need to provide the tweet_id.2 params

Allows the authenticated user to like a specific, accessible Tweet. The authenticated user's ID is automatically determined from the OAuth token — you only need to provide the tweet_id.

NameTypeRequiredDescription
idstringrequiredAuthenticated user's Twitter ID
tweet_idstringrequiredID of the Tweet to like
twitteroauth_post_likers_get#Retrieves users who have liked the Post (Tweet) identified by the provided ID.5 params

Retrieves users who have liked the Post (Tweet) identified by the provided ID.

NameTypeRequiredDescription
idstringrequiredTweet ID
expansionsstringoptionalComma-separated expansions
max_resultsintegeroptionalMax results per page (1-100)
pagination_tokenstringoptionalPagination token for next page
user_fieldsstringoptionalComma-separated user fields
twitteroauth_post_lookup#Fetches comprehensive details for a single Tweet by its unique ID, provided the Tweet exists and is accessible.5 params

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

NameTypeRequiredDescription
idstringrequiredTweet ID
expansionsstringoptionalComma-separated expansions
media_fieldsstringoptionalComma-separated media fields
tweet_fieldsstringoptionalComma-separated tweet fields
user_fieldsstringoptionalComma-separated user fields
twitteroauth_post_quotes_get#Retrieves Tweets that quote a specified Tweet. Requires a valid Tweet ID.5 params

Retrieves Tweets that quote a specified Tweet. Requires a valid Tweet ID.

NameTypeRequiredDescription
idstringrequiredTweet ID
expansionsstringoptionalComma-separated expansions
max_resultsintegeroptionalMax results per page (1-100)
pagination_tokenstringoptionalPagination token for next page
tweet_fieldsstringoptionalComma-separated tweet fields
twitteroauth_post_retweet#Retweets a Tweet for the authenticated user. The user ID is automatically fetched from the authenticated session — you only need to provide the tweet_id.2 params

Retweets a Tweet for the authenticated user. The user ID is automatically fetched from the authenticated session — you only need to provide the tweet_id.

NameTypeRequiredDescription
idstringrequiredAuthenticated user's Twitter ID
tweet_idstringrequiredID of the Tweet to retweet
twitteroauth_post_retweeters_get#Retrieves users who publicly retweeted a specified public Post ID, excluding Quote Tweets and retweets from private accounts.5 params

Retrieves users who publicly retweeted a specified public Post ID, excluding Quote Tweets and retweets from private accounts.

NameTypeRequiredDescription
idstringrequiredTweet ID
expansionsstringoptionalComma-separated expansions
max_resultsintegeroptionalMax results per page (1-100)
pagination_tokenstringoptionalPagination token for next page
user_fieldsstringoptionalComma-separated user fields
twitteroauth_post_retweets_get#Retrieves Tweets that Retweeted a specified public or authenticated-user-accessible Tweet ID. Optionally customize the response with fields and expansions.5 params

Retrieves Tweets that Retweeted a specified public or authenticated-user-accessible Tweet ID. Optionally customize the response with fields and expansions.

NameTypeRequiredDescription
idstringrequiredTweet ID
expansionsstringoptionalComma-separated expansions
max_resultsintegeroptionalMax results per page (1-100)
pagination_tokenstringoptionalPagination token for next page
tweet_fieldsstringoptionalComma-separated tweet fields
twitteroauth_post_unlike#Allows an authenticated user to remove their like from a specific post. The action is idempotent and completes successfully even if the post was not liked.2 params

Allows an authenticated user to remove their like from a specific post. The action is idempotent and completes successfully even if the post was not liked.

NameTypeRequiredDescription
idstringrequiredAuthenticated user's Twitter ID
tweet_idstringrequiredID of the Tweet to unlike
twitteroauth_post_unretweet#Removes a user's retweet of a specified Post, if the user had previously retweeted it.2 params

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

NameTypeRequiredDescription
idstringrequiredAuthenticated user's Twitter ID
source_tweet_idstringrequiredID of the Tweet to unretweet
twitteroauth_posts_lookup#Retrieves detailed information for one or more Posts (Tweets) identified by their unique IDs. Allows selection of specific fields and expansions.5 params

Retrieves detailed information for one or more Posts (Tweets) identified by their unique IDs. Allows selection of specific fields and expansions.

NameTypeRequiredDescription
idsstringrequiredComma-separated list of Tweet IDs (up to 100)
expansionsstringoptionalComma-separated expansions
media_fieldsstringoptionalComma-separated media fields
tweet_fieldsstringoptionalComma-separated tweet fields
user_fieldsstringoptionalComma-separated user fields
twitteroauth_recent_tweet_counts#Retrieves the count of Tweets matching a specified search query within the last 7 days, aggregated by 'minute', 'hour', or 'day'.6 params

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

NameTypeRequiredDescription
querystringrequiredSearch query
end_timestringoptionalISO 8601 end time
granularitystringoptionalAggregation granularity
since_idstringoptionalMinimum tweet ID
start_timestringoptionalISO 8601 start time
until_idstringoptionalMaximum tweet ID
twitteroauth_reply_visibility_set#Hides or unhides an existing reply Tweet. Allows the authenticated user to hide or unhide a reply to a conversation they own. You can only hide replies to posts you authored. Requires tweet.moderate.write OAuth scope.2 params

Hides or unhides an existing reply Tweet. Allows the authenticated user to hide or unhide a reply to a conversation they own. You can only hide replies to posts you authored. Requires tweet.moderate.write OAuth scope.

NameTypeRequiredDescription
hiddenbooleanrequiredtrue to hide, false to unhide
tweet_idstringrequiredID of the reply tweet to hide or unhide
twitteroauth_space_get#Retrieves details for a Twitter Space by its ID, allowing for customization and expansion of related data.4 params

Retrieves details for a Twitter Space by its ID, allowing for customization and expansion of related data.

NameTypeRequiredDescription
idstringrequiredTwitter Space ID
expansionsstringoptionalComma-separated expansions
space_fieldsstringoptionalComma-separated space fields
user_fieldsstringoptionalComma-separated user fields
twitteroauth_space_posts_get#Retrieves Tweets that were shared/posted during a Twitter Space broadcast. Returns Tweets that participants explicitly shared during the Space session, NOT audio transcripts. Most Spaces have zero associated Tweets — empty results are normal.4 params

Retrieves Tweets that were shared/posted during a Twitter Space broadcast. Returns Tweets that participants explicitly shared during the Space session, NOT audio transcripts. Most Spaces have zero associated Tweets — empty results are normal.

NameTypeRequiredDescription
idstringrequiredTwitter Space ID
expansionsstringoptionalComma-separated expansions
max_resultsintegeroptionalMax results per page (1-100)
tweet_fieldsstringoptionalComma-separated tweet fields
twitteroauth_space_ticket_buyers_get#Retrieves a list of users who purchased tickets for a specific, valid, and ticketed Twitter Space.3 params

Retrieves a list of users who purchased tickets for a specific, valid, and ticketed Twitter Space.

NameTypeRequiredDescription
idstringrequiredTwitter Space ID
expansionsstringoptionalComma-separated expansions
user_fieldsstringoptionalComma-separated user fields
twitteroauth_spaces_by_creator_get#Retrieves Twitter Spaces created by a list of specified User IDs, with options to customize returned data fields.4 params

Retrieves Twitter Spaces created by a list of specified User IDs, with options to customize returned data fields.

NameTypeRequiredDescription
user_idsstringrequiredComma-separated list of user IDs to get spaces for
expansionsstringoptionalComma-separated expansions
space_fieldsstringoptionalComma-separated space fields
user_fieldsstringoptionalComma-separated user fields
twitteroauth_spaces_get#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.4 params

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.

NameTypeRequiredDescription
idsstringrequiredComma-separated list of Space IDs
expansionsstringoptionalComma-separated expansions
space_fieldsstringoptionalComma-separated space fields
user_fieldsstringoptionalComma-separated user fields
twitteroauth_user_bookmark_folder_create#Creates a new Bookmark folder for the authenticated user. The provided User ID must match the authenticated user's ID.2 params

Creates a new Bookmark folder for the authenticated user. The provided User ID must match the authenticated user's ID.

NameTypeRequiredDescription
idstringrequiredAuthenticated user's Twitter ID
namestringrequiredName of the Bookmark folder (1-25 characters)
twitteroauth_user_bookmark_folders_get#Retrieves the authenticated user's Bookmark folders. The provided User ID must match the authenticated user's ID.3 params

Retrieves the authenticated user's Bookmark folders. The provided User ID must match the authenticated user's ID.

NameTypeRequiredDescription
idstringrequiredAuthenticated user's Twitter ID
max_resultsintegeroptionalMax results per page (1-100)
pagination_tokenstringoptionalPagination token for next page
twitteroauth_user_bookmarks_by_folder_get#Retrieves the Posts bookmarked by the authenticated user within a specific Bookmark folder. The provided User ID must match the authenticated user's ID.4 params

Retrieves the Posts bookmarked by the authenticated user within a specific Bookmark folder. The provided User ID must match the authenticated user's ID.

NameTypeRequiredDescription
folder_idstringrequiredBookmark folder ID
idstringrequiredAuthenticated user's Twitter ID
max_resultsintegeroptionalMax results per page (1-100)
pagination_tokenstringoptionalPagination token for next page
twitteroauth_user_follow#Allows an authenticated user to follow another user. Results in a pending request if the target user's tweets are protected.2 params

Allows an authenticated user to follow another user. Results in a pending request if the target user's tweets are protected.

NameTypeRequiredDescription
idstringrequiredAuthenticated user's Twitter ID
target_user_idstringrequiredID of the user to follow
twitteroauth_user_followed_lists_get#Returns metadata (not Tweets) for lists a specific Twitter user follows. Optionally includes expanded owner details.6 params

Returns metadata (not Tweets) for lists a specific Twitter user follows. Optionally includes expanded owner details.

NameTypeRequiredDescription
idstringrequiredTwitter user ID
expansionsstringoptionalComma-separated expansions
list_fieldsstringoptionalComma-separated list fields
max_resultsintegeroptionalMax results per page (1-100)
pagination_tokenstringoptionalPagination token for next page
user_fieldsstringoptionalComma-separated user fields
twitteroauth_user_liked_tweets_get#Retrieves Tweets liked by a specified Twitter user, provided their liked tweets are public or accessible.6 params

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

NameTypeRequiredDescription
idstringrequiredTwitter user ID
expansionsstringoptionalComma-separated expansions
max_resultsintegeroptionalMax results per page (5-100)
pagination_tokenstringoptionalPagination token for next page
tweet_fieldsstringoptionalComma-separated tweet fields
user_fieldsstringoptionalComma-separated user fields
twitteroauth_user_list_memberships_get#Retrieves all Twitter Lists a specified user is a member of, including public Lists and private Lists the authenticated user is authorized to view.6 params

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

NameTypeRequiredDescription
idstringrequiredTwitter user ID
expansionsstringoptionalComma-separated expansions
list_fieldsstringoptionalComma-separated list fields
max_resultsintegeroptionalMax results per page (1-100)
pagination_tokenstringoptionalPagination token for next page
user_fieldsstringoptionalComma-separated user fields
twitteroauth_user_lookup#Retrieves detailed public information for a Twitter user by their ID. Optionally expand related data (e.g., pinned tweets) and specify particular user or tweet fields to return.4 params

Retrieves detailed public information for a Twitter user by their ID. Optionally expand related data (e.g., pinned tweets) and specify particular user or tweet fields to return.

NameTypeRequiredDescription
idstringrequiredTwitter user ID
expansionsstringoptionalComma-separated expansions
tweet_fieldsstringoptionalComma-separated tweet fields
user_fieldsstringoptionalComma-separated user fields
twitteroauth_user_lookup_by_username#Fetches public profile information for a valid and existing Twitter user by their username. Optionally expands related data like pinned Tweets. Results may be limited for protected profiles not followed by the authenticated user.4 params

Fetches public profile information for a valid and existing Twitter user by their username. Optionally expands related data like pinned Tweets. Results may be limited for protected profiles not followed by the authenticated user.

NameTypeRequiredDescription
usernamestringrequiredTwitter username without the @ symbol, e.g. elonmusk
expansionsstringoptionalComma-separated expansions
tweet_fieldsstringoptionalComma-separated tweet fields
user_fieldsstringoptionalComma-separated user fields
twitteroauth_user_me#Returns profile information for the currently authenticated X user. Use this to get the authenticated user's ID before calling endpoints that require it.3 params

Returns profile information for the currently authenticated X user. Use this to get the authenticated user's ID before calling endpoints that require it.

NameTypeRequiredDescription
expansionsstringoptionalComma-separated expansions
tweet_fieldsstringoptionalComma-separated tweet fields
user_fieldsstringoptionalComma-separated user fields to return, e.g. created_at,description,public_metrics
twitteroauth_user_mentions_get#Retrieves Posts (Tweets) that mention the specified user, most recent first.10 params

Retrieves Posts (Tweets) that mention the specified user, most recent first.

NameTypeRequiredDescription
idstringrequiredUser ID whose mentions should be retrieved
end_timestringoptionalISO 8601 end time
expansionsstringoptionalComma-separated expansions
max_resultsintegeroptionalMax results per page (5-100)
pagination_tokenstringoptionalPagination token for next page
since_idstringoptionalMinimum tweet ID
start_timestringoptionalISO 8601 start time
tweet_fieldsstringoptionalComma-separated tweet fields
until_idstringoptionalMaximum tweet ID
user_fieldsstringoptionalComma-separated user fields
twitteroauth_user_mute#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.2 params

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.

NameTypeRequiredDescription
idstringrequiredAuthenticated user's Twitter ID
target_user_idstringrequiredID of the user to mute
twitteroauth_user_owned_lists_get#Retrieves Lists created (owned) by a specific Twitter user, not Lists they follow or are subscribed to.6 params

Retrieves Lists created (owned) by a specific Twitter user, not Lists they follow or are subscribed to.

NameTypeRequiredDescription
idstringrequiredTwitter user ID
expansionsstringoptionalComma-separated expansions
list_fieldsstringoptionalComma-separated list fields
max_resultsintegeroptionalMax results per page (1-100)
pagination_tokenstringoptionalPagination token for next page
user_fieldsstringoptionalComma-separated user fields
twitteroauth_user_pinned_lists_get#Retrieves the Lists a specific, existing Twitter user has pinned to their profile to highlight them.4 params

Retrieves the Lists a specific, existing Twitter user has pinned to their profile to highlight them.

NameTypeRequiredDescription
idstringrequiredTwitter user ID
expansionsstringoptionalComma-separated expansions
list_fieldsstringoptionalComma-separated list fields
user_fieldsstringoptionalComma-separated user fields
twitteroauth_user_posts_get#Retrieves a collection of Posts (Tweets) authored by the specified user, most recent first.11 params

Retrieves a collection of Posts (Tweets) authored by the specified user, most recent first.

NameTypeRequiredDescription
idstringrequiredUser ID whose Posts should be retrieved
end_timestringoptionalISO 8601 end time
excludestringoptionalComma-separated types to exclude: replies,retweets
expansionsstringoptionalComma-separated expansions
max_resultsintegeroptionalMax results per page (5-100)
pagination_tokenstringoptionalPagination token for next page
since_idstringoptionalMinimum tweet ID
start_timestringoptionalISO 8601 start time
tweet_fieldsstringoptionalComma-separated tweet fields
until_idstringoptionalMaximum tweet ID
user_fieldsstringoptionalComma-separated user fields
twitteroauth_user_reposts_of_me_get#Retrieves the most recent Posts that repost content from the authenticated user.5 params

Retrieves the most recent Posts that repost content from the authenticated user.

NameTypeRequiredDescription
expansionsstringoptionalComma-separated expansions
max_resultsintegeroptionalMax results per page (1-100, default 100)
pagination_tokenstringoptionalPagination token for next page
tweet_fieldsstringoptionalComma-separated tweet fields
user_fieldsstringoptionalComma-separated user fields
twitteroauth_user_timeline_get#Retrieves the home timeline (reverse chronological feed) for the authenticated Twitter user. Returns tweets from accounts the user follows and the user's own tweets. CRITICAL: The id parameter MUST be the authenticated user's own numeric Twitter user ID. Use twitter_user_me to get your ID first. Cannot fetch another user's home timeline.7 params

Retrieves the home timeline (reverse chronological feed) for the authenticated Twitter user. Returns tweets from accounts the user follows and the user's own tweets. CRITICAL: The id parameter MUST be the authenticated user's own numeric Twitter user ID. Use twitter_user_me to get your ID first. Cannot fetch another user's home timeline.

NameTypeRequiredDescription
idstringrequiredAuthenticated user's own numeric Twitter ID — must be your own ID
excludestringoptionalComma-separated types to exclude: retweets,replies
expansionsstringoptionalComma-separated expansions
max_resultsintegeroptionalMax results per page (1-100)
pagination_tokenstringoptionalPagination token for next page
tweet_fieldsstringoptionalComma-separated tweet fields
user_fieldsstringoptionalComma-separated user fields
twitteroauth_user_unfollow#Allows the authenticated user to unfollow an existing Twitter user, which removes the follow relationship. The source user ID is automatically determined from the authenticated session.2 params

Allows the authenticated user to unfollow an existing Twitter user, which removes the follow relationship. The source user ID is automatically determined from the authenticated session.

NameTypeRequiredDescription
idstringrequiredAuthenticated user's Twitter ID
target_user_idstringrequiredID of the user to unfollow
twitteroauth_user_unmute#Unmutes a target user for the authenticated user, allowing them to see Tweets and notifications from the target user again. The source_user_id is automatically populated from the authenticated user's credentials.2 params

Unmutes a target user for the authenticated user, allowing them to see Tweets and notifications from the target user again. The source_user_id is automatically populated from the authenticated user's credentials.

NameTypeRequiredDescription
idstringrequiredAuthenticated user's Twitter ID
target_user_idstringrequiredID of the user to unmute
twitteroauth_users_lookup#Retrieves detailed information for specified X (formerly Twitter) user IDs. Optionally customize returned fields and expand related entities like pinned tweets.4 params

Retrieves detailed information for specified X (formerly Twitter) user IDs. Optionally customize returned fields and expand related entities like pinned tweets.

NameTypeRequiredDescription
idsstringrequiredComma-separated list of Twitter user IDs (up to 100)
expansionsstringoptionalComma-separated expansions
tweet_fieldsstringoptionalComma-separated tweet fields
user_fieldsstringoptionalComma-separated user fields
twitteroauth_users_lookup_by_username#Retrieves detailed information for 1 to 100 Twitter users by their usernames (each 1-15 alphanumeric characters/underscores). Allows customizable user/tweet fields and expansion of related data like pinned tweets.4 params

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

NameTypeRequiredDescription
usernamesstringrequiredComma-separated list of Twitter usernames without @ symbols (up to 100)
expansionsstringoptionalComma-separated expansions
tweet_fieldsstringoptionalComma-separated tweet fields
user_fieldsstringoptionalComma-separated user fields