Skip to main content
GET
/
news
/
stories
/
personalized
cURL
curl "https://app.mavera.io/api/v1/news/stories/personalized?persona_ids=persona-id-1,persona-id-2" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "object": "list",
  "data": [
    {
      "id": "<string>",
      "name": "<string>",
      "summary": "<string>",
      "short_summary": "<string>",
      "image_url": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "article_count": 123,
      "unique_sources": 123,
      "sentiment": {
        "positive": 123,
        "negative": 123,
        "neutral": 123
      },
      "categories": [
        "<string>"
      ],
      "topics": [
        "<string>"
      ],
      "key_points": [
        "<string>"
      ]
    }
  ],
  "personalization": {
    "personas": [
      {
        "id": "<string>",
        "name": "<string>",
        "category": "<string>"
      }
    ],
    "keywords": [
      "<string>"
    ]
  }
}

Authorizations

​
Authorization
string
header
required

API key prefixed with mvra_live_. Create keys at Settings > Developer > API Keys.

Query Parameters

​
persona_ids
string
required

Comma-separated Mavera persona IDs

​
size
integer
default:15

Number of stories (max 50)

Required range: x <= 50

Response

List of personalized news stories

​
object
enum<string>
Available options:
list
​
data
object[]
​
personalization
object

Details about the personalization applied