Skip to main content
GET
Get Users Bookmarks

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

FlowAuthorization Code
Authorization URL
https://api.x.com/2/oauth2/authorize
Token URL
https://api.x.com/2/oauth2/token
Scopes3
bookmark.read
Read your bookmarked Posts.
tweet.read
View all posts you can see, including those from protected accounts.
users.read
View any account you can see, including protected accounts.

Path Parameters

id
string
required

Unique identifier of a User

Pattern: ^[0-9]{1,19}$
Example:

"2244994945"

Query Parameters

max_results
integer<int32>
Required range: 1 <= x <= 100
pagination_token
string

A base32hex-encoded pagination token.

Minimum string length: 1
post.fields
enum<string>[]

A comma separated list of Post fields to display. The fields available for a Post object.

Minimum array length: 1
Available options:
article,
article_title,
attachments,
card_uri,
community_id,
context_annotations,
conversation_id,
created_at,
display_text_range,
edit_controls,
entities,
geo,
id,
lang,
matched_media_notes,
media_metadata,
non_public_metrics,
note_post,
note_request_suggestions,
organic_metrics,
paid_partnership,
possibly_sensitive,
promoted_metrics,
public_metrics,
reply_settings,
scopes,
source,
suggested_source_links,
suggested_source_links_with_counts,
text,
withheld
expansions
enum<string>[]

A comma separated list of fields to expand.

Minimum array length: 1
Available options:
article.cover_media,
article.media_entities,
attachments.media_keys,
attachments.media_source_tweet,
attachments.poll_ids,
author_id,
edit_history_post_ids,
entities.mentions.username,
geo.place_id,
in_reply_to_user_id,
referenced_posts,
username
user.fields
enum<string>[]

A comma separated list of User fields to display. The fields available for a User object.

Minimum array length: 1
Available options:
confirmed_email,
connection_status,
created_at,
description,
entities,
id,
is_identity_verified,
location,
name,
parody,
profile_banner_url,
profile_image_url,
protected,
public_metrics,
receives_your_dm,
subscriber_count,
subscribes_to_you,
subscription,
subscription_type,
url,
username,
verified,
verified_followers_count,
verified_type,
withheld
media.fields
enum<string>[]

A comma separated list of Media fields to display. The fields available for a Media object.

Minimum array length: 1
Available options:
alt_text,
duration_ms,
height,
media_key,
non_public_metrics,
organic_metrics,
preview_image_url,
promoted_metrics,
public_metrics,
type,
url,
variants,
width
poll.fields
enum<string>[]

A comma separated list of Poll fields to display. The fields available for a Poll object.

Minimum array length: 1
Available options:
duration_minutes,
end_datetime,
id,
options,
voting_status
place.fields
enum<string>[]

A comma separated list of Place fields to display. The fields available for a Place object.

Minimum array length: 1
Available options:
contained_within,
country,
country_code,
full_name,
geo,
id,
name,
place_type

Response

The request has succeeded.

data
object[]
errors
object[]
includes
object
meta
object