Pydantic AI + Google Ads Transparency

What is Pydantic AI?

Type-safe agent framework from the Pydantic team. Schema-first tool calling with typed dependencies and streaming support.

Searching Google Ads Transparency with Pydantic AI

This integration lets your Pydantic AI agent search Google Ads Transparency in real time via the Scavio API. The agent gets back structured JSON with advertiser_id and region_code, total_ads range, creative_id and preview URLs, first_shown, last_shown, days_shown -- ready for reasoning and decision-making.

Setup

pip install pydantic-ai

Code Example

Here is a complete Pydantic AI agent that searches Google Ads Transparency using Scavio:

# Generic HTTP integration for Pydantic AI
# Point your framework's HTTP request tool at:
#
#   POST https://api.scavio.dev/api/v1/googleads/advertisers
#   Authorization: Bearer sk_live_your_key
#   Content-Type: application/json
#   {"query":"your search query"}
#
# Rows come back under data.suggestions.

Full Working Example

A production-ready example with error handling:

# Generic HTTP integration for Pydantic AI
# Point your framework's HTTP request tool at:
#
#   POST https://api.scavio.dev/api/v1/googleads/advertisers
#   Authorization: Bearer sk_live_your_key
#   Content-Type: application/json
#   {"query":"your search query"}
#
# Rows come back under data.suggestions.

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 Pydantic AI integration. Paid plans start from $24/mo billed yearly for higher volumes.