---
title: "Twexapi 문서"
description: "검색, 프로필, 팔로워, AI 에이전트를 위한 공개 소셜 API. REST, SDK, CLI, MCP — 요청당 과금."
---

## TwexAPI란

TwexAPI는 서드파티 공개 소셜 API입니다. 게시물 검색, 프로필 조회, 팔로워 내보내기를 앱, 스크립트, AI 에이전트에서 사용할 수 있습니다.

하나의 API 키로 인증합니다. 에이전트는 [MCP](/mcp/overview)로 연결하고, 앱은 [REST](/api-reference/overview) 또는 [SDK](/sdks)를 사용합니다.

[Advance Search TwitterXAPI](https://x-advanced-search.cc)에서 검색 쿼리를 만든 뒤 [Advanced Twitter Search](/api-reference/search-endpoints/get-data-page-twitter-advanced-search-page-post)로 전달합니다.

### AI 코딩 에이전트 연결

:::tip
  **Cursor**, **Claude Code**, **GitHub Copilot**, **ChatGPT**, **Cline**, **Windsurf**, **Codex**, **Gemini CLI**, **Continue**, **Roo Code** 등에 TwexAPI skill을 설치하세요. 에이전트가 엔드포인트를 찾지 않고 검색·프로필 조회를 할 수 있습니다. 설정: [integrations hub](https://twexapi.io/integrations).
:::

```bash
npx skills add twexapi-dev/x-api-scraper-cli
```

경로가 아니라 결과를 요청하세요 — 예: *"이 트윗의 답글 가져오기"*, *"이 계정의 팔로워 내보내기"*.

### 핵심 수치

- **지연 시간**: 평균 약 900ms
- **처리량**: 클라이언트당 최대 초당 100요청
- **가용성**: 99.9% uptime 목표
- **요금**: 요청당 $0.000050부터, 사용량 기준 — [Rate Limits](/guides/rate-limits) 및 [대시보드](https://twexapi.io/dashboard) 참고

실패한 호출도 공정하게 과금됩니다. 공개 문서는 API 키 읽기에 초점을 둡니다.

## 구축 가능한 기능

<CardGroup cols={2}>
  <Card title="검색" icon="search" href="/api-reference/search-endpoints/get-data-page-twitter-advanced-search-page-post">
    키워드, 해시태그, 연산자 검색. x-advanced-search.cc에서 `searchTerms` 생성.
  </Card>
  <Card title="프로필 및 관계" icon="users" href="/api-reference/followers-following-endpoints/followers-v3-api-v3-twitter-users-followers-post">
    사용자 조회, 팔로워·팔로잉 내보내기, cursor 페이지네이션.
  </Card>
  <Card title="Timelines and tweets" icon="file-text" href="/api-reference/overview">
    User timelines, tweet detail, threads, replies, and quotes.
  </Card>
  <Card title="MCP 및 에이전트" icon="bot" href="/mcp/overview">
    Cursor, Claude, LangChain, n8n에서 `explore` 후 `twexapi_request`.
  </Card>
  <Card title="SDK 및 CLI" icon="box" href="/sdks">
    TypeScript, Python, Go, Java 및 공개 읽기용 CLI.
  </Card>
  <Card title="성장 서비스" icon="stars" href="/api-reference/tweet-engagement-endpoints/get-favoriters-api-endpoint-twitter-tweets-favoriters-post">
    동일한 API 키로 이용할 수 있는 추가 인게이지먼트 서비스.
  </Card>
</CardGroup>

---

## 시작하기

1. **API 키 발급**

    [대시보드](https://twexapi.io/dashboard)에서 키를 생성합니다.

2. **인증**

    `Authorization: Bearer YOUR_API_KEY` 헤더를 전송합니다. 자세한 내용: [Authentication](/authentication).

3. **엔드포인트 호출**

    [API Overview](/api-reference/overview) 또는 [Advanced Twitter Search](/api-reference/search-endpoints/get-data-page-twitter-advanced-search-page-post)부터 시작합니다.