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.

API name	Adverity UI name	Description	Use in Adverity
attachments.media_keys	attachments.media_keys	A list of unique identifiers for media objects attached to the Tweet.	metric
attachments.poll_ids	attachments.poll_ids	A list of unique identifiers for polls attached to a Tweet. Requires the ‘attachments.poll_ids’ expansion to return poll object metadata.	dimension
author_id	author_id	The unique identifier of the user who authored the Tweet.	dimension
author_name	author_name	The display name of the user who authored the Tweet.	dimension
author_username	author_username	The username of the user who authored the Tweet.	dimension
context_annotations.domain.description	context_annotations.domain.description	A description of the high-level category or topic associated with the Tweet’s context.	dimension
context_annotations.domain.id	context_annotations.domain.id	The unique identifier for the high-level category or topic associated with the Tweet’s context.	dimension
context_annotations.domain.name	context_annotations.domain.name	The name of the high-level category or topic associated with the Tweet’s context.	dimension
context_annotations.entity.description	context_annotations.entity.description	A description of the specific entity (person, place, or organization) recognized within the Tweet’s context.	dimension
context_annotations.entity.id	context_annotations.entity.id	The unique identifier for the specific entity (person, place, or organization) recognized within the Tweet’s context.	dimension
context_annotations.entity.name	context_annotations.entity.name	The name of the specific entity (person, place, or organization) recognized within the Tweet’s context.	dimension
created_at	created_at	The timestamp indicating when the Tweet or user account was created.	dimension
description	description	The user-provided profile description.	dimension
edit_history_tweet_ids	edit_history_tweet_ids	A list of Tweet IDs representing the edit history of the current Tweet.	dimension
entities.annotations.end	entities.annotations.end	The ending index of the annotation entity within the Tweet text. This helps identify the exact text segment that was annotated.	metric
entities.annotations.normalized_text	entities.annotations.normalized_text	The normalized text of the annotation, providing a standardized representation of the annotated entity.	dimension
entities.annotations.probability	entities.annotations.probability	The confidence score or probability associated with the identified annotation, indicating the likelihood of its correctness.	metric
entities.annotations.start	entities.annotations.start	The starting index of the annotation entity within the Tweet text. This helps identify the exact text segment that was annotated.	metric
entities.annotations.type	entities.annotations.type	The type or category of the annotation, such as a person, place, or organization.	dimension
entities.hashtags	entities.hashtags	A list of hashtags mentioned in the Tweet, including their text and character indices within the Tweet.	dimension
entities.mentions.end	entities.mentions.end	The integer index marking the end position (exclusive) of the mentioned user’s username in the Tweet text.	metric
entities.mentions.id	entities.mentions.id	The unique identifier of the mentioned user.	metric
entities.mentions.start	entities.mentions.start	The integer index marking the start position (inclusive) of the mentioned user’s username in the Tweet text.	metric
entities.mentions.username	entities.mentions.username	The username of the mentioned user.	dimension
entities.urls.description	entities.urls.description	A description of the content at the URL included in the Tweet.	dimension
entities.urls.display_url	entities.urls.display_url	The URL as it would be displayed to a user, often shortened or cleaned for readability.	dimension
entities.urls.end	entities.urls.end	The ending index of the URL within the Tweet text.	metric
entities.urls.expanded_url	entities.urls.expanded_url	The full, unshortened URL to which a shortened URL or T.co link resolves.	dimension
entities.urls.images	entities.urls.images	A list of image objects associated with the URL, including their URL and dimensions, if available.	dimension
entities.urls.media_key	entities.urls.media_key	The unique identifier for any media object associated with the URL. Requires the ‘attachments.media_keys’ expansion to return media object metadata.	metric
entities.urls.start	entities.urls.start	The starting index of the URL within the Tweet text.	metric
entities.urls.status	entities.urls.status	The HTTP status code returned when the URL was unwound or fetched, indicating its availability.	metric
entities.urls.title	entities.urls.title	The title of the webpage or content referenced by the URL included in the Tweet.	dimension
entities.urls.unwound_url	entities.urls.unwound_url	The final URL after all redirects have been followed, providing the canonical link.	dimension
entities.urls.url	entities.urls.url	The primary URL as it appears in the Tweet text or expanded from a T.co link.	dimension
id	id	The unique identifier for the Tweet, user, or other object.	dimension
in_reply_to_user_id	in_reply_to_user_id	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.	dimension
media_media_key	media_media_key	The unique identifier for a media object associated with the Tweet.	metric
media_non_public_metrics	media_non_public_metrics	Non-public engagement metrics related to media attached to a Tweet, such as impressions, that are only accessible to the authenticated account owner. This field requires specific user context authentication.	dimension
media_organic_metrics	media_organic_metrics	Organic engagement metrics for media objects associated with a Tweet, representing unpaid interactions. These metrics require OAuth 1.0a User Context authentication.	dimension
media_preview_image_url	media_preview_image_url	A URL to a preview image for video or GIF media attachments.	dimension
media_public_metrics	media_public_metrics	Public engagement metrics for the media attached to the Tweet, such as view counts.	metric
media_type	media_type	The type of media attached to the Tweet (e.g., ‘photo’, ‘video’, ‘gif’).	dimension
media_url	media_url	The URL to the media file associated with the Tweet.	dimension
name	name	The display name of the user.	dimension
non_public_metrics.engagements	non_public_metrics.engagements	A collection of private engagement metrics for a Tweet, visible only to the authenticated account owner. This includes metrics like impression count, URL link clicks, and user profile clicks. This field requires specific user context authentication.	metric
non_public_metrics.impression_count	non_public_metrics.impression_count	The total number of times a Tweet has been displayed to users, representing non-public impressions. This metric requires OAuth 1.0a User Context authentication.	metric
non_public_metrics.url_link_clicks	non_public_metrics.url_link_clicks	The count of times a URL link embedded within a Tweet was clicked. This is a private metric, only available to the authenticated account owner. This field requires specific user context authentication.	metric
non_public_metrics.user_profile_clicks	non_public_metrics.user_profile_clicks	The count of times an authenticated user’s profile was clicked from a Tweet. This is a private metric, only available to the authenticated account owner. This field requires specific user context authentication.	metric
organic_metrics.impression_count	organic_metrics.impression_count	The number of times a Tweet has been displayed to users organically (unpaid reach). This metric requires OAuth 1.0a User Context authentication.	metric
organic_metrics.like_count	organic_metrics.like_count	The number of organic likes received by a Tweet. Organic metrics represent engagement that is not a result of paid promotion.	metric
organic_metrics.reply_count	organic_metrics.reply_count	The number of organic replies received by a Tweet. Organic metrics represent engagement that is not a result of paid promotion.	metric
organic_metrics.retweet_count	organic_metrics.retweet_count	The number of organic retweets for a Tweet. Organic metrics represent engagement that is not a result of paid promotion.	metric
organic_metrics.url_link_clicks	organic_metrics.url_link_clicks	The number of organic URL link clicks on a Tweet. Organic metrics represent engagement that is not a result of paid promotion.	metric
organic_metrics.user_profile_clicks	organic_metrics.user_profile_clicks	The number of organic clicks on the user’s profile from a Tweet. Organic metrics represent engagement that is not a result of paid promotion.	metric
pinned_tweet_attachments	pinned_tweet_attachments	A list of attachments (e.g., media keys, poll IDs) associated with the pinned Tweet.	dimension
pinned_tweet_author_id	pinned_tweet_author_id	The unique identifier of the user who authored the pinned Tweet on a user’s profile.	dimension
pinned_tweet_context_annotations	pinned_tweet_context_annotations	Contextual information, including domain and entity details, for the Tweet that a user has pinned to their profile.	dimension
pinned_tweet_created_at	pinned_tweet_created_at	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’.	dimension
pinned_tweet_edit_history_tweet_ids	pinned_tweet_edit_history_tweet_ids	A list of Tweet IDs representing the edit history of the pinned Tweet.	dimension
pinned_tweet_entities	pinned_tweet_entities	Contains parsed entities (hashtags, mentions, URLs) present in the text of the pinned Tweet.	dimension
pinned_tweet_in_reply_to_user_id	pinned_tweet_in_reply_to_user_id	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’.	dimension
pinned_tweet_non_public_metrics	pinned_tweet_non_public_metrics	Non-public engagement metrics, such as impressions, for the Tweet that a user has pinned to their profile. These metrics require OAuth 1.0a User Context authentication.	dimension
pinned_tweet_organic_metrics	pinned_tweet_organic_metrics	Organic engagement metrics, such as likes and replies from unpaid reach, for the Tweet that a user has pinned to their profile. These metrics require OAuth 1.0a User Context authentication.	dimension
pinned_tweet_public_metrics	pinned_tweet_public_metrics	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’.	metric
pinned_tweet_referenced_tweets	pinned_tweet_referenced_tweets	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’.	dimension
pinned_tweet_text	pinned_tweet_text	The full text content of the pinned Tweet.	dimension
public_metrics.bookmark_count	public_metrics.bookmark_count	The total count of times a Tweet has been bookmarked.	metric
public_metrics.followers_count	public_metrics.followers_count	The total number of followers a user has.	metric
public_metrics.following_count	public_metrics.following_count	The total number of accounts a user is following.	metric
public_metrics.impression_count	public_metrics.impression_count	The total number of times a Tweet has been viewed or seen by users.	metric
public_metrics.like_count	public_metrics.like_count	The total number of times a Tweet has been liked.	metric
public_metrics.listed_count	public_metrics.listed_count	The total number of public lists a user is a member of.	metric
public_metrics.media_count	public_metrics.media_count	The total number of media attachments (images, videos, GIFs) uploaded by a user.	metric
public_metrics.quote_count	public_metrics.quote_count	The total number of times a Tweet has been quoted by other Tweets.	metric
public_metrics.reply_count	public_metrics.reply_count	The total number of replies to a Tweet.	metric
public_metrics.retweet_count	public_metrics.retweet_count	The total number of times a Tweet has been retweeted.	metric
public_metrics.tweet_count	public_metrics.tweet_count	The total number of Tweets posted by a user.	metric
referenced_tweets.id	referenced_tweets.id	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.	metric
referenced_tweets.type	referenced_tweets.type	The type of relationship to the referenced Tweet, such as ‘retweeted’, ‘replied_to’, or ‘quoted’.	dimension
report_date	report_date	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.	dimension
text	text	The full text content of the Tweet.	dimension
url	url	The URL provided in the user’s profile, if available. For media, it’s the URL of the media itself.	dimension
username	username	The unique username of the user.	dimension