X Public Basic (Twitter): Most-used fields
The table below gives information about most-used fields that you can import from X Public Basic (Twitter). Other fields might also be available in Adverity.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.
attachments.media_keysMetric
A list of unique identifiers for media objects attached to the Tweet.
attachments.poll_idsDimension
A list of unique identifiers for polls attached to a Tweet. Requires the 'attachments.poll_ids' expansion to return poll object metadata.
author_idDimension
The unique identifier of the user who authored the Tweet.
author_nameDimension
The display name of the user who authored the Tweet.
author_usernameDimension
The username of the user who authored the Tweet.
created_atDimension
The timestamp indicating when the Tweet or user account was created.
descriptionDimension
The user-provided profile description.
edit_history_tweet_idsDimension
A list of Tweet IDs representing the edit history of the current Tweet.
entities.annotations.endMetric
The ending index of the annotation entity within the Tweet text. This helps identify the exact text segment that was annotated.
entities.annotations.normalized_textDimension
The normalized text of the annotation, providing a standardized representation of the annotated entity.
entities.annotations.probabilityMetric
The confidence score or probability associated with the identified annotation, indicating the likelihood of its correctness.
entities.annotations.startMetric
The starting index of the annotation entity within the Tweet text. This helps identify the exact text segment that was annotated.
entities.annotations.typeDimension
The type or category of the annotation, such as a person, place, or organization.
entities.hashtagsDimension
A list of hashtags mentioned in the Tweet, including their text and character indices within the Tweet.
entities.mentions.endMetric
The integer index marking the end position (exclusive) of the mentioned user's username in the Tweet text.
entities.mentions.idMetric
The unique identifier of the mentioned user.
entities.mentions.startMetric
The integer index marking the start position (inclusive) of the mentioned user's username in the Tweet text.
entities.mentions.usernameDimension
The username of the mentioned user.
entities.urls.descriptionDimension
A description of the content at the URL included in the Tweet.
entities.urls.display_urlDimension
The URL as it would be displayed to a user, often shortened or cleaned for readability.
entities.urls.endMetric
The ending index of the URL within the Tweet text.
entities.urls.expanded_urlDimension
The full, unshortened URL to which a shortened URL or T.co link resolves.
entities.urls.imagesDimension
A list of image objects associated with the URL, including their URL and dimensions, if available.
entities.urls.media_keyMetric
The unique identifier for any media object associated with the URL. Requires the 'attachments.media_keys' expansion to return media object metadata.
entities.urls.startMetric
The starting index of the URL within the Tweet text.
entities.urls.statusMetric
The HTTP status code returned when the URL was unwound or fetched, indicating its availability.
entities.urls.titleDimension
The title of the webpage or content referenced by the URL included in the Tweet.
entities.urls.unwound_urlDimension
The final URL after all redirects have been followed, providing the canonical link.
entities.urls.urlDimension
The primary URL as it appears in the Tweet text or expanded from a T.co link.
idDimension
The unique identifier for the Tweet, user, or other object.
in_reply_to_user_idDimension
The unique identifier of the user who the Tweet is replying to. Requires the 'in_reply_to_user_id' expansion to return the full user object.
media_media_keyMetric
The unique identifier for a media object associated with the Tweet.
media_preview_image_urlDimension
A URL to a preview image for video or GIF media attachments.
media_public_metricsMetric
Public engagement metrics for the media attached to the Tweet, such as view counts.
media_typeDimension
The type of media attached to the Tweet (e.g., 'photo', 'video', 'gif').
media_urlDimension
The URL to the media file associated with the Tweet.
nameDimension
The display name of the user.
pinned_tweet_attachmentsDimension
A list of attachments (e.g., media keys, poll IDs) associated with the pinned Tweet.
pinned_tweet_author_idDimension
The unique identifier of the user who authored the pinned Tweet on a user's profile.
pinned_tweet_created_atDimension
The creation timestamp of the Tweet that is pinned to the user's profile. This field is available when requesting 'user.fields' with 'pinned_tweet_id' and 'tweet.fields' with 'created_at'.
pinned_tweet_edit_history_tweet_idsDimension
A list of Tweet IDs representing the edit history of the pinned Tweet.
pinned_tweet_entitiesDimension
Contains parsed entities (hashtags, mentions, URLs) present in the text of the pinned Tweet.
pinned_tweet_in_reply_to_user_idDimension
The unique identifier of the user who the pinned Tweet is replying to, if applicable. This field is available when requesting 'user.fields' with 'pinned_tweet_id' and 'tweet.fields' with 'in_reply_to_user_id'.
pinned_tweet_public_metricsMetric
Public engagement metrics for the Tweet pinned to the user's profile, such as like, retweet, and reply counts. This field is available when requesting 'user.fields' with 'pinned_tweet_id' and 'tweet.fields' with 'public_metrics'.
pinned_tweet_referenced_tweetsDimension
A list of Tweets referenced by the Tweet pinned to the user's profile, indicating if it's a reply, retweet, or quote. This field is available when requesting 'user.fields' with 'pinned_tweet_id' and 'tweet.fields' with 'referenced_tweets'.
pinned_tweet_textDimension
The full text content of the pinned Tweet.
public_metrics.bookmark_countMetric
The total count of times a Tweet has been bookmarked.
public_metrics.followers_countMetric
The total number of followers a user has.
public_metrics.following_countMetric
The total number of accounts a user is following.
public_metrics.impression_countMetric
The total number of times a Tweet has been viewed or seen by users.
public_metrics.like_countMetric
The total number of times a Tweet has been liked.
public_metrics.listed_countMetric
The total number of public lists a user is a member of.
public_metrics.media_countMetric
The total number of media attachments (images, videos, GIFs) uploaded by a user.
public_metrics.quote_countMetric
The total number of times a Tweet has been quoted by other Tweets.
public_metrics.reply_countMetric
The total number of replies to a Tweet.
public_metrics.retweet_countMetric
The total number of times a Tweet has been retweeted.
public_metrics.tweet_countMetric
The total number of Tweets posted by a user.
referenced_tweets.idMetric
The unique identifier of a Tweet that the current Tweet is referencing (e.g., a retweet, reply, or quoted tweet). Requires the 'referenced_tweets.id' expansion to return the full referenced Tweet object.
referenced_tweets.typeDimension
The type of relationship to the referenced Tweet, such as 'retweeted', 'replied_to', or 'quoted'.
report_dateDimension
The date when the data was collected or reported. This field aligns with the time-based filters (e.g., start_time, end_time) used in data retrieval from the Twitter API v2.
textDimension
The full text content of the Tweet.
urlDimension
The URL provided in the user's profile, if available. For media, it's the URL of the media itself.
usernameDimension
The unique username of the user.