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.media_source_tweet_id	attachments.media_source_tweet_id	The unique identifier of the Tweet from which the attached media originated, if applicable. This field is not explicitly mentioned as ‘media_source_tweet_id’ in general Tweet/Media fields, but could be inferred from an expansion. Given the explicit naming, it suggests a specific data point.	dimension
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
conversation_id	conversation_id	The unique identifier of the conversation that the Tweet belongs to.	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 ending index of the user mention within 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 starting index of the user mention within 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, typically extracted from the linked page’s metadata.	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 linked content, typically extracted from the HTML title tag of the web page.	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
lang	lang	The BCP47 language tag of the Tweet’s detected language.	dimension
media_duration_ms	media_duration_ms	The duration of video or GIF media in milliseconds.	metric
media_media_key	media_media_key	The unique identifier for a media object associated with the Tweet.	metric
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 of the media file, such as an image or video. This is typically available when requesting ‘media.fields’ with ‘url’.	dimension
name	name	The display name of the user.	dimension
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_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_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
type	type	Indicates the type of object being returned, such as a Tweet, User, Media, or Poll. For referenced tweets, it specifies the relationship type, e.g., ‘replied_to’, ‘retweeted’, ‘quoted’.	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
verified	verified	Indicates whether the user is a verified account.	dimension