What is Stagehand?
Browserbase's TypeScript framework for building reliable web-automation agents with natural-language page actions. Use Scavio to find the right pages before handing off to Stagehand.
Searching X (Twitter) with Stagehand
This integration lets your Stagehand 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
npm install @browserbasehq/stagehandCode Example
Here is a complete Stagehand agent that searches X (Twitter) using Scavio:
// Generic HTTP integration for Stagehand
// 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 Stagehand
// 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 Stagehand integration. Paid plans start at $30/month for higher volumes.