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 Google Ads Transparency with Stagehand
This integration lets your Stagehand agent search Google Ads Transparency in real time via the Scavio API. The agent gets back structured JSON with top_ads, bottom_ads, ad headlines, destination URLs -- ready for reasoning and decision-making.
Setup
npm install @browserbasehq/stagehandCode Example
Here is a complete Stagehand agent that searches Google Ads Transparency using Scavio:
// Generic HTTP integration for Stagehand
// Point your framework's HTTP request tool at:
//
// POST https://api.scavio.dev/api/v2/google
// Authorization: Bearer sk_live_your_key
// Content-Type: application/json
// {"query":"your search query"}
//
// Rows come back under organic_results.
//
// Scavio has no Ads Transparency endpoint. This searches the public Ads Transparency Center pages through Google, which returns pages about the advertiser rather than the ad creatives themselves. For live ad copy on a keyword, read the top_ads and bottom_ads blocks of a POST /api/v2/google response instead.
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/v2/google
// Authorization: Bearer sk_live_your_key
// Content-Type: application/json
// {"query":"your search query"}
//
// Rows come back under organic_results.
//
// Scavio has no Ads Transparency endpoint. This searches the public Ads Transparency Center pages through Google, which returns pages about the advertiser rather than the ad creatives themselves. For live ad copy on a keyword, read the top_ads and bottom_ads blocks of a POST /api/v2/google response instead.
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.