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/583f5a30-a145-4dcf-9688-6dedc07d1ae2?tenant=geopolitics&run_id=c7ff7cb4-eb57-48b0-9e31-6b115e1a297b

{
  "id": "583f5a30-a145-4dcf-9688-6dedc07d1ae2",
  "title": "What could new US sanctions on Iran entail?",
  "summary": "The US says it is preparing to announce new sanctions on Iran. It's been billed an economic D-day and is expected to add further pressure on the country's economy that's already been battered from previous sanctions and a US naval blockade. The renewed economic pressure would not be the first time the US has used economic tools at its disposal to corner Iran. But what could the new measures likely",
  "first_seen_at": "2026-08-23T21:34:53Z",
  "last_seen_at": "2026-08-24T16:02:50Z",
  "created_at": "2026-08-24T17:11:49.328881Z",
  "updated_at": "2026-08-25T13:05:12.838845Z",
  "timeframe": "24h",
  "run_id": "c7ff7cb4-eb57-48b0-9e31-6b115e1a297b",
  "metrics": {
    "divergence": 33.6628,
    "post_count": 13,
    "momentum_1h": 0,
    "momentum_7d": 13,
    "score_total": 2.071356,
    "shill_score": 11.54,
    "momentum_24h": 13,
    "market_movers": [],
    "evidence_score": 1,
    "unique_authors": 8,
    "coherence_score": 0.7091,
    "diversity_bonus": 0.2,
    "duplicate_ratio": 0,
    "platforms_count": 1,
    "social_momentum": 13,
    "divergence_label": "chatter_without_pricing",
    "market_conviction": 0,
    "origin_share_top1": 0.307692,
    "unique_publishers": 7,
    "origin_layer_posts": 0,
    "source_types_count": 1,
    "unique_authors_24h": 8,
    "unique_origin_urls": 13,
    "amplifier_share_top1": 0.307692,
    "author_concentration": 0.3846,
    "publisher_share_top1": 0.307692,
    "amplifier_layer_posts": 13,
    "concentration_penalty": 0,
    "unique_origin_domains": 7,
    "source_diversity_bonus": 0,
    "unique_publisher_types": 1,
    "unique_origin_publishers": 7
  },
  "platforms": [
    "rss"
  ],
  "top_tickers": [],
  "why_now": [],
  "display_title": "US prepares toughest economic sanctions on Iran amid Tehran's vow to retaliate",
  "display_summary": "The US Treasury Secretary Scott Bessent is set to unveil a new round of economic sanctions on Iran, described as an \"economic D-Day\" and the \"single greatest financial offensive\" against an adversary.",
  "narrative_frame_display": null,
  "entities": {
    "companies": [
      "United Arab Emirates"
    ],
    "people": [
      "Scott Bessent",
      "Donald Trump"
    ]
  },
  "recurring_claims": [
    {
      "claim": "The US is preparing the toughest economic sanctions ever against Iran, described as an 'economic D-Day'.",
      "evidence_urls": [
        "https://npr.org/2026/08/24/g-s1-139743/treasury-secretary-scott-bessent-to-unveil-new-economic-sanctions-on-iran",
        "https://jpost.com/middle-east/iran-news/article-906373",
        "https://france24.com/en/what-could-new-us-sanctions-on-iran-entail"
      ]
    },
    {
      "claim": "Iran vows to retaliate harshly against countries cooperating with US sanctions, including the UAE.",
      "evidence_urls": [
        "https://theguardian.com/world/2026/aug/24/iran-vows-retaliate-countries-cooperate-fresh-us-sanctions",
        "https://france24.com/en/middle-east/20260824-middle-east-live-iran-warns-of-a-harsh-response-to-anticipated-us-sanctions",
        "https://aljazeera.com/news/2026/8/24/us-threatens-toughest-sanctions-yet-against-iran-what-we-know?traffic_source=rss"
      ]
    },
    {
      "claim": "The sanctions risk geopolitical blowback, particularly from China, which maintains ties with Iran.",
      "evidence_urls": [
        "https://aljazeera.com/economy/2026/8/24/us-threat-of-economic-d-day-for-iran-tests-trumps-china-detente?traffic_source=rss"
      ]
    }
  ],
  "stance_map": [
    {
      "stance": "questions",
      "who": "France24 Middle East",
      "evidence_urls": [
        "https://france24.com/en/us-sanctions-unlikely-to-get-tehran-to-bow-down-despite-effect-on-population"
      ]
    }
  ],
  "quality_flags": {
    "mixed_topic_risk": "low",
    "promo_risk": "low",
    "source_quality": "high"
  },
  "editor_note": null,
  "display_tags": [
    "sanctions",
    "geopolitics",
    "macro",
    "economic_measures",
    "iran"
  ],
  "tags": [
    "sanctions",
    "geopolitics",
    "macro",
    "economic_measures",
    "iran"
  ],
  "cscope_tags": [
    "sanctions",
    "geopolitics",
    "macro",
    "economic_measures",
    "iran"
  ],
  "why_now_display": [
    "The sanctions come amid a prolonged conflict and stalled military/diplomatic efforts to end the war with Iran.",
    "Recent moves by the UAE to cut trade with Iran signal shifting regional alignments influenced by US pressure.",
    "The US aims to leverage economic tools after failing to dislodge Iran's control over strategic shipping routes like the Strait of Hormuz."
  ],
  "why_it_matters_display": [
    "These sanctions represent the most severe economic pressure ever applied to Iran, potentially reshaping regional trade and alliances.",
    "Iran's threats to retaliate against cooperating countries could escalate geopolitical tensions and disrupt global markets.",
    "The sanctions test US-China relations, as China is a key economic partner to Iran, risking broader geopolitical fallout."
  ],
  "show_why": true,
  "sources_display": [
    {
      "label": "npr.org: NPR Middle East"
    },
    {
      "label": "france24.com: France24 Middle East"
    },
    {
      "label": "Al Jazeera All News: What to expect as Iran braces for new US economic measures amid war"
    },
    {
      "label": "Jerusalem Post Middle East: Trump: Iran 'completely collapsing' as Treasury Sec. discusses 'economic D-Day'"
    },
    {
      "label": "France24 Middle East: Middle East live: Iran warns of a harsh response to anticipated US sanctions"
    }
  ],
  "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": "a2b8bd929eee51b660f2fc7f511e2f1a50a9b9e19a1766967942f9fadb474f36",
    "updated_at": "2026-08-24T17:14:07.724810+00:00",
    "llm_metadata": {
      "env": "prod",
      "host": "2eb2d6b2d2d9",
      "stage": "signals.enrich",
      "run_id": "c7ff7cb4-eb57-48b0-9e31-6b115e1a297b",
      "tenant": "geopolitics",
      "service": "api",
      "pipeline": "pipeline_run",
      "correlation_id": "583f5a30-a145-4dcf-9688-6dedc07d1ae2"
    }
  },
  "story_id": "69650e34-08b1-4325-911b-b408c9d3c6d5",
  "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": 13,
      "unique_origins": 7,
      "source_types_count": 1,
      "independent_non_social_count": 7,
      "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.