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_keys Metric
A list of unique identifiers for media objects attached to the Tweet.
attachments.poll_ids Dimension
A list of unique identifiers for polls attached to a Tweet. Requires the 'attachments.poll_ids' expansion to return poll object metadata.
author_id Dimension
The unique identifier of the user who authored the Tweet.
author_name Dimension
The display name of the user who authored the Tweet.
author_username Dimension
The username of the user who authored the Tweet.
context_annotations.domain.description Dimension
This field provides a textual explanation of the high-level category or topic a Tweet falls under, derived from context annotations.
context_annotations.domain.id Dimension
The unique identifier for the high-level category or topic associated with a Tweet.
context_annotations.domain.name Dimension
The name of the high-level category or topic associated with a Tweet.
context_annotations.entity.description Dimension
This field provides a textual explanation of the specific person, place, or organization recognized within the Tweet text.
context_annotations.entity.id Dimension
The unique identifier for the specific person, place, or organization recognized within the Tweet text.
context_annotations.entity.name Dimension
The name of the specific person, place, or organization recognized within the Tweet text.
conversation_id Dimension
The unique identifier for the conversation thread to which a Tweet belongs. This ID corresponds to the Tweet ID of the original Tweet in the conversation.
created_at Dimension
The timestamp indicating when the Tweet or user account was created.
description Dimension
The user-provided profile description.
edit_history_tweet_ids Dimension
A list of Tweet IDs representing the edit history of the current Tweet.
entities.annotations.end Metric
The ending index of the annotation entity within the Tweet text. This helps identify the exact text segment that was annotated.
entities.annotations.normalized_text Dimension
The normalized text of the annotation, providing a standardized representation of the annotated entity.
entities.annotations.probability Metric
The confidence score or probability associated with the identified annotation, indicating the likelihood of its correctness.
entities.annotations.start Metric
The starting index of the annotation entity within the Tweet text. This helps identify the exact text segment that was annotated.
entities.annotations.type Dimension
The type or category of the annotation, such as a person, place, or organization.
entities.hashtags Dimension
A list of hashtags mentioned in the Tweet, including their text and character indices within the Tweet.
entities.mentions.end Metric
The integer index marking the end position (exclusive) of the mentioned user's username in the Tweet text.
entities.mentions.id Metric
The unique identifier of the mentioned user.
entities.mentions.start Metric
The integer index marking the start position (inclusive) of the mentioned user's username in the Tweet text.
entities.mentions.username Dimension
The username of the mentioned user.
entities.urls.description Dimension
A description of the content at the URL included in the Tweet.
entities.urls.display_url Dimension
The URL as it would be displayed to a user, often shortened or cleaned for readability.
entities.urls.end Metric
The ending index of the URL within the Tweet text.
entities.urls.expanded_url Dimension
The full, unshortened URL to which a shortened URL or T.co link resolves.
entities.urls.images Dimension
A list of image objects associated with the URL, including their URL and dimensions, if available.
entities.urls.media_key Metric
The unique identifier for any media object associated with the URL. Requires the 'attachments.media_keys' expansion to return media object metadata.
entities.urls.start Metric
The starting index of the URL within the Tweet text.
entities.urls.status Metric
The HTTP status code returned when the URL was unwound or fetched, indicating its availability.
entities.urls.title Dimension
The title of the webpage or content referenced by the URL included in the Tweet.
entities.urls.unwound_url Dimension
The final URL after all redirects have been followed, providing the canonical link.
entities.urls.url Dimension
The primary URL as it appears in the Tweet text or expanded from a T.co link.
id Dimension
The unique identifier for the Tweet, user, or other object.
in_reply_to_user_id Dimension
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_key Metric
The unique identifier for a media object associated with the Tweet.
media_preview_image_url Dimension
A URL to a preview image for video or GIF media attachments.
media_public_metrics Metric
Public engagement metrics for the media attached to the Tweet, such as view counts.
media_type Dimension
The type of media attached to the Tweet (e.g., 'photo', 'video', 'gif').
media_url Dimension
The URL to the media file associated with the Tweet.
name Dimension
The display name of the user.
organic_metrics.impression_count Metric
The total number of times a Tweet was viewed or displayed on users' timelines from an organic (non-promoted) context.
organic_metrics.like_count Metric
The total number of times a Tweet has been liked from an organic (non-promoted) context.
organic_metrics.reply_count Metric
The total number of replies to a Tweet from an organic (non-promoted) context.
organic_metrics.retweet_count Metric
The total number of times a Tweet was retweeted from an organic (non-promoted) context.
organic_metrics.user_profile_clicks Metric
The total number of times users clicked on the author's profile from an organic (non-promoted) Tweet.
pinned_tweet_attachments Dimension
A list of attachments (e.g., media keys, poll IDs) associated with the pinned Tweet.
pinned_tweet_author_id Dimension
The unique identifier of the user who authored the pinned Tweet on a user's profile.
pinned_tweet_created_at Dimension
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_ids Dimension
A list of Tweet IDs representing the edit history of the pinned Tweet.
pinned_tweet_entities Dimension
Contains parsed entities (hashtags, mentions, URLs) present in the text of the pinned Tweet.
pinned_tweet_in_reply_to_user_id Dimension
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_metrics Metric
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_tweets Dimension
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_text Dimension
The full text content of the pinned Tweet.
public_metrics.bookmark_count Metric
The total count of times a Tweet has been bookmarked.
public_metrics.followers_count Metric
The total number of followers a user has.
public_metrics.following_count Metric
The total number of accounts a user is following.
public_metrics.impression_count Metric
The total number of times a Tweet has been viewed or seen by users.
public_metrics.like_count Metric
The total number of times a Tweet has been liked.
public_metrics.listed_count Metric
The total number of public lists a user is a member of.
public_metrics.media_count Metric
The total number of media attachments (images, videos, GIFs) uploaded by a user.
public_metrics.quote_count Metric
The total number of times a Tweet has been quoted by other Tweets.
public_metrics.reply_count Metric
The total number of replies to a Tweet.
public_metrics.retweet_count Metric
The total number of times a Tweet has been retweeted.
public_metrics.tweet_count Metric
The total number of Tweets posted by a user.
referenced_tweets.id Metric
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.type Dimension
The type of relationship to the referenced Tweet, such as 'retweeted', 'replied_to', or 'quoted'.
report_date Dimension
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.
text Dimension
The full text content of the Tweet.
url Dimension
The URL provided in the user's profile, if available. For media, it's the URL of the media itself.
username Dimension
The unique username of the user.