> ## Documentation Index > Fetch the complete documentation index at: https://www.worldmonitor.app/docs/llms.txt > Use this file to discover all available pages before exploring further. # ListFeedDigest > ListFeedDigest returns a pre-aggregated digest of all RSS feeds for a site variant. ## OpenAPI ````yaml /api/NewsService.openapi.yaml get /api/news/v1/list-feed-digest openapi: 3.1.0 info: title: NewsService API version: 1.0.0 servers: - url: https://api.worldmonitor.app security: - WorldMonitorKey: [] - ApiKeyHeader: [] paths: /api/news/v1/list-feed-digest: get: tags: - NewsService summary: ListFeedDigest description: >- ListFeedDigest returns a pre-aggregated digest of all RSS feeds for a site variant. operationId: ListFeedDigest parameters: - name: variant in: query description: >- Digest variant: full, tech, finance, happy, commodity. Unsupported site variants, including energy, currently fall back to full. required: false example: example schema: type: string - name: lang in: query description: ISO 639-1 language code (en, fr, ar, etc.) required: false example: en schema: type: string - name: jmespath in: query description: >- Optional JMESPath expression applied server-side to project or reduce the JSON response before it is returned (mirrors the MCP jmespath argument). Invalid expressions, expressions larger than 1024 UTF-8 bytes, or projections that exceed the 256 KB output cap return HTTP 400 with a {_jmespath_error, original_keys} envelope. Grammar and worked examples: https://www.worldmonitor.app/docs/mcp-jmespath. required: false example: keys(@) schema: type: string responses: '200': description: Successful response content: application/json: example: categories: exampleKey: items: - corroborationCount: 42 importanceScore: 42 isAlert: true link: https://example.com/worldmonitor location: latitude: 40.7128 longitude: -74.006 source: example title: example feedStatuses: exampleKey: example generatedAt: '2026-01-15T12:00:00Z' schema: $ref: '#/components/schemas/ListFeedDigestResponse' '400': description: Validation error content: application/json: schema: oneOf: - $ref: '#/components/schemas/ValidationError' - $ref: '#/components/schemas/JmespathProjectionError' '401': description: Missing or invalid API key. content: application/json: schema: $ref: '#/components/schemas/UnauthorizedError' '403': description: >- API access requires an active subscription (the API key's subscription is inactive or expired). content: application/json: schema: $ref: '#/components/schemas/ForbiddenError' '429': description: Rate limit exceeded. headers: X-RateLimit-Limit: description: Maximum requests allowed in the active rate-limit window. schema: type: string X-RateLimit-Remaining: description: Requests remaining in the active rate-limit window. schema: type: string X-RateLimit-Reset: description: >- Unix epoch milliseconds when the active rate-limit window resets. schema: type: string Retry-After: description: Seconds to wait before retrying the request. schema: type: string content: application/json: schema: oneOf: - $ref: '#/components/schemas/Error' - $ref: '#/components/schemas/RateLimitError' default: description: Gateway or handler error response. content: application/json: schema: oneOf: - $ref: '#/components/schemas/Error' - $ref: '#/components/schemas/GatewayError' components: schemas: ListFeedDigestResponse: type: object properties: categories: type: object additionalProperties: $ref: '#/components/schemas/CategoryBucket' description: Per-category buckets — keys match category names from feed config feedStatuses: type: object additionalProperties: type: string description: |- Per-feed status — only non-ok states emitted; absent key implies ok. Values: empty (feed returned 0 items), timeout (timed out during fetch), all-undated (every parsed item lacked a usable date), partial-undated (some parsed items lacked a usable date). generatedAt: type: string description: ISO 8601 timestamp of when this digest was generated ValidationError: type: object properties: violations: type: array items: $ref: '#/components/schemas/FieldViolation' description: List of validation violations required: - violations description: >- ValidationError is returned when request validation fails. It contains a list of field violations describing what went wrong. JmespathProjectionError: description: >- Returned when a REST jmespath projection is invalid or exceeds the expression/output byte limits. properties: _jmespath_error: description: Projection error discriminator and details. type: string original_keys: description: Top-level keys or shape of the unprojected response. items: type: string type: array required: - _jmespath_error - original_keys type: object UnauthorizedError: type: object properties: error: type: string description: Human-readable error message. required: - error description: >- Returned when the API key is missing, malformed, or lacks current API access. ForbiddenError: type: object properties: error: type: string description: Human-readable entitlement failure reason. requiredTier: type: integer format: int32 description: Minimum entitlement tier required for this endpoint. currentTier: type: integer format: int32 description: Caller entitlement tier when known. planKey: type: string description: Caller plan key when known. required: - error description: >- Returned when a PRO-gated endpoint denies access because the caller has no resolved authenticated user, entitlements cannot be verified, or the caller lacks the required entitlement tier. Error: type: object properties: message: type: string description: Error message (e.g., 'user not found', 'database connection failed') description: >- Error is returned when a handler encounters an error. It contains a simple error message that the developer can customize. RateLimitError: type: object description: Returned when a gateway or handler rate limit rejects the request. properties: error: type: string description: Human-readable rate-limit failure reason. required: - error GatewayError: type: object description: >- Returned by gateway infrastructure errors before an RPC handler runs, such as origin, routing, method, authentication, or quota checks. properties: error: oneOf: - type: string - type: object additionalProperties: true description: Gateway error reason or structured gateway failure details. required: - error CategoryBucket: type: object properties: items: type: array items: $ref: '#/components/schemas/NewsItem' FieldViolation: type: object properties: field: type: string description: >- The field path that failed validation (e.g., 'user.email' for nested fields). For header validation, this will be the header name (e.g., 'X-API-Key') description: type: string description: >- Human-readable description of the validation violation (e.g., 'must be a valid email address', 'required field missing') required: - field - description description: FieldViolation describes a single validation error for a specific field. NewsItem: type: object properties: source: type: string minLength: 1 description: Source feed name. title: type: string minLength: 1 description: Article headline. link: type: string description: Article URL. publishedAt: type: integer format: int64 description: >- Publication time, as Unix epoch milliseconds.. Warning: Values > 2^53 may lose precision in JavaScript isAlert: type: boolean description: Whether this article triggered an alert condition. threat: $ref: '#/components/schemas/ThreatClassification' location: $ref: '#/components/schemas/GeoCoordinates' locationName: type: string description: Human-readable location name. importanceScore: type: integer format: int32 description: >- Composite importance score. The base 0-100 score uses severity × 55% + source tier × 20% + corroboration × 15% + recency × 10%, then may add an 18-point diplomacy/flashpoint boost and 4 points per entity-level corroborating source, capped at five sources. The final score can exceed 100; with current boosts it is approximately capped at 138. corroborationCount: type: integer format: int32 description: >- Number of distinct sources that reported the same story in this digest cycle. "Same story" is determined by edit-tolerant story-identity clustering (headlines describing one event with different wording, ordering, source suffixes, truncation, or morphology corroborate each other) — not exact-title matching. See shared/story-identity.js. storyMeta: $ref: '#/components/schemas/StoryMeta' snippet: type: string description: |- Cleaned article description from the RSS/Atom / / / tag: HTML-stripped, entity-decoded, whitespace-normalised, clipped to 400 chars. Empty string when unavailable or indistinguishable from the headline — consumers must fall back to the headline for display/LLM grounding in that case. tickers: type: array items: type: string maxItems: 8 description: >- Equity ticker symbols mentioned by the story, extracted at ingest from cashtags ($AAPL) and the curated company dictionary (shared/stocks.json). Uppercase symbols, deduplicated, capped at 8. Empty when no tracked ticker is mentioned. See shared/ticker-extract.js. maxItems: 8 required: - source - title description: NewsItem represents a single news article from RSS feed aggregation. ThreatClassification: type: object properties: level: type: string enum: - THREAT_LEVEL_UNSPECIFIED - THREAT_LEVEL_LOW - THREAT_LEVEL_MEDIUM - THREAT_LEVEL_HIGH - THREAT_LEVEL_CRITICAL description: ThreatLevel represents the assessed threat level of a news event. category: type: string description: Event category. confidence: type: number maximum: 1 minimum: 0 format: double description: Confidence score (0.0 to 1.0). source: type: string description: >- Classification source — "keyword", "keyword-historical-downgrade", or "llm". description: >- ThreatClassification represents an AI-assessed threat level for a news item. GeoCoordinates: type: object properties: latitude: type: number maximum: 90 minimum: -90 format: double description: Latitude in decimal degrees (-90 to 90). longitude: type: number maximum: 180 minimum: -180 format: double description: Longitude in decimal degrees (-180 to 180). description: GeoCoordinates represents a geographic location using WGS84 coordinates. StoryMeta: type: object properties: firstSeen: type: integer format: int64 description: >- Epoch ms when the story first appeared in any digest cycle.. Warning: Values > 2^53 may lose precision in JavaScript mentionCount: type: integer format: int32 description: Total number of digest cycles in which this story appeared. sourceCount: type: integer format: int32 description: |- Number of unique sources reporting this story in the CURRENT digest cycle (batch corroboration from fuzzy story clustering, #4919; defaults to 1 for unclustered items). The cross-cycle Redis source set (story:sources:v1) feeds importance scoring, not this field. phase: type: string enum: - STORY_PHASE_UNSPECIFIED - STORY_PHASE_BREAKING - STORY_PHASE_DEVELOPING - STORY_PHASE_SUSTAINED - STORY_PHASE_FADING description: StoryPhase represents the lifecycle stage of a tracked news story. description: >- StoryMeta carries cross-cycle persistence data attached to each news item. securitySchemes: WorldMonitorKey: type: apiKey in: header name: X-WorldMonitor-Key description: User-issued WorldMonitor API key. ApiKeyHeader: type: apiKey in: header name: X-Api-Key description: Alias header for the WorldMonitor API key (X-WorldMonitor-Key). ````