Pydantic AI + X (Twitter)

What is Pydantic AI?

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

Searching X (Twitter) with Pydantic AI

This integration lets your Pydantic AI agent search X (Twitter) in real time via the Scavio API. The agent gets back structured JSON with post snippets, author handles, timestamps, engagement signals — ready for reasoning and decision-making.

Setup

pip install pydantic-ai

Code Example

Here is a complete Pydantic AI agent that searches X (Twitter) using Scavio:

# Generic HTTP integration for Pydantic AI
# Use your framework's HTTP request tool to call:
# POST https://api.scavio.dev/api/v1/search
# Header: x-api-key: your_scavio_api_key
# Body: {"query": "your search query"}

Full Working Example

A production-ready example with error handling:

# Generic HTTP integration for Pydantic AI
# Use your framework's HTTP request tool to call:
# POST https://api.scavio.dev/api/v1/search
# Header: x-api-key: your_scavio_api_key
# Body: {"query": "your search query"}

Pricing

Scavio offers a free tier with 500 credits/month (1 credit per search). No credit card required. This is enough to build and test your Pydantic AI integration. Paid plans start at $30/month for higher volumes.