Skip to main content

​
Overview

The News API provides AI-powered news intelligence — trending stories, persona-based analysis, and scheduled digests. Stay informed about industry trends and understand how different audiences perceive news events.

​
Key Features

Trending Stories

Real-time trending news across topics

Persona Analysis

Understand news from different audience perspectives

Story Chat

Ask questions about any news story

Personalized Feed

News tailored to your interests
import requests

response = requests.get(
    "https://app.mavera.io/api/v1/news/stories/trending",
    headers={"Authorization": "Bearer mvra_live_your_key_here"},
    params={"topics": "technology,ai", "limit": 10}
)

stories = response.json()["data"]
for story in stories:
    print(f"{story['title']}")
    print(f"  Source: {story['source']}")
    print(f"  Published: {story['published_at']}")

​
Analyze a Story

Get AI analysis of a story from persona perspectives: 
response = requests.post(
    f"https://app.mavera.io/api/v1/news/stories/{story_id}/analyze",
    headers={"Authorization": "Bearer mvra_live_your_key_here"},
    json={
        "persona_ids": ["gen_z_consumer_id", "b2b_executive_id"]
    }
)

analysis = response.json()
for perspective in analysis["perspectives"]:
    print(f"{perspective['persona_name']}:")
    print(f"  Sentiment: {perspective['sentiment']}")
    print(f"  Key Takeaway: {perspective['key_takeaway']}")

​
Chat About a Story

response = requests.post(
    f"https://app.mavera.io/api/v1/news/stories/{story_id}/chat",
    headers={"Authorization": "Bearer mvra_live_your_key_here"},
    json={
        "message": "How might this news affect consumer behavior?",
        "persona_id": "millennial_consumer_id"
    }
)

​
Personalized Feed

response = requests.get(
    "https://app.mavera.io/api/v1/news/stories/personalized",
    headers={"Authorization": "Bearer mvra_live_your_key_here"},
    params={
        "topics": "marketing,ecommerce",
        "limit": 20
    }
)

API Reference

See the full API specification