--- title: "Returns Tweet objects liked by the provided User ID" method: GET path: "/2/users/{id}/liked_tweets" tags: ["Tweets"] --- # Returns Tweet objects liked by the provided User ID `GET /2/users/{id}/liked_tweets` Returns a list of Tweets liked by the provided User ID ## Path parameters - `id` string, required — Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers. ## Query parameters - `max_results` integer - `pagination_token` string — A base36 pagination token. - `tweet.fields` string[] — The fields available for a Tweet object. - `expansions` string[] — The list of fields you can expand for a [Tweet](#Tweet) object. If the field has an ID, it can be expanded into a full object. - `media.fields` string[] — The fields available for a Media object. - `poll.fields` string[] — The fields available for a Poll object. - `user.fields` string[] — The fields available for a User object. - `place.fields` string[] — The fields available for a Place object. ## Response `200` The request has succeeded. - Get2UsersIdLikedTweetsResponse - `data` Tweet[] - `attachments` object — Specifies the type of attachments (if any) present in this Tweet. - `media_keys` MediaKey[] — A list of Media Keys for each one of the media attachments (if media are attached). - `poll_ids` PollId[] — A list of poll IDs (if polls are attached). - `author_id` string — Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers. - `context_annotations` ContextAnnotation[] - `domain` ContextAnnotationDomainFields, required — Represents the data for the context annotation domain. - `description` string — Description of the context annotation domain. - `id` string, required — The unique id for a context annotation domain. - `name` string — Name of the context annotation domain. - `entity` ContextAnnotationEntityFields, required — Represents the data for the context annotation entity. - `description` string — Description of the context annotation entity. - `id` string, required — The unique id for a context annotation entity. - `name` string — Name of the context annotation entity. - `conversation_id` string — Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers. - `created_at` string, date-time — Creation time of the Tweet. - `edit_controls` object - `editable_until` string, date-time, required — Time when Tweet is no longer editable. - `edits_remaining` integer, required — Number of times this Tweet can be edited. - `is_edit_eligible` boolean, required — Indicates if this Tweet is eligible to be edited. - `edit_history_tweet_ids` TweetId[], required — A list of Tweet Ids in this Tweet chain. - `entities` FullTextEntities - `annotations` object[] - `end` integer, required — Index (zero-based) at which position this entity ends. The index is inclusive. - `start` integer, required — Index (zero-based) at which position this entity starts. The index is inclusive. - `normalized_text` string — Text used to determine annotation. - `probability` number, double — Confidence factor for annotation type. - `type` string — Annotation type. - `cashtags` CashtagEntity[] - `end` integer, required — Index (zero-based) at which position this entity ends. The index is exclusive. - `start` integer, required — Index (zero-based) at which position this entity starts. The index is inclusive. - `tag` string, required - `hashtags` HashtagEntity[] - `end` integer, required — Index (zero-based) at which position this entity ends. The index is exclusive. - `start` integer, required — Index (zero-based) at which position this entity starts. The index is inclusive. - `tag` string, required — The text of the Hashtag. - `mentions` MentionEntity[] - `end` integer, required — Index (zero-based) at which position this entity ends. The index is exclusive. - `start` integer, required — Index (zero-based) at which position this entity starts. The index is inclusive. - `id` string — Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers. - `username` string, required — The Twitter handle (screen name) of this user. - `urls` UrlEntity[] - `end` integer, required — Index (zero-based) at which position this entity ends. The index is exclusive. - `start` integer, required — Index (zero-based) at which position this entity starts. The index is inclusive. - `description` string — Description of the URL landing page. - `display_url` string — The URL as displayed in the Twitter client. - `expanded_url` string, uri — A validly formatted URL. - `images` UrlImage[] - `height` integer — The height of the media in pixels. - `url` string, uri — A validly formatted URL. - `width` integer — The width of the media in pixels. - `media_key` string — The Media Key identifier for this attachment. - `status` integer — HTTP Status Code. - `title` string — Title of the page the URL points to. - `unwound_url` string, uri — Fully resolved url. - `url` string, uri, required — A validly formatted URL. - `geo` object — The location tagged on the Tweet, if the user provided one. - `coordinates` Point — A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object. - `coordinates` number[], required — A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`. - `type` 'Point', required - `place_id` string — The identifier for this place. - `id` string, required — Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers. - `in_reply_to_user_id` string — Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers. - `lang` string — Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag. - `non_public_metrics` object — Nonpublic engagement metrics for the Tweet at the time of the request. - `impression_count` integer — Number of times this Tweet has been viewed. - `organic_metrics` object — Organic nonpublic engagement metrics for the Tweet at the time of the request. - `impression_count` integer, required — Number of times this Tweet has been viewed. - `like_count` integer, required — Number of times this Tweet has been liked. - `reply_count` integer, required — Number of times this Tweet has been replied to. - `retweet_count` integer, required — Number of times this Tweet has been Retweeted. - `possibly_sensitive` boolean — Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences. - `promoted_metrics` object — Promoted nonpublic engagement metrics for the Tweet at the time of the request. - `impression_count` integer — Number of times this Tweet has been viewed. - `like_count` integer — Number of times this Tweet has been liked. - `reply_count` integer — Number of times this Tweet has been replied to. - `retweet_count` integer — Number of times this Tweet has been Retweeted. - `public_metrics` object — Engagement metrics for the Tweet at the time of the request. - `impression_count` integer, required — Number of times this Tweet has been viewed. - `like_count` integer, required — Number of times this Tweet has been liked. - `quote_count` integer — Number of times this Tweet has been quoted. - `reply_count` integer, required — Number of times this Tweet has been replied to. - `retweet_count` integer, required — Number of times this Tweet has been Retweeted. - `referenced_tweets` object[] — A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent. - `id` string, required — Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers. - `type` 'retweeted' | 'quoted' | 'replied_to', required - `reply_settings` 'everyone' | 'mentionedUsers' | 'following' | 'other' — Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following. - `source` string — This is deprecated. - `text` string, required — The content of the Tweet. - `withheld` TweetWithheld — Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country). - `copyright` boolean, required — Indicates if the content is being withheld for on the basis of copyright infringement. - `country_codes` CountryCode[], required — Provides a list of countries where this content is not available. - `scope` 'tweet' | 'user' — Indicates whether the content being withheld is the `tweet` or a `user`. - `errors` Problem[] - `detail` string - `status` integer - `title` string, required - `type` string, required - `includes` Expansions - `media` Media[] - `height` integer — The height of the media in pixels. - `media_key` string — The Media Key identifier for this attachment. - `type` string, required - `width` integer — The width of the media in pixels. - `places` Place[] - `contained_within` PlaceId[] - `country` string — The full name of the county in which this place exists. - `country_code` string — A two-letter ISO 3166-1 alpha-2 country code. - `full_name` string, required — The full name of this place. - `geo` Geo - `bbox` number[], required - `geometry` Point — A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object. - `coordinates` number[], required — A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`. - `type` 'Point', required - `properties` object, required - `type` 'Feature', required - `id` string, required — The identifier for this place. - `name` string — The human readable name of this place. - `place_type` 'poi' | 'neighborhood' | 'city' | 'admin' | 'country' | 'unknown' - `polls` Poll[] - `duration_minutes` integer - `end_datetime` string, date-time - `id` string, required — Unique identifier of this poll. - `options` PollOption[], required - `label` string, required — The text of a poll choice. - `position` integer, required — Position of this choice in the poll. - `votes` integer, required — Number of users who voted for this choice. - `voting_status` 'open' | 'closed' - `topics` Topic[] - `description` string — The description of the given topic. - `id` string, required — Unique identifier of this Topic. - `name` string, required — The name of the given topic. - `tweets` Tweet[] - `attachments` object — Specifies the type of attachments (if any) present in this Tweet. - `media_keys` MediaKey[] — A list of Media Keys for each one of the media attachments (if media are attached). - `poll_ids` PollId[] — A list of poll IDs (if polls are attached). - `author_id` string — Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers. - `context_annotations` ContextAnnotation[] - `domain` ContextAnnotationDomainFields, required — Represents the data for the context annotation domain. - `description` string — Description of the context annotation domain. - `id` string, required — The unique id for a context annotation domain. - `name` string — Name of the context annotation domain. - `entity` ContextAnnotationEntityFields, required — Represents the data for the context annotation entity. - `description` string — Description of the context annotation entity. - `id` string, required — The unique id for a context annotation entity. - `name` string — Name of the context annotation entity. - `conversation_id` string — Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers. - `created_at` string, date-time — Creation time of the Tweet. - `edit_controls` object - `editable_until` string, date-time, required — Time when Tweet is no longer editable. - `edits_remaining` integer, required — Number of times this Tweet can be edited. - `is_edit_eligible` boolean, required — Indicates if this Tweet is eligible to be edited. - `edit_history_tweet_ids` TweetId[], required — A list of Tweet Ids in this Tweet chain. - `entities` FullTextEntities - `annotations` object[] - `end` integer, required — Index (zero-based) at which position this entity ends. The index is inclusive. - `start` integer, required — Index (zero-based) at which position this entity starts. The index is inclusive. - `normalized_text` string — Text used to determine annotation. - `probability` number, double — Confidence factor for annotation type. - `type` string — Annotation type. - `cashtags` CashtagEntity[] - `end` integer, required — Index (zero-based) at which position this entity ends. The index is exclusive. - `start` integer, required — Index (zero-based) at which position this entity starts. The index is inclusive. - `tag` string, required - `hashtags` HashtagEntity[] - `end` integer, required — Index (zero-based) at which position this entity ends. The index is exclusive. - `start` integer, required — Index (zero-based) at which position this entity starts. The index is inclusive. - `tag` string, required — The text of the Hashtag. - `mentions` MentionEntity[] - `end` integer, required — Index (zero-based) at which position this entity ends. The index is exclusive. - `start` integer, required — Index (zero-based) at which position this entity starts. The index is inclusive. - `id` string — Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers. - `username` string, required — The Twitter handle (screen name) of this user. - `urls` UrlEntity[] - `end` integer, required — Index (zero-based) at which position this entity ends. The index is exclusive. - `start` integer, required — Index (zero-based) at which position this entity starts. The index is inclusive. - `description` string — Description of the URL landing page. - `display_url` string — The URL as displayed in the Twitter client. - `expanded_url` string, uri — A validly formatted URL. - `images` UrlImage[] - `height` integer — The height of the media in pixels. - `url` string, uri — A validly formatted URL. - `width` integer — The width of the media in pixels. - `media_key` string — The Media Key identifier for this attachment. - `status` integer — HTTP Status Code. - `title` string — Title of the page the URL points to. - `unwound_url` string, uri — Fully resolved url. - `url` string, uri, required — A validly formatted URL. - `geo` object — The location tagged on the Tweet, if the user provided one. - `coordinates` Point — A [GeoJson Point](https://tools.ietf.org/html/rfc7946#section-3.1.2) geometry object. - `coordinates` number[], required — A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`. - `type` 'Point', required - `place_id` string — The identifier for this place. - `id` string, required — Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers. - `in_reply_to_user_id` string — Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers. - `lang` string — Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag. - `non_public_metrics` object — Nonpublic engagement metrics for the Tweet at the time of the request. - `impression_count` integer — Number of times this Tweet has been viewed. - `organic_metrics` object — Organic nonpublic engagement metrics for the Tweet at the time of the request. - `impression_count` integer, required — Number of times this Tweet has been viewed. - `like_count` integer, required — Number of times this Tweet has been liked. - `reply_count` integer, required — Number of times this Tweet has been replied to. - `retweet_count` integer, required — Number of times this Tweet has been Retweeted. - `possibly_sensitive` boolean — Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences. - `promoted_metrics` object — Promoted nonpublic engagement metrics for the Tweet at the time of the request. - `impression_count` integer — Number of times this Tweet has been viewed. - `like_count` integer — Number of times this Tweet has been liked. - `reply_count` integer — Number of times this Tweet has been replied to. - `retweet_count` integer — Number of times this Tweet has been Retweeted. - `public_metrics` object — Engagement metrics for the Tweet at the time of the request. - `impression_count` integer, required — Number of times this Tweet has been viewed. - `like_count` integer, required — Number of times this Tweet has been liked. - `quote_count` integer — Number of times this Tweet has been quoted. - `reply_count` integer, required — Number of times this Tweet has been replied to. - `retweet_count` integer, required — Number of times this Tweet has been Retweeted. - `referenced_tweets` object[] — A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent. - `id` string, required — Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers. - `type` 'retweeted' | 'quoted' | 'replied_to', required - `reply_settings` 'everyone' | 'mentionedUsers' | 'following' | 'other' — Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following. - `source` string — This is deprecated. - `text` string, required — The content of the Tweet. - `withheld` TweetWithheld — Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country). - `copyright` boolean, required — Indicates if the content is being withheld for on the basis of copyright infringement. - `country_codes` CountryCode[], required — Provides a list of countries where this content is not available. - `scope` 'tweet' | 'user' — Indicates whether the content being withheld is the `tweet` or a `user`. - `users` User[] - `created_at` string, date-time — Creation time of this User. - `description` string — The text of this User's profile description (also known as bio), if the User provided one. - `entities` object — A list of metadata found in the User's profile description. - `description` FullTextEntities - `annotations` object[] - `end` integer, required — Index (zero-based) at which position this entity ends. The index is inclusive. - `start` integer, required — Index (zero-based) at which position this entity starts. The index is inclusive. - `normalized_text` string — Text used to determine annotation. - `probability` number, double — Confidence factor for annotation type. - `type` string — Annotation type. - `cashtags` CashtagEntity[] - `end` integer, required — Index (zero-based) at which position this entity ends. The index is exclusive. - `start` integer, required — Index (zero-based) at which position this entity starts. The index is inclusive. - `tag` string, required - `hashtags` HashtagEntity[] - `end` integer, required — Index (zero-based) at which position this entity ends. The index is exclusive. - `start` integer, required — Index (zero-based) at which position this entity starts. The index is inclusive. - `tag` string, required — The text of the Hashtag. - `mentions` MentionEntity[] - `end` integer, required — Index (zero-based) at which position this entity ends. The index is exclusive. - `start` integer, required — Index (zero-based) at which position this entity starts. The index is inclusive. - `id` string — Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers. - `username` string, required — The Twitter handle (screen name) of this user. - `urls` UrlEntity[] - `end` integer, required — Index (zero-based) at which position this entity ends. The index is exclusive. - `start` integer, required — Index (zero-based) at which position this entity starts. The index is inclusive. - `description` string — Description of the URL landing page. - `display_url` string — The URL as displayed in the Twitter client. - `expanded_url` string, uri — A validly formatted URL. - `images` UrlImage[] - … - `media_key` string — The Media Key identifier for this attachment. - `status` integer — HTTP Status Code. - `title` string — Title of the page the URL points to. - `unwound_url` string, uri — Fully resolved url. - `url` string, uri, required — A validly formatted URL. - `url` object — Expanded details for the URL specified in the User's profile, with start and end indices. - `urls` UrlEntity[] - `end` integer, required — Index (zero-based) at which position this entity ends. The index is exclusive. - `start` integer, required — Index (zero-based) at which position this entity starts. The index is inclusive. - `description` string — Description of the URL landing page. - `display_url` string — The URL as displayed in the Twitter client. - `expanded_url` string, uri — A validly formatted URL. - `images` UrlImage[] - … - `media_key` string — The Media Key identifier for this attachment. - `status` integer — HTTP Status Code. - `title` string — Title of the page the URL points to. - `unwound_url` string, uri — Fully resolved url. - `url` string, uri, required — A validly formatted URL. - `id` string, required — Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers. - `location` string — The location specified in the User's profile, if the User provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries. - `name` string, required — The friendly name of this User, as shown on their profile. - `pinned_tweet_id` string — Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers. - `profile_image_url` string, uri — The URL to the profile image for this User. - `protected` boolean — Indicates if this User has chosen to protect their Tweets (in other words, if this User's Tweets are private). - `public_metrics` object — A list of metrics for this User. - `followers_count` integer, required — Number of Users who are following this User. - `following_count` integer, required — Number of Users this User is following. - `listed_count` integer, required — The number of lists that include this User. - `tweet_count` integer, required — The number of Tweets (including Retweets) posted by this User. - `url` string — The URL specified in the User's profile. - `username` string, required — The Twitter handle (screen name) of this user. - `verified` boolean — Indicate if this User is a verified Twitter User. - `verified_type` string — The Twitter Blue verified type of the user, eg: blue, government, business or none. - `withheld` UserWithheld — Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country). - `country_codes` CountryCode[], required — Provides a list of countries where this content is not available. - `scope` 'user' — Indicates that the content being withheld is a `user`. - `meta` object - `next_token` string — The next token. - `previous_token` string — The previous token. - `result_count` integer — The number of results returned in this response. ## Other responses - `default` — The request has failed. --- [API](https://skmtc.net/mfullbrook/apis/current.md) · [All operations](https://skmtc.net/mfullbrook/apis/current/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mfullbrook/current/versions/4b066912ce32/schema)