What is Mastra?
TypeScript framework for building AI agents, workflows, and RAG pipelines with first-class tool calling and MCP support.
Searching X (Twitter) with Mastra
This integration lets your Mastra agent search X (Twitter) in real time via the Scavio API. The agent gets back structured JSON with post text, author handles, created_at timestamps, favorites, retweets, replies, quotes -- ready for reasoning and decision-making.
Setup
Bash
npm install @mastra/coreCode Example
Here is a complete Mastra agent that searches X (Twitter) using Scavio:
// Generic HTTP integration for Mastra
// Point your framework's HTTP request tool at:
//
// POST https://api.scavio.dev/api/v1/x/search
// Authorization: Bearer sk_live_your_key
// Content-Type: application/json
// {"search":"your search query","search_type":"Latest"}
//
// Rows come back under data.timeline.
//
// X takes search (not query). search_type is one of Top, Latest, People, Photos, Videos.
Full Working Example
A production-ready example with error handling:
// Generic HTTP integration for Mastra
// Point your framework's HTTP request tool at:
//
// POST https://api.scavio.dev/api/v1/x/search
// Authorization: Bearer sk_live_your_key
// Content-Type: application/json
// {"search":"your search query","search_type":"Latest"}
//
// Rows come back under data.timeline.
//
// X takes search (not query). search_type is one of Top, Latest, People, Photos, Videos.
Pricing
Scavio offers a free tier with 50 credits on signup (1 credit per search). No credit card required. This is enough to build and test your Mastra integration. Paid plans start at $30/month for higher volumes.