Skip to main content
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

DetailValue
Base URLhttps://api.goperigon.com/v1/
AuthAPI key via apiKey query param, x-api-key header, or Authorization: Bearer {key}
Rate limitsPlan-dependent (Starter: 100 req/day, Pro: 10K/day, Enterprise: custom)
Key endpoints/all, /stories/all, /people/all, /sources/all
Mavera basehttps://app.mavera.io/api/v1
Mavera authAuthorization: Bearer mvra_live_...
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

1

Perigon API key

Sign up at goperigon.com and copy your API key from the dashboard.
2

Choose your plan

Starter (100 req/day) is sufficient for testing. Pro and Enterprise plans unlock stories clustering, entity endpoints, and higher throughput.
3

Mavera API key

Get your key from Mavera dashboard.
4

Environment variables

export PERIGON_API_KEY="your-perigon-key"
export MAVERA_API_KEY="mvra_live_xxxxx"

​
Jobs

#JobPerigon DataMavera SurfaceOutput
1Story Clustering → Content Calendar/stories/allMave Agent + GenerateThemed content calendar
2Entity-Based Competitive Intelligence/all (entity filter)Mave Agent (Chat)Entity-level competitor analysis
3AI Summary → News Digest with Personas/all (with summaries)Personas + SpeakPersona-voiced weekly digest
4Geographic News → Market-Specific Messaging/all (geo filter)Focus Groups + GenerateLocalized campaign copy

​
Rate Limits & Production Notes

Perigon EndpointStarterProStrategy
/all100 req/day10K req/dayCache results by topic+date
/stories/all100 req/day (shared)10K req/dayOne call per topic per run
/people/all, /sources/allShared poolShared poolCache source lists daily
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.

All Integrations

Perigon API Docs

Personas

Focus Groups

Mave Agent

Generate