bldinit Twitter Rest API
The twitter-rest API from bldinit — 7 operation(s) for twitter-rest.
The twitter-rest API from bldinit — 7 operation(s) for twitter-rest.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/mcpweave-com:mcpweave-com-twitter-rest-api"
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.
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: 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)