X

X Users API

Endpoints related to retrieving, managing relationships of Users — 42 operation(s) in the X-published contract.

GitHub OpenAPI

Operations 44

GET /2/users Get Users by IDs #
GET /2/users/by Get Users by Usernames #
GET /2/users/by/username/{username} Get Users by Username #
GET /2/users/me Get Users Me #
GET /2/users/public_keys Get public keys #
GET /2/users/reposts_of_me Get Users Reposts of Me #
GET /2/users/search Search Users #
GET /2/users/{id} Get Users by ID #
GET /2/users/{id}/affiliates Get Users Affiliates #
GET /2/users/{id}/blocking Get Users Blocking #
GET /2/users/{id}/bookmarks Get Users Bookmarks #
POST /2/users/{id}/bookmarks Create Users Bookmark #
GET /2/users/{id}/bookmarks/folders Get Users Bookmark Folders #
POST /2/users/{id}/bookmarks/folders Create Bookmark Folder #
GET /2/users/{id}/bookmarks/folders/{folder_id} Get Users Bookmarks by Folder ID #
DELETE /2/users/{id}/bookmarks/{tweet_id} Delete Bookmark #
POST /2/users/{id}/dm/block Block Users Dms #
POST /2/users/{id}/dm/unblock Unblock Users Dms #
GET /2/users/{id}/followed_lists Get Users Followed Lists #
POST /2/users/{id}/followed_lists Follow List #
DELETE /2/users/{id}/followed_lists/{list_id} Unfollow a List #
GET /2/users/{id}/followers Get Users Followers #
GET /2/users/{id}/following Get Users Following #
POST /2/users/{id}/following Follow User #
GET /2/users/{id}/liked_tweets Get Users Liked Posts #
POST /2/users/{id}/likes Like Post #
DELETE /2/users/{id}/likes/{tweet_id} Unlike Post #
GET /2/users/{id}/list_memberships Get Users List Memberships #
GET /2/users/{id}/mentions Get Users Mentions #
GET /2/users/{id}/muting Get Users Muting #
POST /2/users/{id}/muting Mute User #
GET /2/users/{id}/owned_lists Get Users Owned Lists #
GET /2/users/{id}/pinned_lists Get Users Pinned Lists #
POST /2/users/{id}/pinned_lists Pin List #
DELETE /2/users/{id}/pinned_lists/{list_id} Unpin a List #
GET /2/users/{id}/public_keys Get public keys #
POST /2/users/{id}/retweets Repost Post #
DELETE /2/users/{id}/retweets/{source_tweet_id} Unrepost Post #
GET /2/users/{id}/timelines/reverse_chronological Get Users Timeline #
GET /2/users/{id}/tweets Get Users Posts #
DELETE /2/users/{source_user_id}/following/{target_user_id} Unfollow User #
DELETE /2/users/{source_user_id}/muting/{target_user_id} Unmute User #
GET /users/{id} Look up a user by ID #
GET /users/by/username/{username} Look up a user by username #

Documentation

📖
Documentation
https://docs.x.com/x-api/users/introduction

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/x/refs/heads/main/openapi/x-users-api-openapi.yml

Other Resources

🔗
OpenCollection
https://raw.githubusercontent.com/api-evangelist/x/refs/heads/main/collections/x-users-api.opencollection.json
🔗
PostmanCollection
https://raw.githubusercontent.com/api-evangelist/x/refs/heads/main/collections/x-users-api.postman_collection.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/x-users-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

x-users-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: X Users API
  version: '1.0'
  description: 'Operations tagged Users across 2 of this provider''s published API definitions: x-api-v2-openapi.json, x-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- description: X API
  url: https://api.x.com
- url: https://api.x.com/2
  description: X API v2 production server
tags:


# --- truncated at 32 KB (146 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/x/refs/heads/main/openapi/x-users-api-openapi.yml