> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mavera.io/llms.txt
> Use this file to discover all available pages before exploring further.

# X / Twitter

> 5 production-ready jobs — brand mention sentiment pipelines, trending topic content sprints, competitor tweet analysis, reply mining for persona development, and thread-to-blog-post generation

## Overview

X (formerly Twitter) is real-time public opinion at scale — every brand mention, trending topic, and reply thread is a signal most marketing teams glance at in a dashboard and never use. These five jobs pull tweet data through the X API v2 into Mavera's surfaces (Mave Agent, Generate, Personas, Brand Voice) to classify sentiment, turn trends into content briefs, reverse-engineer competitor strategies, build personas from reply patterns, and convert viral threads into blog posts.

<Info>
  **X API v2** — Base URL: `https://api.x.com/2/`. Auth: OAuth 2.0 with PKCE (user context) or App-Only Bearer token. Pricing: Free (write-only), **Basic** ($200/mo, 10K reads), **Pro** ($5K/mo, 1M reads). Rate limits: Recent search 60 req/15 min (Basic), 300 req/15 min (Pro).
</Info>

***

## Prerequisites

<Steps>
  <Step title="X Developer account">Apply at [developer.x.com](https://developer.x.com/). Upgrade to at least **Basic** for read access.</Step>
  <Step title="Create project and app">In the Developer Portal, create a project and app. Generate a Bearer Token for app-only auth.</Step>
  <Step title="Mavera API key">Get your key from [Mavera dashboard](https://app.mavera.io/settings/api-keys).</Step>
  <Step title="Environment variables">`export X_BEARER_TOKEN="AAAAAAAAAAAAAxxxxxxx..."` and `export MAVERA_API_KEY="mvra_live_xxxxx"`</Step>
</Steps>

***

## Jobs

| # | Job                                                                                   | X Data                  | Mavera Surface                     | Output                               |
| - | ------------------------------------------------------------------------------------- | ----------------------- | ---------------------------------- | ------------------------------------ |
| 1 | [Brand Mention Sentiment Pipeline](/integrations/x-twitter/brand-mention-sentiment)   | /tweets/search/recent   | Mave Agent (Chat)                  | Sentiment + topic classification     |
| 2 | [Trending Topic → Content Sprint](/integrations/x-twitter/trending-content-sprint)    | /trends/by/woeid        | Mave Agent + Generate              | Relevant trend content briefs        |
| 3 | [Competitor Tweet Analysis](/integrations/x-twitter/competitor-tweet-analysis)        | /users/{id}/tweets      | Mave Agent (Chat)                  | Posting strategy breakdown           |
| 4 | [Reply Mining for Persona Development](/integrations/x-twitter/reply-mining-personas) | Quote tweets + mentions | Mave Agent + Personas              | Persona profiles from reply patterns |
| 5 | [Thread → Blog Post Generation](/integrations/x-twitter/thread-to-blog)               | Thread tweets           | Generate (Blog Post) + Brand Voice | Long-form blog post                  |

***

## Rate Limits & Production Notes

| X Endpoint    | Basic (\$200/mo) | Pro (\$5K/mo)  |
| ------------- | ---------------- | -------------- |
| Recent search | 60 req/15 min    | 300 req/15 min |
| User tweets   | 15 req/15 min    | 75 req/15 min  |
| Monthly reads | 10,000           | 1,000,000      |

<Warning>
  **Free** is write-only. **Basic** ($200/mo) gives 10K reads — enough for daily sentiment + 2 weekly competitor analyses. **Pro** ($5K/mo) for heavy usage. All code respects `x-rate-limit-reset`. Store Bearer token in env vars. Cache locally. Monitor Mavera credits at [Dashboard](https://app.mavera.io/settings/usage).
</Warning>

***

<CardGroup cols={3}>
  <Card title="All Integrations" icon="plug" href="/integrations" />

  <Card title="X API Docs" icon="x-twitter" href="https://developer.x.com/en/docs/twitter-api" />

  <Card title="Brand Voice" icon="microphone" href="/features/brand-voice" />

  <Card title="Mave Agent" icon="brain" href="/features/mave-agent" />

  <Card title="Personas" icon="user" href="/features/personas" />
</CardGroup>