> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mavera.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 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_...`          |

<Info>
  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.
</Info>

***

## Prerequisites

<Steps>
  <Step title="NewsAPI key">Register at [newsapi.org](https://newsapi.org/register) and copy your API key from the dashboard.</Step>
  <Step title="Choose your plan">Free tier returns 100 requests/day with truncated content. Business tier provides full article bodies and higher limits.</Step>
  <Step title="Mavera API key">Get your key from [Mavera dashboard](https://app.mavera.io/settings/api-keys).</Step>

  <Step title="Environment variables">
    ```bash theme={"dark"}
    export NEWSAPI_KEY="your-newsapi-key"
    export MAVERA_API_KEY="mvra_live_xxxxx"
    ```
  </Step>
</Steps>

***

## Jobs

| # | Job                                                                | NewsAPI Data   | Mavera Surface          | Output                         |
| - | ------------------------------------------------------------------ | -------------- | ----------------------- | ------------------------------ |
| 1 | [Industry News → Persona-Analyzed Digest](persona-analyzed-digest) | /top-headlines | Personas + Speak        | Multi-persona news analysis    |
| 2 | [Competitor News Monitoring](competitor-monitoring)                | /everything    | Mave Agent (Chat)       | Competitive intelligence brief |
| 3 | [Breaking News → Rapid Content](breaking-news-content)             | /top-headlines | Generate                | Trend-aligned content pieces   |
| 4 | [News Sentiment Tracking](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          |

<Warning>
  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](https://app.mavera.io/settings/usage).
</Warning>

***

<CardGroup cols={3}>
  <Card title="All Integrations" icon="plug" href="/integrations" />

  <Card title="NewsAPI Docs" icon="newspaper" href="https://newsapi.org/docs" />

  <Card title="Personas" icon="user" href="/features/personas" />

  <Card title="Mave Agent" icon="brain" href="/features/mave-agent" />

  <Card title="Generate" icon="pen" href="/features/generate" />

  <Card title="Brand Voice" icon="microphone" href="/features/brand-voice" />
</CardGroup>