NewsAPI

4 production-ready jobs — persona-analyzed industry digests, competitor news monitoring with Mave synthesis, breaking news rapid content generation, and batch news sentiment tracking

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

Detail	Value
Base URL	https://newsapi.org/v2/
Auth	API key via X-Api-Key header
Rate limits	Free: 100 req/day; Business: 250,000 req/month
Key endpoints	/top-headlines, /everything, /sources
Mavera base	https://app.mavera.io/api/v1
Mavera auth	Authorization: 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

#	Job	NewsAPI Data	Mavera Surface	Output
1	Industry News → Persona-Analyzed Digest	/top-headlines	Personas + Speak	Multi-persona news analysis
2	Competitor News Monitoring	/everything	Mave Agent (Chat)	Competitive intelligence brief
3	Breaking News → Rapid Content	/top-headlines	Generate	Trend-aligned content pieces
4	News Sentiment Tracking	/everything	Mave Agent (Chat batch)	Weekly sentiment dashboard

---

Rate Limits & Production Notes

NewsAPI Endpoint	Free Limit	Business Limit	Strategy
/top-headlines	100 req/day total	250K req/month	Cache results; poll hourly max
/everything	100 req/day total	250K req/month	Batch by date range; deduplicate
/sources	100 req/day total	250K req/month	Cache 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