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/654dbdb5-56ef-442c-891d-6bd9afcbbef8?tenant=geopolitics&run_id=4f1fbca2-802d-4cca-81f8-62fd3e410901

{
  "id": "654dbdb5-56ef-442c-891d-6bd9afcbbef8",
  "title": "US releases footage of strikes on Iran",
  "summary": "US Central Command says it attacked military targets in Iran and at sea.",
  "first_seen_at": "2026-07-12T17:45:25Z",
  "last_seen_at": "2026-07-13T13:03:00Z",
  "created_at": "2026-07-13T17:14:07.433936Z",
  "updated_at": "2026-07-14T05:15:31.636501Z",
  "timeframe": "24h",
  "run_id": "4f1fbca2-802d-4cca-81f8-62fd3e410901",
  "metrics": {
    "divergence": 1.578,
    "post_count": 3,
    "momentum_1h": 0,
    "momentum_7d": 3,
    "score_total": 1.13859,
    "shill_score": 20,
    "momentum_24h": 3,
    "market_movers": [],
    "evidence_score": 0.75,
    "unique_authors": 2,
    "coherence_score": 0.7041,
    "diversity_bonus": 0.1625,
    "duplicate_ratio": 0,
    "platforms_count": 1,
    "social_momentum": 3,
    "divergence_label": "chatter_without_pricing",
    "market_conviction": 0,
    "origin_share_top1": 0.333333,
    "unique_publishers": 3,
    "origin_layer_posts": 0,
    "source_types_count": 1,
    "unique_authors_24h": 2,
    "unique_origin_urls": 3,
    "amplifier_share_top1": 0.333333,
    "author_concentration": 0.6667,
    "publisher_share_top1": 0.333333,
    "amplifier_layer_posts": 3,
    "concentration_penalty": 0,
    "unique_origin_domains": 3,
    "source_diversity_bonus": 0,
    "unique_publisher_types": 1,
    "unique_origin_publishers": 3
  },
  "platforms": [
    "rss"
  ],
  "top_tickers": [],
  "why_now": [],
  "display_title": "US Central Command conducts multiple strikes on Iran including drone boat attack",
  "display_summary": "The US Central Command has carried out a series of precision strikes against multiple military targets in Iran and at sea. Among these was a first-of-its-kind attack using three Corsair unmanned surface vessels to strike an Iranian ship facility.",
  "narrative_frame_display": "In a significant escalation, US Central Command completed a new wave of offensive strikes against Iran, hitting dozens of targets at multiple locations with precision munitions. This operation included a novel tactic involving three Corsair unmanned surface vessels striking an Iranian ship facility, marking the first use of drone boats in such an attack. The US released footage of these strikes, underscoring the military's enhanced capabilities and strategic intent in the region.",
  "entities": {
    "projects": [
      "Corsair"
    ]
  },
  "recurring_claims": [
    {
      "claim": "US Central Command conducted precision strikes against multiple Iranian military targets.",
      "evidence_urls": [
        "https://war.gov/News/News-Stories/Article/Article/4541171/centcom-completes-another-wave-of-strikes-against-iran",
        "https://bbc.co.uk/news/videos/c8628y50508o?at_campaign=rss&at_medium=RSS"
      ]
    },
    {
      "claim": "US used three Corsair unmanned surface vessels to strike an Iranian ship facility in a first-of-its-kind attack.",
      "evidence_urls": [
        "https://aljazeera.com/video/newsfeed/2026/7/13/us-strikes-iranian-ship-with-drone-boats-in-first-of-its-kind-attack?traffic_source=rss"
      ]
    }
  ],
  "stance_map": [
    {
      "stance": "neutral",
      "who": "U.S. Central Command Public Affairs",
      "evidence_urls": [
        "https://war.gov/News/News-Stories/Article/Article/4541171/centcom-completes-another-wave-of-strikes-against-iran"
      ]
    }
  ],
  "quality_flags": {
    "mixed_topic_risk": "low",
    "promo_risk": "low",
    "source_quality": "high"
  },
  "editor_note": null,
  "display_tags": [
    "military",
    "geopolitics"
  ],
  "tags": [
    "military",
    "geopolitics"
  ],
  "cscope_tags": [
    "military",
    "geopolitics"
  ],
  "why_now_display": [
    "Recent strikes indicate heightened US military activity in the Middle East.",
    "First-of-its-kind drone boat attack signals new tactics in naval warfare.",
    "Public release of footage underscores strategic messaging by US Central Command."
  ],
  "why_it_matters_display": [
    "Demonstrates US military's advanced precision strike capabilities including unmanned surface vessels.",
    "Marks escalation in US-Iran tensions with new attack methods.",
    "Highlights evolving military technology impacting regional security dynamics."
  ],
  "show_why": true,
  "sources_display": [
    {
      "label": "war.gov: U.S. Department of Defense News"
    },
    {
      "label": "France24 Middle East: Middle East War: Iran claims strikes on US bases in multiple countries"
    },
    {
      "label": "Jerusalem Post Middle East: Explosions heard around Iran's Bandar Abbas, Qeshm Island in Strait of Hormuz - report"
    },
    {
      "label": "Al Jazeera All News: New Iran strikes on Gulf as US attacks escalate: What we know"
    },
    {
      "label": "Al Jazeera All News: US and Iran trade strikes as ceasefire comes under growing strain"
    }
  ],
  "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-4.1-mini-2025-04-14",
    "prompt_version": "enrich_v3",
    "input_hash": "62da09f94712ef5276a207abe09e9adc69905a88c9b35b5eab5b573636def8a5",
    "updated_at": "2026-07-14T05:18:43.284202+00:00",
    "llm_metadata": {
      "env": "prod",
      "host": "3becb33dec2d",
      "stage": "signals.enrich",
      "run_id": "871502e5-bf4f-4324-8ee9-ede53bd5d0e1",
      "tenant": "geopolitics",
      "service": "api",
      "pipeline": "pipeline_run",
      "correlation_id": "654dbdb5-56ef-442c-891d-6bd9afcbbef8"
    }
  },
  "story_id": "e12efce9-8d17-4deb-9e0d-fe3d16e7cf71",
  "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": 11,
    "structural_priority": true,
    "mostly_social": false,
    "community_chatter": false,
    "reader_label": null,
    "excluded_reasons": [],
    "source_signals": {
      "post_count": 3,
      "unique_origins": 3,
      "source_types_count": 1,
      "independent_non_social_count": 3,
      "social_source_count": 0,
      "non_social_source_count": 0,
      "why_now_count": 3,
      "why_it_matters_count": 3
    }
  },
  "current_cycle_open": false
}

• 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.