category: Data Enrichment & Threat Intelligence provider: X Corp commonfields: id: Twitter v2 version: -1 configuration: - defaultvalue: https://api.twitter.com display: Server URL name: url required: true type: 0 - displaypassword: Bearer Token additionalinfo: The Bearer Token to use for connection name: credentials required: true hiddenusername: true type: 9 - display: Trust any certificate (not secure) name: insecure type: 8 required: false - display: Use system proxy settings name: proxy type: 8 required: false description: Twitter integration provides access to searching recent Tweets (in last 7 days) and user information using the Twitter v2 API. display: 'Twitter v2' name: Twitter v2 script: commands: - arguments: - description: A comma-seperated list of keywords to submit to the recent search endpoint. isArray: true name: query required: true - description: 'The oldest UTC timestamp (from most recent seven days) from which the Tweets will be provided. Date format will be in ISO 8601 format (YYYY-MM-DDTHH:mm:ssZ) or relational expressions like “7 days ago”.' name: start_time - description: The most recent UTC timestamp to which the Tweets will be provided. Date format will be in ISO 8601 format (YYYY-MM-DDTHH:mm:ssZ) or relational expressions like “7 days ago”. name: end_time - defaultValue: '50' description: Maximum number of results to return. Value can be between 10 and 100. name: limit - description: When you request a list of objects with a MaxResults setting, if the number of objects that are still available for retrieval exceeds the maximum you requested, Twitter returns a NextToken value in the response. To retrieve the next batch of objects, use the token returned from the prior request in your next request. name: next_token description: This command will search for Tweets from the last 7 days and return all information available. name: twitter-tweet-search outputs: - contextPath: Twitter.Tweet.conversation_id description: The Tweet ID of the original Tweet of the conversation (which includes direct replies, replies of replies). type: String - contextPath: Twitter.Tweet.id description: Unique identifier of this Tweet. type: String - contextPath: Twitter.Tweet.created_at description: Creation time of the Tweet. type: Date - contextPath: Twitter.Tweet.text description: The content of the Tweet. type: String - contextPath: Twitter.Tweet.edit_history_tweet_ids description: Unique identifiers indicating all versions of an edited Tweet. type: String - contextPath: Twitter.Tweet.public_metrics.impression_count description: Number of times the Tweet has been seen. type: Number - contextPath: Twitter.Tweet.public_metrics.retweet_count description: Number of times this Tweet has been Retweeted. type: Number - contextPath: Twitter.Tweet.public_metrics.reply_count description: Number of replies to this Tweet. type: Number - contextPath: Twitter.Tweet.public_metrics.like_count description: Number of Likes to this Tweet. type: Number - contextPath: Twitter.Tweet.public_metrics.quote_count description: Number of times this Tweet has been Retweeted with a comment. type: Number - contextPath: Twitter.Tweet.author.name description: The unique identifier of this user. type: String - contextPath: Twitter.Tweet.author.verified description: Indicates if this user is a verified Twitter user. type: Boolean - contextPath: Twitter.Tweet.author.description description: The text of this user's profile description (also known as bio), if the user provided one. type: String - contextPath: Twitter.Tweet.author.id description: The unique identifier of this user. type: String - contextPath: Twitter.Tweet.author.created_at description: The UTC datetime when the user account was created on Twitter. type: Date - contextPath: Twitter.Tweet.author.username description: The Twitter screen name, handle, or alias that this user identifies themselves with. type: String - contextPath: Twitter.Tweet.media.type description: Type of content (animated_gif, photo, video). type: String - contextPath: Twitter.Tweet.media.url description: A direct URL to the media file on Twitter. type: String - contextPath: Twitter.Tweet.media.media_key description: Unique identifier of the expanded media content. type: String - contextPath: Twitter.Tweet.media.alt_text description: A description of an image to enable and support accessibility. Can be up to 1000 characters long. type: String - contextPath: Twitter.TweetNextToken description: A value that encodes the next 'page' of results that can be requested, via the next_token request parameter. type: String - arguments: - description: A comma-separated list of Twitter usernames (handles). Up to 100 are allowed in a single request. isArray: true name: user_name required: true - defaultValue: 'false' auto: PREDEFINED description: Indicates whether to return a user's pinned Tweets. name: return_pinned_tweets predefined: - 'true' - 'false' description: "Lookup users by name to display information about them. Search multiple users simultaneously by separating them by commas. Ex: 'name='user1,user2,user3'." name: twitter-user-get outputs: - contextPath: Twitter.User.name description: The friendly name of this user, as shown on their profile. type: String - contextPath: Twitter.User.username description: The Twitter handle (screen name) of this user. type: String - contextPath: Twitter.User.created_at description: Creation time of this account. type: Date - contextPath: Twitter.User.description description: The text of this user's profile description (also known as bio), if the user provided one. type: String - contextPath: Twitter.User.id description: Unique identifier of this user. type: String - contextPath: Twitter.User.location description: The location specified in the user's profile. type: String - contextPath: Twitter.User.pinned_tweet_id description: Unique identifier of this user's pinned Tweet. type: String - contextPath: Twitter.User.profile_image_url description: The URL to the profile image for this user, as shown on the user's profile. type: String - contextPath: Twitter.User.protected description: Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private). type: Boolean - contextPath: Twitter.User.public_metrics.followers_count description: Number of users who follow this user. type: Number - contextPath: Twitter.User.public_metrics.following_count description: Number of users this user is following. type: Number - contextPath: Twitter.User.public_metrics.tweet_count description: Number of Tweets (including Retweets) posted by this user. type: Number - contextPath: Twitter.User.public_metrics.listed_count description: Number of lists that include this user. type: Number - contextPath: Twitter.User.url description: The URL specified in the user's profile, if present. type: String - contextPath: Twitter.User.verified description: Indicates if this user is a verified Twitter user. type: Boolean - contextPath: Twitter.User.withheld description: Contains withholding details for withheld content. type: String - contextPath: Twitter.User.entities.url description: Contains details about the user's profile website. type: String - contextPath: Twitter.User.entities.expanded_url description: The fully resolved URL. type: String - contextPath: Twitter.User.entities.display_url description: The URL as displayed in the user's profile. type: String - contextPath: Twitter.User.pinned_tweets.id description: Unique identifier of this user's pinned Tweet. type: String - contextPath: Twitter.User.pinned_tweets.text description: The content of the Tweet. type: String - contextPath: Twitter.User.pinned_tweets.conversation_id description: The Tweet ID of the original Tweet of the conversation (which includes direct replies, replies of replies). type: String - contextPath: Twitter.User.pinned_tweets.created_at description: Creation time of the Tweet. type: Date - contextPath: Twitter.User.pinned_tweets.edit_history_tweet_ids description: Unique identifiers indicating all versions of an edited Tweet. type: String - contextPath: Twitter.User.pinned_tweets.retweet_count description: Number of times this Tweet has been Retweeted. type: Number - contextPath: Twitter.User.pinned_tweets.reply_count description: Number of Replies to this Tweet. type: Number - contextPath: Twitter.User.Pinned_tweets.like_count description: Number of Likes to this Tweet. type: Number - contextPath: Twitter.User.pinned_tweets.quote_count description: Number of times this Tweet has been Retweeted with a comment. type: Number runonce: false script: '-' type: python subtype: python3 dockerimage: demisto/python3:3.12.13.10116658 fromversion: 6.5.0 tests: - playbook-Test_Twitter_v2