X (Twitter)

X (Twitter) Users API

Endpoints related to retrieving, managing relationships of Users

GitHub OpenAPI

Operations 45

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

Documentation

📖
Documentation
https://docs.x.com/x-api
📖
GettingStarted
https://docs.x.com/x-api/getting-started/make-your-first-request
📖
APIReference
https://docs.x.com/x-api
📖
Authentication
https://docs.x.com/resources/fundamentals/authentication
📖
RateLimits
https://docs.x.com/x-api/fundamentals/rate-limits

Specifications

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

Other Resources

🔗
SDKs
https://docs.x.com/sdks-and-tools/python-xdk
🔗
SDKs
https://docs.x.com/sdks-and-tools/typescript-xdk
🔗
GraphQL
https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/graphql/twitter-graphql.md

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/twitter-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

twitter-users-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  description: X API v2 available endpoints
  version: '2.161'
  title: X API v2 Account Activity Users API
  termsOfService: https://developer.x.com/en/developer-terms/agreement-and-policy.html
  contact:
    name: X Developers
    url: https://developer.x.com/
  license:
    name: X Developer Agreement and Policy
    url: https://developer.x.com/en/developer-terms/agreement-and-policy.html
servers:
- description: X API
  url: https://api.x.com
tags:
- name: Users
  description: Endpoints related to retrieving, managing relationships of Users
  externalDocs:
    description: Find out more
    url: https://developer.twitter.com/en/docs/twitter-api/users/lookup
paths:
  /2/lists/{id}/followers:
    get:
      security:
      - BearerToken: []
      - OAuth2UserToken:
        - list.read
        - tweet.read
        - users.read
      - UserToken: []
      tags:
      - Users
      summary: X Get List Followers
      description: Retrieves a list of Users who follow a specific List by its ID.
      externalDocs:
        url: https://developer.twitter.com/en/docs/twitter-api/users/follows/api-reference/get-users-id-followers
      operationId: getListsFollowers
      parameters:
      - name: id
        in: path
        description: The ID of the List.
        required: true
        schema:
          $ref: '#/components/schemas/ListId'
        style: simple
        example: '1234567890'
      - name: max_results
        in: query
        description: The maximum number of results.
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
          format: int32
          default: 100
        style: form
        example: 10
      - name: pagination_token
        in: query
        description: This parameter is used to get a specified 'page' of results.
        required: false
        schema:
          $ref: '#/components/schemas/PaginationTokenLong'
        style: form
        example: next_token_abc123
      - $ref: '#/components/parameters/UserFieldsParameter'
      - $ref: '#/components/parameters/UserExpansionsParameter'
      - $ref: '#/components/parameters/TweetFieldsParameter'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Get2ListsIdFollowersResponse'
        default:
          description: The request has failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /2/lists/{id}/members:
    get:
      security:
      - BearerToken: []
      - OAuth2UserToken:
        - list.read
        - tweet.read
        - users.read
      - UserToken: []
      tags:
      - Users
      summary: X Get List Members
      description: Retrieves a list of Users who are members of a specific List by its ID.
      externalDocs:
        url: https://developer.twitter.com/en/docs/twitter-api/lists/list-members/api-reference/get-users-id-list_memberships
      operationId: getListsMembers
      parameters:
      - name: id
        in: path
        description: The ID of the List.
        required: true
        schema:
          $ref: '#/components/schemas/ListId'
        style: simple
        example: '1234567890'
      - name: max_results
        in: query
        description: The maximum number of results.
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
          format: int32
          default: 100
        style: form
        example: 10
      - name: pagination_token
        in: query
        description: This parameter is used to get a specified 'page' of results.
        required: false
        schema:
          $ref: '#/components/schemas/PaginationTokenLong'
        style: form
        example: next_token_abc123
      - $ref: '#/components/parameters/UserFieldsParameter'
      - $ref: '#/components/parameters/UserExpansionsParameter'
      - $ref: '#/components/parameters/TweetFieldsParameter'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Get2ListsIdMembersResponse'
        default:
          description: The request has failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /2/tweets/{id}/liking_users:
    get:
      security:
      - OAuth2UserToken:
        - like.read
        - tweet.read
        - users.read
      - UserToken: []
      tags:
      - Users
      summary: X Get Liking Users
      description: Retrieves a list of Users who liked a specific Post by its ID.
      externalDocs:
        url: https://developer.twitter.com/en/docs/twitter-api/tweets/likes/api-reference/get-tweets-id-liking_users
      operationId: getPostsLikingUsers
      parameters:
      - name: id
        in: path
        description: A single Post ID.
        required: true
        schema:
          $ref: '#/components/schemas/TweetId'
        style: simple
        example: '1234567890'
      - name: max_results
        in: query
        description: The maximum number of results.
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
          format: int32
          default: 100
        style: form
        example: 10
      - name: pagination_token
        in: query
        description: This parameter is used to get the next 'page' of results.
        required: false
        schema:
          $ref: '#/components/schemas/PaginationToken36'
        style: form
        example: next_token_abc123
      - $ref: '#/components/parameters/UserFieldsParameter'
      - $ref: '#/components/parameters/UserExpansionsParameter'
      - $ref: '#/components/parameters/TweetFieldsParameter'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Get2TweetsIdLikingUsersResponse'
        default:
          description: The request has failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /2/tweets/{id}/retweeted_by:
    get:
      security:
      - BearerToken: []
      - OAuth2UserToken:
        - tweet.read
        - users.read
      - UserToken: []
      tags:
      - Users
      summary: X Get Reposted by
      description: Retrieves a list of Users who reposted a specific Post by its ID.
      externalDocs:
        url: https://developer.twitter.com/en/docs/twitter-api/tweets/retweets/api-reference/get-tweets-id-retweeted_by
      operationId: getPostsRepostedBy
      parameters:
      - name: id
        in: path
        description: A single Post ID.
        required: true
        schema:
          $ref: '#/components/schemas/TweetId'
        style: simple
        example: '1234567890'
      - name: max_results
        in: query
        description: The maximum number of results.
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
          format: int32
          default: 100
        style: form
        example: 10
      - name: pagination_token
        in: query
        description: This parameter is used to get the next 'page' of results.
        required: false
        schema:
          $ref: '#/components/schemas/PaginationToken36'
        style: form
        example: next_token_abc123
      - $ref: '#/components/parameters/UserFieldsParameter'
      - $ref: '#/components/parameters/UserExpansionsParameter'
      - $ref: '#/components/parameters/TweetFieldsParameter'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Get2TweetsIdRetweetedByResponse'
        default:
          description: The request has failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /2/users:
    get:
      security:
      - BearerToken: []
      - OAuth2UserToken:
        - tweet.read
        - users.read
      - UserToken: []
      tags:
      - Users
      summary: X Get Users by IDs
      description: Retrieves details of multiple Users by their IDs.
      externalDocs:
        url: https://developer.twitter.com/en/docs/twitter-api/users/lookup/api-reference/get-users
      operationId: getUsersByIds
      parameters:
      - name: ids
        in: query
        description: A list of User IDs, comma-separated. You can specify up to 100 IDs.
        required: true
        example: 2244994945,6253282,12
        schema:
          type: array
          minItems: 1
          maxItems: 100
          items:
            $ref: '#/components/schemas/UserId'
        explode: false
        style: form
      - $ref: '#/components/parameters/UserFieldsParameter'
      - $ref: '#/components/parameters/UserExpansionsParameter'
      - $ref: '#/components/parameters/TweetFieldsParameter'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Get2UsersResponse'
        default:
          description: The request has failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /2/users/by:
    get:
      security:
      - BearerToken: []
      - OAuth2UserToken:
        - tweet.read
        - users.read
      - UserToken: []
      tags:
      - Users
      summary: X Get Users by Usernames
      description: Retrieves details of multiple Users by their usernames.
      externalDocs:
        url: https://developer.twitter.com/en/docs/twitter-api/users/lookup/api-reference/get-users-by
      operationId: getUsersByUsernames
      parameters:
      - name: usernames
        in: query
        description: A list of usernames, comma-separated.
        required: true
        schema:
          type: array
          minItems: 1
          maxItems: 100
          items:
            type: string
            description: The X handle (screen name) of this User.
            pattern: ^[A-Za-z0-9_]{1,15}$
          example: TwitterDev,TwitterAPI
        explode: false
        style: form
        example: TwitterDev,TwitterAPI
      - $ref: '#/components/parameters/UserFieldsParameter'
      - $ref: '#/components/parameters/UserExpansionsParameter'
      - $ref: '#/components/parameters/TweetFieldsParameter'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Get2UsersByResponse'
        default:
          description: The request has failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /2/users/by/username/{username}:
    get:
      security:
      - BearerToken: []
      - OAuth2UserToken:
        - tweet.read
        - users.read
      - UserToken: []
      tags:
      - Users
      summary: X Get User by Username
      description: Retrieves details of a specific User by their username.
      externalDocs:
        url: https://developer.twitter.com/en/docs/twitter-api/users/lookup/api-reference/get-users-by-username-username
      operationId: getUsersByUsername
      parameters:
      - name: username
        in: path
        description: A username.
        required: true
        example: TwitterDev
        schema:
          type: string
          pattern: ^[A-Za-z0-9_]{1,15}$
        style: simple
      - $ref: '#/components/parameters/UserFieldsParameter'
      - $ref: '#/components/parameters/UserExpansionsParameter'
      - $ref: '#/components/parameters/TweetFieldsParameter'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Get2UsersByUsernameUsernameResponse'
        default:
          description: The request has failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /2/users/me:
    get:
      security:
      - OAuth2UserToken:
        - tweet.read
        - users.read
      - UserToken: []
      tags:
      - Users
      summary: X Get My User
      description: Retrieves details of the authenticated user.
      externalDocs:
        url: https://developer.twitter.com/en/docs/twitter-api/users/lookup/api-reference/get-users-me
      operationId: getUsersMe
      parameters:
      - $ref: '#/components/parameters/UserFieldsParameter'
      - $ref: '#/components/parameters/UserExpansionsParameter'
      - $ref: '#/components/parameters/TweetFieldsParameter'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Get2UsersMeResponse'
        default:
          description: The request has failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /2/users/public_keys:
    get:
      security:
      - OAuth2UserToken:
        - dm.read
        - tweet.read
        - users.read
      - UserToken: []
      tags:
      - Users
      summary: X Get Public Keys for Multiple Users
      description: Returns the public keys and Juicebox configuration for the specified users.
      externalDocs:
        url: https://developer.x.com/
      operationId: getUsersPublicKeys
      parameters:
      - name: ids
        in: query
        description: A list of User IDs, comma-separated. You can specify up to 100 IDs.
        required: true
        example: 2244994945,6253282,12
        schema:
          type: array
          minItems: 1
          maxItems: 100
          items:
            $ref: '#/components/schemas/UserId'
        explode: false
        style: form
      - $ref: '#/components/parameters/PublicKeyFieldsParameter'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Get2UsersPublicKeysResponse'
        default:
          description: The request has failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /2/users/reposts_of_me:
    get:
      security:
      - OAuth2UserToken:
        - timeline.read
        - tweet.read
      - UserToken: []
      tags:
      - Users
      summary: X Get Reposts of Me
      description: Retrieves a list of Posts that repost content from the authenticated user.
      externalDocs:
        url: https://docs.x.com/x-api/posts/retweets/quickstart/retweets-of-me#retweets-of-me
      operationId: getUsersRepostsOfMe
      parameters:
      - name: max_results
        in: query
        description: The maximum number of results.
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
          format: int32
          default: 100
        style: form
        example: 10
      - name: pagination_token
        in: query
        description: This parameter is used to get the next 'page' of results.
        required: false
        schema:
          $ref: '#/components/schemas/PaginationToken36'
        style: form
        example: next_token_abc123
      - $ref: '#/components/parameters/TweetFieldsParameter'
      - $ref: '#/components/parameters/TweetExpansionsParameter'
      - $ref: '#/components/parameters/MediaFieldsParameter'
      - $ref: '#/components/parameters/PollFieldsParameter'
      - $ref: '#/components/parameters/UserFieldsParameter'
      - $ref: '#/components/parameters/PlaceFieldsParameter'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Get2UsersRepostsOfMeResponse'
        default:
          description: The request has failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /2/users/search:
    get:
      security:
      - OAuth2UserToken:
        - tweet.read
        - users.read
      - UserToken: []
      tags:
      - Users
      summary: X Search Users
      description: Retrieves a list of Users matching a search query.
      externalDocs:
        url: https://developer.twitter.com/en/docs/twitter-api/users/lookup/api-reference/get-users-search
      operationId: searchUsers
      parameters:
      - name: query
        in: query
        description: TThe the query string by which to query for users.
        required: true
        example: someXUser
        schema:
          $ref: '#/components/schemas/UserSearchQueryVnext'
        style: form
      - name: max_results
        in: query
        description: The maximum number of results.
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 1000
          format: int32
          default: 100
        style: form
        example: 10
      - name: next_token
        in: query
        description: This parameter is used to get the next 'page' of results. The value used with the parameter is pulled directly from the response provided by the API, and should not be modified.
        required: false
        schema:
          $ref: '#/components/schemas/PaginationToken36'
        style: form
        example: next_token_abc123
      - $ref: '#/components/parameters/UserFieldsParameter'
      - $ref: '#/components/parameters/UserExpansionsParameter'
      - $ref: '#/components/parameters/TweetFieldsParameter'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Get2UsersSearchResponse'
        default:
          description: The request has failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /2/users/{id}:
    get:
      security:
      - BearerToken: []
      - OAuth2UserToken:
        - tweet.read
        - users.read
      - UserToken: []
      tags:
      - Users
      summary: X Get User by ID
      description: Retrieves details of a specific User by their ID.
      externalDocs:
        url: https://developer.twitter.com/en/docs/twitter-api/users/lookup/api-reference/get-users-id
      operationId: getUsersById
      parameters:
      - name: id
        in: path
        description: The ID of the User to lookup.
        required: true
        example: '2244994945'
        schema:
          $ref: '#/components/schemas/UserId'
        style: simple
      - $ref: '#/components/parameters/UserFieldsParameter'
      - $ref: '#/components/parameters/UserExpansionsParameter'
      - $ref: '#/components/parameters/TweetFieldsParameter'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Get2UsersIdResponse'
        default:
          description: The request has failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /2/users/{id}/affiliates:
    get:
      security:
      - BearerToken: []
      - OAuth2UserToken:
        - tweet.read
        - users.read
      - UserToken: []
      tags:
      - Users
      summary: X Get Affiliates
      description: Retrieves a list of Users who are affiliated with a specific organization User by their ID.
      externalDocs:
        url: https://developer.twitter.com/en/docs/twitter-api/users/affiliates/api-reference/get-users-id-affiliates
      operationId: getUsersAffiliates
      parameters:
      - name: id
        in: path
        description: The ID of the User to lookup.
        required: true
        example: '2244994945'
        schema:
          $ref: '#/components/schemas/UserId'
        style: simple
      - name: max_results
        in: query
        description: The maximum number of results.
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 1000
          format: int32
        style: form
        example: 10
      - name: pagination_token
        in: query
        description: This parameter is used to get a specified 'page' of results.
        required: false
        schema:
          $ref: '#/components/schemas/PaginationTokenLong'
        style: form
        example: next_token_abc123
      - $ref: '#/components/parameters/UserFieldsParameter'
      - $ref: '#/components/parameters/UserExpansionsParameter'
      - $ref: '#/components/parameters/TweetFieldsParameter'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Get2UsersIdAffiliatesResponse'
        default:
          description: The request has failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /2/users/{id}/blocking:
    get:
      security:
      - OAuth2UserToken:
        - block.read
        - tweet.read
        - users.read
      - UserToken: []
      tags:
      - Users
      summary: X Get Blocking
      description: Retrieves a list of Users blocked by the specified User ID.
      externalDocs:
        url: https://developer.twitter.com/en/docs/twitter-api/users/blocks/api-reference/get-users-blocking
      operationId: getUsersBlocking
      parameters:
      - name: id
        in: path
        description: The ID of the authenticated source User for whom to return results.
        required: true
        schema:
          $ref: '#/components/schemas/UserIdMatchesAuthenticatedUser'
        style: simple
        example: '1234567890'
      - name: max_results
        in: query
        description: The maximum number of results.
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 1000
          format: int32
        style: form
        example: 10
      - name: pagination_token
        in: query
        description: This parameter is used to get a specified 'page' of results.
        required: false
        schema:
          $ref: '#/components/schemas/PaginationToken32'
        style: form
        example: next_token_abc123
      - $ref: '#/components/parameters/UserFieldsParameter'
      - $ref: '#/components/parameters/UserExpansionsParameter'
      - $ref: '#/components/parameters/TweetFieldsParameter'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Get2UsersIdBlockingResponse'
        default:
          description: The request has failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /2/users/{id}/bookmarks:
    get:
      security:
      - OAuth2UserToken:
        - bookmark.read
        - tweet.read
        - users.read
      tags:
      - Users
      summary: X Get Bookmarks
      description: Retrieves a list of Posts bookmarked by the authenticated user.
      externalDocs:
        url: https://developer.twitter.com/en/docs/twitter-api/tweets/bookmarks/api-reference/get-users-id-bookmarks
      operationId: getUsersBookmarks
      parameters:
      - name: id
        in: path
        description: The ID of the authenticated source User for whom to return results.
        required: true
        schema:
          $ref: '#/components/schemas/UserIdMatchesAuthenticatedUser'
        style: simple
        example: '1234567890'
      - name: max_results
        in: query
        description: The maximum number of results.
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
          format: int32
        style: form
        example: 10
      - name: pagination_token
        in: query
        description: This parameter is used to get the next 'page' of results.
        required: false
        schema:
          $ref: '#/components/schemas/PaginationToken36'
        style: form
        example: next_token_abc123
      - $ref: '#/components/parameters/TweetFieldsParameter'
      - $ref: '#/components/parameters/TweetExpansionsParameter'
      - $ref: '#/components/parameters/MediaFieldsParameter'
      - $ref: '#/components/parameters/PollFieldsParameter'
      - $ref: '#/components/parameters/UserFieldsParameter'
      - $ref: '#/components/parameters/PlaceFieldsParameter'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Get2UsersIdBookmarksResponse'
        default:
          description: The request has failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    post:
      security:
      - OAuth2UserToken:
        - bookmark.write
        - tweet.read
        - users.read
      tags:
      - Users
      summary: X Create Bookmark
      description: Adds a post to the authenticated user’s bookmarks.
      externalDocs:
        url: https://developer.twitter.com/en/docs/twitter-api/tweets/bookmarks/api-reference/post-users-id-bookmarks
      operationId: createUsersBookmark
      parameters:
      - name: id
        in: path
        description: The ID of the authenticated source User for whom to add bookmarks.
        required: true
        schema:
          $ref: '#/components/schemas/UserIdMatchesAuthenticatedUser'
        style: simple
        example: '1234567890'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BookmarkAddRequest'
        required: true
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BookmarkMutationResponse'
        default:
          description: The request has failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /2/users/{id}/bookmarks/folders:
    get:
      security:
      - OAuth2UserToken:
        - bookmark.read
        - users.read
      tags:
      - Users
      summary: X Get Bookmark Folders
      description: Retrieves a list of Bookmark folders created by the authenticated user.
      externalDocs:
        url: https://developer.x.com
      operationId: getUsersBookmarkFolders
      parameters:
      - name: id
        in: path
        description: The ID of the authenticated source User for whom to return results.
        required: true
        schema:
          $ref: '#/components/schemas/UserIdMatchesAuthenticatedUser'
        style: simple
        example: '1234567890'
      - name: max_results
        in: query
        description: The maximum number of results.
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
          format: int32
        style: form
        example: 10
      - name: pagination_token
        in: query
        description: This parameter is used to get the next 'page' of results.
        required: false
        schema:
          $ref: '#/components/schemas/PaginationToken36'
        style: form
        example: next_token_abc123
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BookmarkFoldersResponse'
        default:
          description: The request has failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /2/users/{id}/bookmarks/folders/{folder_id}:
    get:
      security:
      - OAuth2UserToken:
        - bookmark.read
        - tweet.read
        - users.read
      tags:
      - Users
      summary: X Get Bookmarks by Folder ID
      description: Retrieves Posts in a specific Bookmark folder by its ID for the authenticated user.
      externalDocs:
        url: https://developer.x.com
      operationId: getUsersBookmarksByFolderId
      parameters:
      - name: id
        in: path
        description: The ID of the authenticated source User for whom to return results.
        required: true
        schema:
          $ref: '#/components/schemas/UserIdMatchesAuthenticatedUser'
        style: simple
        example: '1234567890'
      - name: folder_id
        in: p

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