Perigon is a full-stack news intelligence API that goes beyond raw articles — it provides clustered stories, entity extraction, AI summaries, and geographic tagging out of the box. These four jobs leverage Perigon’s structured news data with Mavera’s surfaces (Mave Agent, Personas, Focus Groups, Generate) to build content calendars from story clusters, extract entity-level competitive intelligence, create persona-voiced news digests, and localize messaging by geography.
API Reference Card
All examples use PERIGON_API_KEY for Perigon and MAVERA_API_KEY for Mavera. Perigon supports three auth methods — examples use the apiKey query parameter for simplicity. Switch to header-based auth for production.
Prerequisites
Perigon API key
Sign up at
goperigon.com and copy your API key from the dashboard.
Choose your plan
Starter (100 req/day) is sufficient for testing. Pro and Enterprise plans unlock stories clustering, entity endpoints, and higher throughput.
Jobs
Rate Limits & Production Notes
Perigon rate limits are plan-dependent. The jobs above use 1-6 Perigon calls each — safe on Starter for daily runs, comfortable on Pro for hourly. Use header-based auth (x-api-key) in production to avoid API keys in URLs. Store credentials in env vars. Deduplicate articles by articleId when combining multiple queries. Monitor Mavera credits at Dashboard.
