Skip to main content
NewsAPI delivers structured access to 150,000+ news sources worldwide — headlines, full articles, and search results across every vertical. These four jobs pull headlines and articles into Mavera’s surfaces (Personas, Mave Agent, Generate, Chat) to create persona-analyzed digests, monitor competitors through the lens of brand strategy, turn breaking news into rapid content, and track sentiment shifts in batch.

​
API Reference Card

DetailValue
Base URLhttps://newsapi.org/v2/
AuthAPI key via X-Api-Key header
Rate limitsFree: 100 req/day; Business: 250,000 req/month
Key endpoints/top-headlines, /everything, /sources
Mavera basehttps://app.mavera.io/api/v1
Mavera authAuthorization: Bearer mvra_live_...
All examples use NEWSAPI_KEY for NewsAPI and MAVERA_API_KEY for Mavera. Free-tier keys return truncated article content (200 chars). Business keys return full content. All code respects daily rate limits by caching results locally.

​
Prerequisites

1

NewsAPI key

Register at newsapi.org and copy your API key from the dashboard.
2

Choose your plan

Free tier returns 100 requests/day with truncated content. Business tier provides full article bodies and higher limits.
3

Mavera API key

Get your key from Mavera dashboard.
4

Environment variables

export NEWSAPI_KEY="your-newsapi-key"
export MAVERA_API_KEY="mvra_live_xxxxx"

​
Jobs

#JobNewsAPI DataMavera SurfaceOutput
1Industry News → Persona-Analyzed Digest/top-headlinesPersonas + SpeakMulti-persona news analysis
2Competitor News Monitoring/everythingMave Agent (Chat)Competitive intelligence brief
3Breaking News → Rapid Content/top-headlinesGenerateTrend-aligned content pieces
4News Sentiment Tracking/everythingMave Agent (Chat batch)Weekly sentiment dashboard

​
Rate Limits & Production Notes

NewsAPI EndpointFree LimitBusiness LimitStrategy
/top-headlines100 req/day total250K req/monthCache results; poll hourly max
/everything100 req/day total250K req/monthBatch by date range; deduplicate
/sources100 req/day total250K req/monthCache source list daily
Free-tier keys share the 100 req/day limit across all endpoints. The jobs above use 1-6 NewsAPI calls each — run at most one job per hour on free tier. Business keys have generous limits but still require pagination for large result sets. Store credentials in env vars. Cache responses to disk. Monitor Mavera credits at Dashboard.

All Integrations

NewsAPI Docs

Personas

Mave Agent

Generate

Brand Voice