API 개요

TwexAPI REST 참조 — 인증, 응답 형식, 페이지네이션, 오류, 속도 제한, 엔드포인트 그룹.

TwexAPI는 https://api.twexapi.io에서 X/Twitter 읽기·쓰기, 검색, 팔로워, DM, 리스트, 커뮤니티, 아티클, 계정 유틸리티용 REST API를 제공합니다.

사이드바의 개별 엔드포인트 페이지를 열기 전에 이 페이지를 시작점으로 사용하세요.

Base URL

https://api.twexapi.io

인증

모든 요청에 API 키를 전송합니다:

Authorization: Bearer YOUR_API_KEY

Public docs focus on API-key reads.

응답 형식

성공 응답은 일관된 래퍼를 사용합니다:

{
  "code": 200,
  "msg": "success",
  "data": {}
}

오류는 JSON 본문과 함께 non-2xx HTTP 상태 코드를 반환합니다. 상태별 복구는 Error Handling 참고.

페이지네이션

많은 목록·검색 엔드포인트는 data 안에 has_next_page, next_cursor 또는 페이지 토큰 같은 cursor 필드를 반환합니다. 이전 응답의 cursor를 그대로 다음 요청에 전달하세요. 실패 후 재개해야 하는 작업은 채팅·워크플로 메모리 밖에 cursor를 보관하세요.

잔액 확인

대규모 내보내기 전에 남은 크레dit을 확인합니다:

curl --request GET \
  --url 'https://api.twexapi.io/balance' \
  --header 'Authorization: Bearer YOUR_API_KEY'

전체 스키마는 Get Balance 참고.

엔드포인트 그룹

사이드바 Endpoints에서 생성된 페이지를 탐색하거나 일반 그룹으로 이동합니다:

그룹	일반적인 작업
Search	키워드 검색, 해시태그, 캐시태그. Advance Search TwitterXAPI로 `searchTerms` 구성.
Users	프로필 조회, 일괄 사용자 읽기
Followers & Following	팔로워·팔로잉 내보내기
Tweet Actions	게시, 답글, 좋아요, 리트윗, 북마크
Trending	글로벌 트렌드 주제·트윗
DM	DM 상태, 발송, 기록
Balance	크레dit 잔액

에이전트 및 SDK 경로

통합	사용 시점
MCP Server	`twexapi_request` 전에 `explore`로 경로를 찾아야 하는 AI 에이전트
SDKs	재시도·페이지네이션 헬퍼가 있는 타입 클라이언트
CLI	터미널 스크립트 및 JSON 출력
Framework Guides	LangChain, CrewAI, n8n, Prefect 등 에이전트 호스트

운영 가이드

Error Handling — HTTP 상태 복구, MCP 오류, 쓰기 재시도
Rate Limits — 처리량 가이드 및 429 백오프
— cookie / auth_token, 중복 확인, 403 크레dit
Authentication — API 키, Bearer 헤더, 쓰기 자격 증명

TwexAPI가 현재 제공하지 않는 것

TwexAPI는 네이티브 계정 모니터, 이벤트 webhook, 비동기 추출 작업을 일급 API 제품으로 제공하지 않습니다. 예약 REST 호출(Prefect, n8n, cron) 또는 no-code 플랫폼 webhook으로 에이전트 핸드오프를 받은 뒤 직접 API 요청을 이어가세요.