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
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.entity.description	context_annotations.entity.description	A descriptive text for the context entity, providing more detail about the named entity identified within the Tweet’s context.	dimension
created_at	created_at	The timestamp indicating when the Tweet or user account was created.	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 character position marking the end of the annotation in the Tweet text.	metric
entities.annotations.normalized_text	entities.annotations.normalized_text		dimension
entities.annotations.probability	entities.annotations.probability		metric
entities.annotations.start	entities.annotations.start	The character position marking the beginning of the annotation in the Tweet text.	metric
entities.annotations.type	entities.annotations.type	The category or type of the annotated entity, such as ‘Person’, ‘Place’, ‘Organization’, or ‘Product’.	dimension
entities.mentions.end	entities.mentions.end	The character position marking the end of the user mention 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 character position marking the beginning of the user mention in the Tweet text.	metric
entities.mentions.username	entities.mentions.username	The username of the mentioned user.	dimension
entities.urls.description	entities.urls.description	The description associated with the unwound URL, if available, providing context about the linked content.	dimension
entities.urls.display_url	entities.urls.display_url	The shortened URL that is displayed in the Tweet.	dimension
entities.urls.end	entities.urls.end	The character position marking the end of the URL in the Tweet text.	metric
entities.urls.expanded_url	entities.urls.expanded_url	The full, unshortened URL.	dimension
entities.urls.images	entities.urls.images	An array of image objects associated with the URL preview, if available, for richer content display.	dimension
entities.urls.media_key	entities.urls.media_key	The unique identifier for any media associated with the URL, if applicable, used for linking to expanded media objects.	metric
entities.urls.start	entities.urls.start	The character position marking the beginning of the URL in the Tweet text.	metric
entities.urls.status	entities.urls.status		metric
entities.urls.title	entities.urls.title	The title of the page that the URL links to, if available, for providing more context about the shared link.	dimension
entities.urls.unwound_url	entities.urls.unwound_url	The final URL after all redirects have been followed, providing the direct destination of the link.	dimension
entities.urls.url	entities.urls.url	The original URL as it appeared in the Tweet text.	dimension
id	id	The unique identifier for the Tweet, user, or other object.	dimension
media_media_key	media_media_key	The unique identifier for a media object associated with the Tweet.	metric
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
name	name	The display name of the user.	dimension
non_public_metrics.engagements	non_public_metrics.engagements	The total number of times users interacted with a Tweet, including actions such as clicks, likes, and replies, for analytics purposes outside of paid advertising.	metric
non_public_metrics.impression_count	non_public_metrics.impression_count	The number of times a Tweet was viewed by users.	metric
non_public_metrics.url_link_clicks	non_public_metrics.url_link_clicks	The number of times users clicked on a URL link included in the Tweet.	metric
non_public_metrics.user_profile_clicks	non_public_metrics.user_profile_clicks	The number of times users clicked on the author’s profile from the Tweet.	metric
organic_metrics.impression_count	organic_metrics.impression_count	The total number of times the Tweet was seen in an organic (non-promoted) context.	metric
organic_metrics.like_count	organic_metrics.like_count	The number of times the Tweet was liked organically.	metric
organic_metrics.reply_count	organic_metrics.reply_count	The number of times the Tweet received an organic reply.	metric
organic_metrics.retweet_count	organic_metrics.retweet_count	The number of times the Tweet was organically retweeted.	metric
organic_metrics.url_link_clicks	organic_metrics.url_link_clicks	The number of organic clicks on URLs included in the Tweet.	metric
organic_metrics.user_profile_clicks	organic_metrics.user_profile_clicks	The number of organic clicks on the user’s profile associated with the Tweet.	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_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_text	pinned_tweet_text	The full text content of the pinned Tweet.	dimension
public_metrics.bookmark_count	public_metrics.bookmark_count	The number of times the Tweet has been bookmarked.	metric
public_metrics.impression_count	public_metrics.impression_count	The total number of impressions (views) the Tweet has received.	metric
public_metrics.like_count	public_metrics.like_count	The number of times the Tweet has been liked.	metric
public_metrics.quote_count	public_metrics.quote_count	The number of times the Tweet has been quoted.	metric
public_metrics.reply_count	public_metrics.reply_count	The number of replies the Tweet has received.	metric
public_metrics.retweet_count	public_metrics.retweet_count	The number of times the Tweet has been retweeted.	metric
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
username	username	The unique username of the user.	dimension