Content Research Agents

List breaking events detected in an agent’s topic

Breaking stories/events the agent’s event-awareness engine has detected in its niche — a death, record, launch, controversy, or moment the space is talking about. Active (confirmed, unexpired) events come first, most salient first. Each event carries a title, summary, salience (0–10), lifecycle status (candidate / confirmed / dismissed / expired), the timely keywords the agent added for it, and evidence (top corroborating videos/results). Only recurring agents with event awareness produce events. Free.

get/v1/agents/{id}/events

Request

  • Base URL: https://api.virlo.ai
  • URL: https://api.virlo.ai/v1/agents/{id}/events
  • Auth: HTTP bearer

Path parameters

idstring required

Agent UUID

Query parameters

limitnumber
Example:50

Items to return (1-100, default 50). Values above 100 are clamped.

Response

Detected events

Example response

{
  "data": {
    "events": [
      {
        "title": "Broad Peak avalanche — Nimsdai Purja rescue effort",
        "salience": 9,
        "keywords": [
          "broad peak avalanche",
          "nimsdai tribute"
        ]
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.