---
seo:
  description: >-
    TwexAPI는 https://api.twexapi.io에서 X/Twitter 데이터 조회, 고급 트윗 검색, 프로필 및 팔로워
    내보내기, 트윗 작성 및 인터랙션, DM 송수신, X 아티클 처리 및 AI…
sidebar:
  label: Overview
title: TwexAPI REST API 레퍼런스
---
TwexAPI는 `https://api.twexapi.io`에서 X/Twitter 데이터 조회, 고급 트윗 검색, 프로필 및 팔로워 내보내기, 트윗 작성 및 인터랙션, DM 송수신, X 아티클 처리 및 AI Agent 연동을 위한 표준 REST API를 제공합니다.

**주요 핵심 기능:**
* **고급 트윗 검색 (Search)** — 키워드, 해시태그, 캐시태그 및 시간대별 상세 검색
* **트윗 및 인게이지먼트 (Tweets)** — 전체 스레드 조회, 트윗 상세 정보, 답글 목록, 좋아요/리트윗 사용자 추출
* **사용자 및 소셜 그래프 (Users)** — 프로필 조회, 다중 사용자 일괄 조회, 커서 기반 대규모 팔로워/팔로잉 내보내기
* **작성 및 인터랙션 액션 (Tweet Actions)** — 트윗 작성, 답글, 스레드 일괄 발행, 좋아요, 리트윗, 북마크, 팔로우
* **쪽지 관리 (DM)** — 1:1 쪽지 전송, 권한 확인, 대화 목록 및 채팅 히스토리 조회
* **글로벌 트렌드 (Trending)** — 국가 및 지역별 실시간 트렌드 트윗 및 화제 토픽
* **X 아티클 (Articles)** — X 장문 아티클을 깔끔한 Markdown으로 추출 (LLM RAG 파이프라인에 최적), 초안 작성 및 즉시 발행

모든 엔드포인트는 통일된 응답 구조(`code: 200`, `msg: "success"`, `data`)를 반환합니다. 자세한 내용은 [에러 처리 가이드](/ko/guides/error-handling)를 참조하세요.

## 인증 (Authentication)

모든 API 요청 헤더에 API 키를 포함해야 합니다:

```txt
Authorization: Bearer YOUR_API_KEY
```

작성 및 인터랙션 액션에는 Twitter 쿠키 또는 `auth_token`이 추가로 필요합니다. 자세한 내용은 [인증 가이드](/ko/authentication)를 참조하세요.

<ApiOverview source="ko-api-reference" />

## Cookie Endpoints

<ApiTagOperations source="ko-api-reference" tag="cookie-endpoints" />

## Search Endpoints

<ApiTagOperations source="ko-api-reference" tag="search-endpoints" />

## Tweet Actions Endpoints

<ApiTagOperations source="ko-api-reference" tag="tweet-actions-endpoints" />

## Users Endpoints

<ApiTagOperations source="ko-api-reference" tag="users-endpoints" />

## Followers & Following Endpoints

<ApiTagOperations source="ko-api-reference" tag="followers-following-endpoints" />

## Tweet Replies Endpoints

<ApiTagOperations source="ko-api-reference" tag="tweet-replies-endpoints" />

## DM Endpoints

<ApiTagOperations source="ko-api-reference" tag="dm-endpoints" />

## Article Endpoints

<ApiTagOperations source="ko-api-reference" tag="article-endpoints" />

## Tweets Endpoints

<ApiTagOperations source="ko-api-reference" tag="tweets-endpoints" />

## Grok Endpoints

<ApiTagOperations source="ko-api-reference" tag="grok-endpoints" />

## Tweet Engagement Endpoints

<ApiTagOperations source="ko-api-reference" tag="tweet-engagement-endpoints" />

## Lists Endpoints

<ApiTagOperations source="ko-api-reference" tag="lists-endpoints" />

## Communities Endpoints

<ApiTagOperations source="ko-api-reference" tag="communities-endpoints" />

## Twitter Profile Actions Endpoints

<ApiTagOperations source="ko-api-reference" tag="twitter-profile-actions-endpoints" />

## Trending Endpoints

<ApiTagOperations source="ko-api-reference" tag="trending-endpoints" />

## Timeline Endpoints

<ApiTagOperations source="ko-api-reference" tag="timeline-endpoints" />

## All Tweets Replies Endpoints

<ApiTagOperations source="ko-api-reference" tag="all-tweets-replies-endpoints" />

## Twitter Account Based in Endpoints

<ApiTagOperations source="ko-api-reference" tag="twitter-account-based-in-endpoints" />

## Twitter User About Endpoints

<ApiTagOperations source="ko-api-reference" tag="twitter-user-about-endpoints" />

## Balance Endpoints

<ApiTagOperations source="ko-api-reference" tag="balance-endpoints" />