What is Mastra?
TypeScript framework for building AI agents, workflows, and RAG pipelines with first-class tool calling and MCP support.
Searching Google Ads Transparency with Mastra
This integration lets your Mastra 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
Bash
npm install @mastra/coreCode Example
Here is a complete Mastra agent that searches Google Ads Transparency using Scavio:
// Generic HTTP integration for Mastra
// 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 Mastra
// 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 Mastra integration. Paid plans start at $30/month for higher volumes.