xurl /2/users/12345?user.fields=id,name,username,description,public_metrics,created_at

Get profiles for multiple users at once (up to 100):

Note: Replace the IDs with actual user IDs, comma-separated.

xurl '/2/users?ids=12345,67890&user.fields=id,name,username,description,public_metrics'

Note: Replace 1234567890 with the actual tweet ID. Full URLs like https://x.com/user/status/1234567890 also work.

xurl read 1234567890

Get details for multiple tweets at once (up to 100):

Note: Replace the IDs with actual tweet IDs, comma-separated.

xurl '/2/tweets?ids=1234567890,0987654321&tweet.fields=created_at,public_metrics,author_id,text&expansions=author_id&user.fields=name,username'

Get recent tweets posted by the authenticated user:

xurl timeline -n 10

Query parameters for raw API (if you need another user's timeline):

xurl '/2/users/USER_ID/tweets?max_results=10&tweet.fields=created_at,public_metrics,text&exclude=retweets,replies'

xurl mentions -n 10

Search for tweets from the past 7 days:

Note: Replace the query with your search terms.

xurl search "openai lang:en -is:retweet" -n 10

Common search operators:

Note: Replace elonmusk with the actual username.

xurl followers --of elonmusk -n 20

Note: Replace elonmusk with the actual username.

xurl following --of elonmusk -n 20

Pagination

Most list endpoints support pagination. For shortcut commands, use -n to control result count.

For raw API endpoints, check the meta.next_token field in the response:

xurl '/2/tweets/search/recent?query=example&max_results=10' | jq .meta

Use the returned next_token value as pagination_token in the next request to get more results.

Common user.fields

Field	Description
`id`	Unique user ID
`name`	Display name
`username`	Handle (without @)
`description`	Bio text
`created_at`	Account creation date
`public_metrics`	Followers, following, tweet, and listed counts
`profile_image_url`	Avatar URL
`verified`	Verification status
`location`	User-defined location
`url`	User-defined URL

Field	Description
`id`	Unique tweet ID
`text`	Tweet content
`created_at`	Post timestamp
`author_id`	Author's user ID
`public_metrics`	Retweets, replies, likes, quotes, bookmarks, impressions
`conversation_id`	Thread root tweet ID
`lang`	Detected language
`referenced_tweets`	Retweet/quote/reply references
`entities`	URLs, hashtags, mentions, cashtags

Read-only access: This connector only grants read permissions; you cannot post, like, or retweet
Rate limits: X API has strict rate limits; avoid rapid successive calls
Prefer shortcut commands: Use xurl search, xurl user, xurl read etc. over raw API paths when possible
Raw API fallback: For bulk lookups or advanced queries, use xurl '/2/...' with query parameters
Fields are opt-in (raw API only): Raw endpoints only return id and text by default; specify tweet.fields and user.fields for richer data. Shortcut commands include common fields automatically
7-day search window: The recent search endpoint only covers the past 7 days
Pagination: Use -n for shortcut commands, max_results and pagination_token for raw API