INTRODUCTION ============ This archive consists of machine-readable JSON files containing information associated with your account. We’ve included the information we believe is most relevant and useful to you, including your profile information, your Tweets, your DMs, your Moments, your media (images, videos and GIFs you’ve attached to Tweets, DMs, or Moments), a list of your followers, a list of accounts following you, your address book, Lists that you’ve created, are a member of, or are subscribed to, interest and demographic information that we have inferred about you, information about ads that you’ve seen or engaged with on Twitter, and more. The information contained in this archive reflects the state of the account at the time when the archive was created. In addition, if we do not have any data associated with your account for a particular category (e.g., if you have never created a List), then this archive will not include a file for that category. CONTENTS ======== This archive contains: /personalization.js: Contains information Twitter may have inferred about this account. /account-creation-ip.js: IP address used when the account was created. /periscope-expired-broadcasts.js: Live broadcasts on Twitter that have expired and cannot be encoded. /connected-application.js: List of applications authorized by user to connect to this account. /ad-mobile-conversions-attributed.js: Mobile application events associated with an account in the last 90 days which are attributable to a Promoted Tweet engagement on Twitter. /ad-online-conversions-attributed.js: All online (website) activities associated with an account in the last 90 days via advertiser website integrations which are attributable to a Promoted Tweet engagement on Twitter. /contact.js: Contacts imported into this account. /lists-created.js: Lists created by this account. /periscope-comments-made-by-user.js: Comments left by account holder on other users’ live broadcasts. /ad-online-conversions-unattributed.js: All online (website) activities associated with an account in the last 10 days via advertiser website integrations which may become attributable to a Promoted Tweet engagement on Twitter. /lists-subscribed.js: Lists subscribed to by this account. /direct-message-group-headers.js: Contains only metadata associated with GDMs. /direct_message_media: Folder of images, videos, and/or gifs included in the account’s DMs /direct-message-headers.js: Contains only metadata associated with DMs. /direct-message.js: Contains the text and associated metadata for Direct Messages (DMs) sent or received by the account. /direct_message_group_media: Folder of images, videos, and/or gifs included in the account’s GDMs /direct-message-group.js: Contains the text and associated metadata for Group Direct Messages (GDMs) sent or received by the account. /ni-devices.js: Mobile devices (e.g., mobile phone) associated with the account. /profile.js: Profile bio, location, and website associated with the account. /block.js: Other accounts blocked by this account. /phone_number.js: Phone number provided by the user and which is associated with the account. /follower.js: Other accounts that follow this account. /moment.js: Twitter Moments (a collection of Tweets that can be shared across the Twitter platform) created by the account. /verified.js: Account’s verification status. /screen-name-change.js: Records of changes to this account’s @username. /ip-audit.js: IP addresses per session (not per Tweet). /email-address-change.js: History of email addresses associated with the account. /saved-search.js: Searches saved by this account. /periscope-account-information.js: Basic information for the Periscope "shell account", which is automatically created when a user broadcasts live from Twitter. /account_timezone.js: Account timezone information. /profile_media: Folder containing profile avatar and header image, if provided. /periscope-profile-description.js: Periscope account description ported over from the Twitter account when the shell account was created. /tweet.js: Tweets posted to the account. /facebook-connection.js: Records of a Facebook account connected to this account. /periscope-broadcast-metadata.js: Metadata associated with the account’s live broadcasts. /ad-impressions.js: Promoted Tweets viewed by the account and associated metadata. /account.js: Basic account information. /ageinfo.js: Age provided by the user or inferred by Twitter. /like.js: Tweets marked as ‘Favorites’ or ‘Likes’ by this account. /lists-member.js: Public lists created by other accounts that include this account. /following.js: Other accounts followed by this account. /protected-history.js: History of a user protecting (that is, restricting only to their followers) and unprotecting their Tweets within the 6 months prior to the date this file was created. At the time of account creation, Tweets are unprotected by default. /periscope_broadcast_media: Encoded live broadcast video files created by this account. /ad-engagements.js: Promoted Tweets engaged with by the account and any associated metadata. /moments_media: Folder containing image or video included in the moment. /periscope-followers.js: Other accounts that follow this account. /moments_tweets_media: Folder containing images, videos, and/or gifs associated with the Tweets in the Moment. /tweet_media: Folder of images, videos, and/or gifs included in the account’s Tweets. /mute.js: Other accounts muted by this account. /ad-mobile-conversions-unattributed.js: Mobile application events associated with an account in the last 10 days which may become attributable to a Promoted Tweet engagement on Twitter. /account-suspension.js: Account’s suspension history. At the time of account creation, accounts are unsuspended by default. DETAILED DOCUMENTATION ====================== This section documents the data in each file in more detail. personalization.js ------------------ Contains information Twitter may have inferred about this account. * demographic: Inferred age, gender, and language. * interests: List of interests that Twitter or it’s partners have inferred about the account. * advertisers: List of Twitter advertisers who have included this account in their tailored audiences. * shows: List of movies and TV shows that Twitter has inferred the account may be interested in. account-creation-ip.js ---------------------- IP address used when the account was created. periscope-expired-broadcasts.js ------------------------------- Live broadcasts on Twitter that have expired and cannot be encoded. * broadcastIds: A list of the broadcast id’s that have expired. * reason: Explanation of why broadcast replay files are unavailable (hard-coded). connected-application.js ------------------------ List of applications authorized by user to connect to this account. * id: Unique identifier for the application. * name: Name of the application. * description: Brief description of the application. * organization: Name of the developer of the application. * permissions: List of permissions granted to the application by the user (e.g. read, write). * approved_at: Time when application was authorized by the user. ad-mobile-conversions-attributed.js ----------------------------------- Mobile application events associated with an account in the last 90 days which are attributable to a Promoted Tweet engagement on Twitter. * conversionTime: The UTC time of the event. * applicationName: The name of the application in which the activity occurred. * mobilePlatform: The mobile platform of the application (e.g, Android, iOS) * conversionEvent: The raw event type from the application (e.g., install, signup). * attributedConversionType: The type of activity specifically associated with the conversion. * conversionValue: The value of the conversion. * additionalParameters: Other optional parameters associated with the event. ad-online-conversions-attributed.js ----------------------------------- All online (website) activities associated with an account in the last 90 days via advertiser website integrations which are attributable to a Promoted Tweet engagement on Twitter. * conversionTime: The UTC time of the event. * advertiserInfo: The name and Twitter handle of the advertiser. * conversionPlatform: Mobile or Desktop. * conversionUrl: The URL of the website on which the event occurred. * eventType: The raw event type recorded from the website (e.g. pageview, signup). * attributedConversionType: The type of activity specifically associated with the conversion. * conversionValue: The value of the conversion. * additionalParameters: Other optional parameters associated with the event, such as content category, SKU, etc. contact.js ---------- Contacts imported into this account. * id: Unique identifiers for the contacts imported to the account. * emails: Emails of the contacts imported to the account. * phoneNumbers: Phone numbers of the contacts imported to the account. lists-created.js ---------------- Lists created by this account. periscope-comments-made-by-user.js ---------------------------------- Comments left by account holder on other users’ live broadcasts. * broadcastId: Unique id for the broadcast. * byAccountId: Account Id of the commenter. * createdAt: Time comment was made. * text: The comment text. ad-online-conversions-unattributed.js ------------------------------------- All online (website) activities associated with an account in the last 10 days via advertiser website integrations which may become attributable to a Promoted Tweet engagement on Twitter. * conversionTime: The UTC time of the event. * advertiserInfo: The name and Twitter handle of the advertiser. * conversionPlatform: Mobile or Desktop. * conversionUrl: The URL of the website on which the event occurred. * eventType: The raw event type recorded from the website (e.g. pageview, signup). * conversionValue: The value of the conversion. * additionalParameters: Other optional parameters associated with the event, such as content category, SKU, etc. lists-subscribed.js ------------------- Lists subscribed to by this account. direct-message-group-headers.js ------------------------------- Contains only metadata associated with Group Direct Messages (GDMs) sent or received by the account. direct_message_media -------------------- Folder of images, videos, and/or gifs included in the account’s DMs. NOTE: Does not contain content hosted on platforms other than Twitter (e.g. YouTube, Flickr) direct-message-headers.js ------------------------- Contains only metadata associated with Direct Messages (DMs) sent or received by the account. direct-message.js ----------------- Contains the text and associated metadata for Direct Messages (DMs) sent or received by the account. * conversationId: DMs are grouped by conversations. The conversation IDs are created by joining two user IDs of the two participants in the conversation. For example, if one participant’s user ID is 1234 and the other participant’s user ID is 7890, the conversation ID will be 1234-7890. The conversation IDs are ordered from the lowest to highest value of the first user ID. Within a conversation, the DMs are ordered in reverse chronological order, meaning that the latest DM will be at the top of the list. DMs contain information (e.g., user ID and text of message) for both the sender and receiver. * messages: List of each message sent or received by the account. Variables that may be included in any particular Direct Message are defined in our API documentation: https://developer.twitter.com/en/docs/direct-messages/sending-and-receiving/guides/message-create-object NOTE: This data may be split into multiple parts/files depending on the volume of messages. Due to user deletions, the file may not contain comprehensive logs of join events, participants lists, name change events, and message create events. direct_message_group_media -------------------------- Folder of images, videos, and/or gifs included in the account’s GDMs. NOTE: Does not contain content hosted on platforms other than Twitter (e.g. YouTube, Flickr) direct-message-group.js ----------------------- Contains the text and associated metadata for Group Direct Messages (GDMs) sent or received by the account. * conversationId: DMs are grouped by conversations. Each conversation has a unique randomly generated conversation ID. Within a conversation, the DMs are ordered in reverse chronological order, meaning that the latest DM will be at the top of the list. DMs contain information (e.g., user ID and text of message) for both the sender and receiver. * messages: List of each message sent or received by the account. Variables that may be included in any particular Direct Message are defined in our API documentation: https://developer.twitter.com/en/docs/direct-messages/sending-and-receiving/guides/message-create-object Group Direct Messages (GDMs) contain information (e.g., user ID and text of message) for both the sender and the other participants of the group. Group Direct Messages are grouped by conversations. The conversations will be ordered in chronological order, based on when the conversation was created. This means that the conversation that is created first is listed at the top of the file. Within a conversation, the logged events are ordered in reverse chronological order, meaning that the latest event will be at the top of the list. Additional logged events in the GDM file include: - Join Conversation event: occurs when a user adds other participants to the conversation. - Conversation name change events (change the name of the conversation). - Message create event: this is the actual DM and is shown when a DM message is created by a user. - Leave event: when a user leaves the group DM conversation. NOTE: This data may be split into multiple parts/files depending on the volume of messages. Due to user deletions, the file may not contain comprehensive logs of join events, participants lists, name change events, and message create events. ni-devices.js ------------- Mobile devices (e.g., mobile phone) associated with the account. * pushDevice: information about mobile devices that can receive a push notification from Twitter. * messagingDevice: information about phone numbers associated with the account. profile.js ---------- Profile bio, location, and website associated with the account. * bio: Account bio as displayed on account’s public profile. * website: Account website as displayed on account’s public profile. * location: Account location as displayed on account’s public profile. * avatarMediaUrl: Link to profile avatar image. * headerMediaUrl: Link to profile header image. block.js -------- Other accounts blocked by this account. phone_number.js --------------- Phone number provided by the user and which is associated with the account. follower.js ----------- Other accounts that follow this account. moment.js --------- Twitter Moments (a collection of Tweets that can be shared across the Twitter platform) created by the account. For more information, please refer to https://help.twitter.com/en/using-twitter/twitter-moments. * momentId: Unique identifier of the Moment. * createdAt: Date and time a Moment is created, in Coordinated Universal Time (UTC). * createdBy: User ID (unique identifier) of the account holder who generated the Moment. * title: Title attributed to the Moment by the account holder. * tweets: Tweets selected by the account holder to include in the Moment. Please note that these Tweets may or may not have been posted by the account holder who created the Moment. This record contains the API output of the Tweets added to the Moment and they are ordered according to how they appear in the Moment. Definitions for each of the variables that may be included in any particular Tweet are available in our API documentation: https://developer.twitter.com/en/docs/tweets/post-and-engage/api-reference/post-statuses-update. * description: Description text on the cover page of the Moment added by the account holder who generated the Moment. verified.js ----------- Account’s verification status. * accountId: Unique identifier for the account that performed the action. * verified: Verification status of the account. screen-name-change.js --------------------- Records of changes to this account’s @username. * accountId: Unique identifier for the account that performed the action. * changedAt: Date and time of action. * changedFrom: Previous screen name. * changedTo: New screen name. ip-audit.js ----------- IP addresses per session (not per Tweet). * accountId: Unique identifier for the account. * createdAt: Time of login. * loginIp: IP address used for login. email-address-change.js ----------------------- History of email addresses associated with the account. * accountId: Unique identifier for the account that performed the action. * changedAt: Date and time of action. * changedFrom: Previous email address. * changedTo: New email address. saved-search.js --------------- Searches saved by this account. * savedSearchId: Unique identifier for the search. * query: Actual search query. periscope-account-information.js -------------------------------- Information about the Periscope "shell account" automatically created for users who broadcast live on Twitter. * id: Unique id for the account. * displayName: Account’s name as displayed on its Twitter profile. * username: Current @username of the Twitter account. (NOTE: @username may change, but account_id remains the same). * isBanned: Indicates whether the account is suspended or not. * createdAt: Time account was created. * isTwitterUser: Flag to indicate if the account is also a Twitter user; should always be true. * twitterId: Unique id of the associated Twitter account. * twitterScreenName: Current @username of the associated Twitter account (NOTE: @username may change, but twitterId remains the same). * isTwitterVerified: (optional) Indicates if the associated Twitter account is a verified Twitter user account. account_timezone.js ------------------- Account timezone information. * accountId: Unique identifier for the account. * timeZone: Time zone specified by account holder, if provided. profile_media ------------- Folder containing profile image, header image, and background image, if provided. periscope-profile-description.js -------------------------------- Periscope account description ported over from the Twitter account when the shell account was created. tweet.js -------- Tweets posted to account. This record contains the API output of Tweets for this account. Definitions for each of the variables that may be included in any particular Tweet are available in our API documentation: https://developer.twitter.com/en/docs/tweets/post-and-engage/api-reference/post-statuses-update. facebook-connection.js ---------------------- Records of a Facebook account connected to this account. periscope-broadcast-metadata.js ------------------------------- Metadata associated with the account’s live broadcasts. * id: Unique id for the broadcast. * hasLocation: Flag to indicate if the broadcast has associated location. * latitude: Specific latitude for the broadcast’s location. * longitude: Specific longitude for the broadcast’s location. * city: (optional) City where the broadcast took place. * country: (optional) Country where the broadcast took place. * createdAt: Time broadcast was created. * updatedAt: Time broadcast was updated or modified. ad-impressions.js ----------------- Promoted Tweets viewed by the account and associated metadata. * impressionTime: Time when ad was viewed. * deviceInfo: Device where ad was viewed (e.g. Desktop, Mobile). * displayLocation: Location on Twitter where the ad was viewed (e.g. Timeline). * advertiserInfo: Information about the advertiser. * promotedTweet: Unique identifier of the Promoted Tweet used in the ad. Matching & targeting criteria used to deliver the ad to this account. account.js ---------- Basic account information. * accountId: Unique identifier for the account. * createdAt: Date and time of account creation. * createdVia: Client application used to create account. * username: Account’s current @username (NOTE: @username may change, but account_id remains the same). * accountDisplayName: Account’s name as displayed on its profile. ageinfo.js ---------- User’s age provided by the user or inferred by Twitter. * birthDate: date of birth provided by the user. * age: age range inferred by Twitter. like.js ------- Tweets marked as ‘Favorites’ or ‘Likes’ by this account. * tweetId: Unique identifiers for the Tweets liked. * expandedUrl: Tweets URL. * fullText: (optional) Tweets full text. lists-member.js --------------- Public lists created by other accounts that include this account. following.js ------------ Other accounts followed by this account. protected-history.js -------------------- History of a user protecting (that is, restricting only to their followers) and unprotecting their Tweets within the 6 months prior to the date this file was created. At the time of account creation, Tweets are unprotected by default. periscope_broadcast_media ------------------------- Folder containing the encoded live broadcast video files created by this account. ad-engagements.js ----------------- Promoted Tweets engaged with by the account and any associated metadata. * impressionData: Data on which ads were viewed by the account; includes the same data as noted in impressions.js. * engagementTime: Time when account engaged with the ad. * engagementType: Type of engagement (e.g., Chargeable impression, Video playback) moments_media ------------- Folder containing images, videos, and/or gifs uploaded through Twitter’s photo hosting service (if any) for Tweets that have been included in this Moment, including the Moment cover media. This file does not contain images hosted by third parties (e.g., FlickR, TwitPic, etc.). Please also note that these images may or may not have been posted by the account holder who created the Moment. periscope-followers.js ---------------------- Other accounts that follow this shell account. moments_tweets_media -------------------- Folder containing images, videos, and/or gifs uploaded through Twitter’s photo hosting service (if any) for Tweets that have been included in this Moment, including the Moment cover media. This file does not contain images hosted on platforms other than Twitter (e.g., Flickr). Please also note that these images may or may not have been posted by the account holder who created the Moment. tweet_media ----------- Folder of images, videos, and/or gifs included in the account’s Tweets. NOTE: Does not contain content hosted on platforms other than Twitter (e.g. YouTube, Flickr) mute.js ------- Other accounts muted by this account. ad-mobile-conversions-unattributed.js ------------------------------------- Mobile application events associated with an account in the last 10 days which may become attributable to a Promoted Tweet engagement on Twitter. * conversionTime: The UTC time of the event. * applicationName: The name of the application in which the activity occurred. * mobilePlatform: The mobile platform of the application (e.g., Android, iOS) * conversionEvent: The raw event type from the application (e.g., install, signup). * conversionValue: The value of the conversion. * additionalParameters: Other optional parameters associated with the event. account-suspension.js --------------------- Account’s suspension history. At the time of account creation, accounts are unsuspended by default.