bldinit Twitter Rest API

The twitter-rest API from bldinit — 7 operation(s) for twitter-rest.

GitHub OpenAPI

Operations 8

GET /api/v1/twitter/users/me 내 프로필 (Free tier OK) #
POST /api/v1/twitter/tweets 트윗 작성 (★ irreversible — Free tier 1500/월) #
GET /api/v1/twitter/tweets/{tweet_id} 트윗 detail (Basic tier 필요) #
DELETE /api/v1/twitter/tweets/{tweet_id} 트윗 삭제 (★ irreversible) #
GET /api/v1/twitter/users/{user_id}/tweets 사용자의 트윗 list (Basic tier 필요) #
GET /api/v1/twitter/tweets/search/recent 최근 7일 트윗 검색 (Basic tier 필요) #
POST /api/v1/twitter/users/{user_id}/likes 트윗 좋아요 (Free tier OK) #
GET /api/v1/twitter/users/by/username/{username} 사용자 프로필 by username (Basic tier 필요) #

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/mcpweave-com:mcpweave-com-twitter-rest-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

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

OpenAPI Specification

mcpweave-com-twitter-rest-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: mcpweave Twitter Rest API
  description: Asia-native MCP Gateway — Native pass-through, FastMCP, Paddle+Toss billing
  version: '2026-04-27'
tags:
- name: twitter-rest
paths:
  /api/v1/twitter/users/me:
    get:
      tags:
      - twitter-rest
      summary: 내 프로필 (Free tier OK)
      description: 'OAuth 인증된 사용자의 프로필. Free tier 에서도 사용 가능.


        ``user.fields``: id, name, username, public_metrics (followers/following/tweet_count/listed),

        profile_image_url, verified, created_at, description.


        Native pass-through.'
      operationId: twitter_get_me
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/twitter/tweets:
    post:
      tags:
      - twitter-rest
      summary: 트윗 작성 (★ irreversible — Free tier 1500/월)
      description: '새 트윗 작성. Free tier 사용 가능 (1500/월 한도).


        **Irreversible (ADR-028/030 Cat A — 외부 도달)**: 게시 후 모든 follower

        + 공개 viewers 노출. mcpweave 가 ``twitter_delete_tweet`` 으로 삭제 가능

        하지만 캐시 / retweet / quote 흔적 회수 불가.


        ``reply.in_reply_to_tweet_id`` = 답글, ``quote_tweet_id`` = 인용,

        ``poll`` = 투표 작성, ``media.media_ids`` = 첨부 (별도 upload 필요 — Phase 2).


        Native pass-through.'
      operationId: twitter_post_tweet
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: confirmation_token
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 'ADR-030: required for irreversible op. First call returns token.'
          title: Confirmation Token
        description: 'ADR-030: required for irreversible op. First call returns token.'
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/twitter/tweets/{tweet_id}:
    get:
      tags:
      - twitter-rest
      summary: 트윗 detail (Basic tier 필요)
      description: '``tweet_id`` 의 트윗 detail. **Free tier read 사실상 불가** — Basic tier 부터.


        ``tweet.fields``: created_at, public_metrics (likes/retweets/replies/quotes),

        author_id, conversation_id, lang, possibly_sensitive.


        Native pass-through.'
      operationId: twitter_get_tweet
      parameters:
      - name: tweet_id
        in: path
        required: true
        schema:
          type: string
          title: Tweet Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
    delete:
      tags:
      - twitter-rest
      summary: 트윗 삭제 (★ irreversible)
      description: 'bot 이 작성한 트윗 삭제. Free tier 사용 가능.


        **Irreversible (ADR-028/030 Cat B — 영구 삭제)**: API 삭제 후 복구 불가

        (Twitter 측 archive X). client 가 첫 호출 시 ``confirmation_token`` 발급.


        Native pass-through.'
      operationId: twitter_delete_tweet
      parameters:
      - name: tweet_id
        in: path
        required: true
        schema:
          type: string
          title: Tweet Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: confirmation_token
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 'ADR-030: required for irreversible op. First call returns token.'
          title: Confirmation Token
        description: 'ADR-030: required for irreversible op. First call returns token.'
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/twitter/users/{user_id}/tweets:
    get:
      tags:
      - twitter-rest
      summary: 사용자의 트윗 list (Basic tier 필요)
      description: '``user_id`` 가 작성한 트윗 list. ``user_id=me`` 는 지원 X — 먼저

        ``twitter_get_me`` 로 own user_id 조회 후 사용.


        **Basic tier 부터 사용 가능** (Free tier read 사실상 X).


        Pagination: ``pagination_token``.


        Native pass-through.'
      operationId: twitter_list_my_tweets
      parameters:
      - name: user_id
        in: path
        required: true
        schema:
          type: string
          title: User Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: max_results
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Max Results
      - name: pagination_token
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Pagination Token
      - name: exclude
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Exclude
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/twitter/tweets/search/recent:
    get:
      tags:
      - twitter-rest
      summary: 최근 7일 트윗 검색 (Basic tier 필요)
      description: '``query`` 로 최근 7일 트윗 검색. **Basic tier 부터** (Free tier 검색 1

        req/월 수준 = 사실상 X).


        Query 문법: https://developer.x.com/en/docs/x-api/tweets/search/integrate/build-a-query

        예시: ``"mcpweave -is:retweet"`` / ``from:elonmusk lang:en``.


        Pagination: ``next_token``.


        Native pass-through.'
      operationId: twitter_search_recent
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: query
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Query
      - name: max_results
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Max Results
      - name: next_token
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Next Token
      - name: start_time
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Start Time
      - name: end_time
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: End Time
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/twitter/users/{user_id}/likes:
    post:
      tags:
      - twitter-rest
      summary: 트윗 좋아요 (Free tier OK)
      description: '``user_id`` 가 ``tweet_id`` 트윗에 좋아요. Free tier 사용 가능.


        Recoverable — DELETE /users/{user_id}/likes/{tweet_id} 로 unlike 가능.

        irreversible 아님.


        Native pass-through.'
      operationId: twitter_like_tweet
      parameters:
      - name: user_id
        in: path
        required: true
        schema:
          type: string
          title: User Id
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/twitter/users/by/username/{username}:
    get:
      tags:
      - twitter-rest
      summary: 사용자 프로필 by username (Basic tier 필요)
      description: '``username`` (without @) 으로 사용자 프로필 조회.


        **Basic tier 부터 사용 가능** (Free tier read 사실상 X).


        Native pass-through.'
      operationId: twitter_get_user
      parameters:
      - name: username
        in: path
        required: true
        schema:
          type: string
          title: Username
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)