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.
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.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 (5K/mo, 1M reads). Rate limits: Recent search 60 req/15 min (Basic), 300 req/15 min (Pro).Prerequisites
X Developer account
Apply at developer.x.com. Upgrade to at least Basic for read access.
Create project and app
In the Developer Portal, create a project and app. Generate a Bearer Token for app-only auth.
Mavera API key
Get your key from Mavera dashboard.
Jobs
| # | Job | X Data | Mavera Surface | Output |
|---|---|---|---|---|
| 1 | Brand Mention Sentiment Pipeline | /tweets/search/recent | Mave Agent (Chat) | Sentiment + topic classification |
| 2 | Trending Topic → Content Sprint | /trends/by/woeid | Mave Agent + Generate | Relevant trend content briefs |
| 3 | Competitor Tweet Analysis | /users//tweets | Mave Agent (Chat) | Posting strategy breakdown |
| 4 | Reply Mining for Persona Development | Quote tweets + mentions | Mave Agent + Personas | Persona profiles from reply patterns |
| 5 | Thread → Blog Post Generation | 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 |