Signals via API

Public sample from today's flagship detail endpoint. Public payloads can be limited or redacted. The backend exposes read endpoints for signals, storylines, and briefings.

GET /v1/narratives/e7755bfc-0c75-40ef-ad60-9471340a828b?tenant=geopolitics&run_id=82da45eb-61e7-46f1-9514-444bb2f05acc

{
  "id": "e7755bfc-0c75-40ef-ad60-9471340a828b",
  "title": "Ansarallah extend gains in Yemen's Taiz",
  "summary": "Yemen's Ansarallah made fresh territorial gains in the southwestern province of Taiz on Sunday, pressing its advance as the Saudi-backed government in Yemen announced the start of a large-scale military campaign to retake what it called the remaining Ansarallah-held areas.",
  "first_seen_at": "2026-10-04T12:32:24.020312Z",
  "last_seen_at": "2026-10-05T15:21:54Z",
  "created_at": "2026-10-05T05:06:40.357151Z",
  "updated_at": "2026-10-05T17:05:22.002719Z",
  "timeframe": "24h",
  "run_id": "82da45eb-61e7-46f1-9514-444bb2f05acc",
  "metrics": {
    "divergence": 31.5374,
    "post_count": 8,
    "momentum_1h": 0,
    "momentum_7d": 8,
    "score_total": 1.86496,
    "shill_score": 11.25,
    "momentum_24h": 8,
    "market_movers": [],
    "evidence_score": 1,
    "unique_authors": 6,
    "coherence_score": 0.735,
    "diversity_bonus": 0.25,
    "duplicate_ratio": 0,
    "platforms_count": 1,
    "social_momentum": 8,
    "divergence_label": "chatter_without_pricing",
    "market_conviction": 0,
    "origin_share_top1": 0.25,
    "unique_publishers": 5,
    "origin_layer_posts": 0,
    "source_types_count": 1,
    "unique_authors_24h": 6,
    "unique_origin_urls": 8,
    "amplifier_share_top1": 0.25,
    "author_concentration": 0.375,
    "publisher_share_top1": 0.25,
    "amplifier_layer_posts": 8,
    "concentration_penalty": 0,
    "unique_origin_domains": 5,
    "source_diversity_bonus": 0,
    "unique_publisher_types": 2,
    "unique_origin_publishers": 5,
    "quality_policy_version": 6,
    "tenant_claim_coherence_policy_version": 3
  },
  "platforms": [
    "rss"
  ],
  "top_tickers": [],
  "why_now": [],
  "display_title": "Yemen government launches offensive as Saudi-led coalition provides air support",
  "display_summary": "Yemen’s government has launched a major operation to reclaim Houthi-held territory, backed by a Saudi-led coalition air campaign. The move comes as Houthis reportedly expand their gains in Taiz and pressure government-held areas, pointing to a renewed escalation across Yemen’s fragmented front lines.",
  "narrative_frame_display": "Yemen’s internationally recognised government has announced a broad campaign to retake Houthi-held territory, while Saudi-led coalition aircraft provide air support. The escalation follows reported Houthi gains around Taiz and raises the immediate prospect of intensified fighting across multiple fronts, including areas near the Red Sea coastline and Bab al-Mandab.",
  "entities": {
    "projects": [
      "Operation Dawn of Yemen"
    ],
    "people": [
      "Rashad al-Alimi",
      "Turki al-Maliki"
    ]
  },
  "recurring_claims": [
    {
      "claim": "Yemen’s government announced a military operation to retake territory held by the Houthis.",
      "evidence_urls": [
        "https://theguardian.com/world/2026/oct/05/saudi-backed-yemen-government-military-drive-retake-houthi-territory",
        "https://aljazeera.com/video/newsfeed/2026/10/5/yemen-govt-forces-commence-major-combat-operation-against-houthis?traffic_source=rss"
      ]
    },
    {
      "claim": "The Saudi-led coalition said it was providing air support for government forces in a broad campaign against Houthi targets.",
      "evidence_urls": [
        "https://theguardian.com/world/2026/oct/05/yemen-air-campaign-houthis-saudi-led-coalition",
        "https://jpost.com/middle-east/article-910640"
      ]
    },
    {
      "claim": "The offensive follows reported Houthi territorial gains in Taiz and around a government-held city.",
      "evidence_urls": [
        "https://tehrantimes.com/news/530750/Ansarallah-extend-gains-in-Yemen-s-Taiz",
        "https://theguardian.com/world/2026/oct/05/saudi-backed-yemen-government-military-drive-retake-houthi-territory"
      ]
    }
  ],
  "stance_map": [
    {
      "stance": "promotes",
      "who": "Yemeni government",
      "evidence_urls": [
        "https://theguardian.com/world/2026/oct/05/saudi-backed-yemen-government-military-drive-retake-houthi-territory",
        "https://france24.com/en/middle-east/20261005-yemen-military-announces-broad-range-of-strikes-against-houthis-in-bid-to-retake-lost-territory"
      ]
    },
    {
      "stance": "promotes",
      "who": "Saudi-led coalition",
      "evidence_urls": [
        "https://theguardian.com/world/2026/oct/05/yemen-air-campaign-houthis-saudi-led-coalition",
        "https://jpost.com/middle-east/article-910640"
      ]
    },
    {
      "stance": "neutral",
      "who": "Houthi/Ansarallah forces",
      "evidence_urls": [
        "https://tehrantimes.com/news/530750/Ansarallah-extend-gains-in-Yemen-s-Taiz",
        "https://jpost.com/middle-east/article-910654"
      ]
    }
  ],
  "quality_flags": {
    "mixed_topic_risk": "low",
    "promo_risk": "low",
    "source_quality": "medium"
  },
  "editor_note": "Reports describe a coordinated Yemeni government offensive with Saudi-led coalition air support, amid Houthi advances around Taiz.",
  "display_tags": [
    "geopolitics",
    "yemen",
    "military_escalation",
    "saudi_arabia",
    "iran",
    "red_sea_shipping"
  ],
  "tags": [
    "geopolitics",
    "yemen",
    "military_escalation",
    "saudi_arabia",
    "iran",
    "red_sea_shipping"
  ],
  "cscope_tags": [
    "geopolitics",
    "yemen",
    "military_escalation",
    "saudi_arabia",
    "iran",
    "red_sea_shipping"
  ],
  "why_now_display": [
    "The government announced the operation after reported Houthi advances around Taiz.",
    "The coalition said an air campaign involving 100 fighter jets was under way.",
    "Government forces claim battlefield gains as the offensive unfolds."
  ],
  "why_it_matters_display": [
    "The offensive could widen fighting across Yemen’s disconnected front lines.",
    "Coalition air support links Yemen’s battlefield escalation to Saudi regional security interests.",
    "Reported activity near the Red Sea and Bab al-Mandab has implications for a major shipping route."
  ],
  "show_why": true,
  "sources_display": [
    {
      "url": "https://theguardian.com/world/2026/oct/05/yemen-air-campaign-houthis-saudi-led-coalition",
      "label": "The Guardian: coalition air campaign",
      "published_at": "2026-10-05T15:21:54+00:00"
    },
    {
      "url": "https://france24.com/en/middle-east/20261005-yemen-military-announces-broad-range-of-strikes-against-houthis-in-bid-to-retake-lost-territory",
      "label": "France 24: announced strikes",
      "published_at": "2026-10-05T08:12:54+00:00"
    },
    {
      "url": "https://jpost.com/middle-east/article-910654",
      "label": "Jpost (via Jerusalem Post Middle East): Will Yemen's massive new anti-Houthi offensive succeed in bid to reclaim lost territory? - analysis",
      "published_at": "2026-10-05T11:03:33.054221+00:00"
    },
    {
      "url": "https://aljazeera.com/news/2026/10/5/yemen-war-escalates-whats-the-latest-on-the-battlefield?traffic_source=rss",
      "label": "Aljazeera: Yemen war escalates: What’s the latest, as government forces claim gains?",
      "published_at": "2026-10-05T09:38:26+00:00"
    },
    {
      "url": "https://tehrantimes.com/news/530750/Ansarallah-extend-gains-in-Yemen-s-Taiz",
      "label": "Tehrantimes: Ansarallah extend gains in Yemen's Taiz",
      "published_at": "2026-10-04T17:05:38+00:00"
    }
  ],
  "trend_status": "flat",
  "trend_sparkline": "▁█",
  "trend_points_n": 0,
  "trend_window": {
    "lookback_days": 14,
    "max_points": 36,
    "value_key": null
  },
  "llm_status": "accepted",
  "llm_meta": {
    "model": "gpt-5.6-luna",
    "prompt_version": "enrich_v3",
    "input_hash": "f04f75f4ee70fc3eee1c623b0262ad0f901cce8c154b6b7e58e82d8e8329d5ee",
    "updated_at": "2026-10-05T17:07:44.173112+00:00",
    "llm_metadata": {
      "env": "prod",
      "host": "83bc069ed062",
      "stage": "signals.enrich",
      "run_id": "82da45eb-61e7-46f1-9514-444bb2f05acc",
      "tenant": "geopolitics",
      "service": "api",
      "pipeline": "pipeline_run",
      "correlation_id": "e7755bfc-0c75-40ef-ad60-9471340a828b"
    }
  },
  "story_id": "ddbcbfc5-40ee-4634-9d76-5015aa694f49",
  "sourceStats": {
    "qualityPolicyVersion": 6,
    "evidenceDocumentCount": 8,
    "uniqueItemCount": 8,
    "uniquePublisherCount": 5,
    "uniqueCanonicalOriginCount": 5,
    "independentNonSocialCount": 5,
    "primaryCount": 0,
    "secondaryCount": 5,
    "uniqueDomainsCount": 5,
    "aggregatorCount": 0,
    "socialCount": 0,
    "sourceTypeDiversityCount": 1,
    "topSourceShare": 0.25,
    "passesTopSignalsGate": true,
    "gateReason": "independentNonSocial=5; primary=0; secondary=5; documents=8; publishers=5; canonicalOrigins=5; topSourceShare=0.25; rule=>=2 unique canonical primary/secondary publishers; aggregators/social excluded"
  },
  "gate": {
    "passesTopSignalsGate": true,
    "gateReason": "independentNonSocial=5; primary=0; secondary=5; documents=8; publishers=5; canonicalOrigins=5; topSourceShare=0.25; rule=>=2 unique canonical primary/secondary publishers; aggregators/social excluded"
  },
  "public_surface": {
    "eligible_for_flagship_sample": true,
    "eligible_for_top_public_brief": true,
    "eligible_for_public_index": false,
    "eligible_only_for_lower_or_internal_surfaces": false,
    "public_rank_score": 12,
    "structural_priority": true,
    "mostly_social": false,
    "community_chatter": false,
    "reader_label": null,
    "excluded_reasons": [],
    "source_signals": {
      "post_count": 8,
      "unique_origins": 5,
      "source_types_count": 1,
      "independent_non_social_count": 5,
      "social_source_count": 0,
      "non_social_source_count": 0,
      "why_now_count": 3,
      "why_it_matters_count": 3
    },
    "content_quality_ready": true
  },
  "current_cycle_open": true
}

• Signals and storylines feed endpoints with filtering and rate limits
• Briefing delivery endpoints for integrations
• Evidence link payloads for auditability

• Route top stories into Slack or Teams for morning and evening desk updates.
• Sync storyline evidence into Notion, Airtable, or internal research trackers.
• Feed metrics into BI dashboards for momentum, concentration, and source mix monitoring.

Quick start endpoints: /v1/feed/stories, /v1/signals, /v1/storylines/search, /v1/briefings/latest.

For product access, see Pricing.