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/16791989-0f33-4042-80d7-0cfc3334fb9f?tenant=energy&run_id=a1db17ec-8f99-4a77-a99f-2b41bab8dc1c

{
  "id": "16791989-0f33-4042-80d7-0cfc3334fb9f",
  "title": "California Legislature passes balcony solar bill",
  "summary": "Californians could soon put solar panel kits on balconies and in backyards to lower their electric bills — without utility approval. On Wednesday, state lawmakers passed the Plug and Play Solar Act (Senate Bill 868) to legalize balcony solar , a form of DIY clean energy that’s taken off in Germany . The bill, which…",
  "first_seen_at": "2026-08-26T12:22:23Z",
  "last_seen_at": "2026-08-27T00:46:46Z",
  "created_at": "2026-08-27T05:23:50.850893Z",
  "updated_at": "2026-08-27T05:24:02.860067Z",
  "timeframe": "24h",
  "run_id": "a1db17ec-8f99-4a77-a99f-2b41bab8dc1c",
  "metrics": {
    "divergence": 30,
    "post_count": 5,
    "momentum_1h": 0,
    "momentum_7d": 5,
    "score_total": 1.498846,
    "shill_score": 12,
    "momentum_24h": 5,
    "market_movers": [],
    "evidence_score": 1,
    "unique_authors": 4,
    "coherence_score": 0.7249,
    "diversity_bonus": 0.2,
    "duplicate_ratio": 0.2,
    "platforms_count": 1,
    "social_momentum": 5,
    "divergence_label": null,
    "market_conviction": 0,
    "origin_share_top1": 0.2,
    "unique_publishers": 5,
    "origin_layer_posts": 0,
    "source_types_count": 1,
    "unique_authors_24h": 4,
    "unique_origin_urls": 5,
    "amplifier_share_top1": 0.2,
    "author_concentration": 0.4,
    "publisher_share_top1": 0.2,
    "amplifier_layer_posts": 5,
    "concentration_penalty": 0,
    "unique_origin_domains": 5,
    "source_diversity_bonus": 0,
    "unique_publisher_types": 1,
    "unique_origin_publishers": 5,
    "quality_policy_version": 6,
    "tenant_claim_coherence_policy_version": 2
  },
  "platforms": [
    "rss"
  ],
  "top_tickers": [],
  "why_now": [],
  "display_title": "California lawmakers pass plug-in solar bill",
  "display_summary": "California’s legislature passed SB 868, the Plug and Play Solar Act, which would ease installation of qualifying plug-in solar systems in homes, apartments, condos and backyards. The bill includes safety, code-compliance and certification requirements, permits utility notification, and awaits the governor’s action.",
  "narrative_frame_display": "California lawmakers have passed Senate Bill 868, advancing a framework for portable, plug-in solar generation of up to 1,200 watts for homes and apartments. The bill would remove utility interconnection agreements and prior permission requirements, while retaining electrical-code and laboratory-certification standards. It now awaits the governor’s action, and the interconnection exemption is scheduled to end on January 1, 2030 under the amended bill.",
  "entities": {
    "projects": [
      "Plug and Play Solar Act",
      "Senate Bill 868"
    ]
  },
  "recurring_claims": [
    {
      "claim": "California lawmakers passed SB 868, allowing qualifying portable solar devices of up to 1,200 watts to plug into receptacles in homes or apartments.",
      "evidence_urls": [
        "https://pv-magazine-usa.com/2026/08/26/california-plug-in-solar-bill-sb-868-earns-approval-of-both-legislative-houses-nears-governors-desk",
        "https://canarymedia.com/articles/balcony-solar/california-lawmakers-pass-bill-oking-balcony-solar"
      ]
    },
    {
      "claim": "The bill would generally remove utility interconnection agreements and prior permission requirements, subject to specified safety and certification rules.",
      "evidence_urls": [
        "https://pv-magazine.com/2026/08/26/california-plug-in-solar-bill-sb-868-earns-approval-of-both-legislative-houses-nears-governors-desk",
        "https://solarpowerworldonline.com/2026/08/california-sends-balcony-solar-bill-to-governor-for-signature"
      ]
    },
    {
      "claim": "The amended bill removes the interconnection exemption and permission-free installation rights from January 1, 2030.",
      "evidence_urls": [
        "https://pv-magazine.com/2026/08/26/california-plug-in-solar-bill-sb-868-earns-approval-of-both-legislative-houses-nears-governors-desk"
      ]
    }
  ],
  "stance_map": [
    {
      "stance": "neutral",
      "who": "News reports",
      "evidence_urls": [
        "https://pv-magazine-usa.com/2026/08/26/california-plug-in-solar-bill-sb-868-earns-approval-of-both-legislative-houses-nears-governors-desk",
        "https://canarymedia.com/articles/balcony-solar/california-lawmakers-pass-bill-oking-balcony-solar"
      ]
    }
  ],
  "quality_flags": {
    "mixed_topic_risk": "low",
    "promo_risk": "low",
    "source_quality": "high"
  },
  "editor_note": "Multiple reports describe the same California legislative action; details are consolidated and duplicate phrasing removed.",
  "display_tags": [
    "solar",
    "distributed_generation",
    "power",
    "energy_policy",
    "california",
    "regulation"
  ],
  "tags": [
    "solar",
    "distributed_generation",
    "power",
    "energy_policy",
    "california",
    "regulation"
  ],
  "cscope_tags": [
    "solar",
    "distributed_generation",
    "power",
    "energy_policy",
    "california",
    "regulation"
  ],
  "why_now_display": [
    "The legislature has passed the bill and it is moving to the governor.",
    "The amended legislation includes a January 1, 2030 change to the interconnection exemption."
  ],
  "why_it_matters_display": [
    "The bill could change access requirements for small, customer-sited solar generation.",
    "Its provisions link easier deployment with electrical-code and certification requirements."
  ],
  "show_why": true,
  "sources_display": [
    {
      "label": "pv-magazine-usa.com: pv magazine USA report on SB 868"
    },
    {
      "label": "canarymedia.com: Canary Media report on balcony solar legislation"
    },
    {
      "label": "solarpowerworldonline.com: Solar Power World report on governor action"
    },
    {
      "label": "CleanTechnica: California Legislature Approves Bill Easing Access to Clean, Affordable “Balcony Solar”"
    },
    {
      "label": "pv magazine International: California plug-in solar bill earns approval of both legislative houses"
    }
  ],
  "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": "6d1f6bcaa82d7332b0c6b40f9945c8718a89780da3614a084582161729501e0b",
    "updated_at": "2026-08-27T05:25:40.508027+00:00",
    "llm_metadata": {
      "env": "prod",
      "host": "db25dd11fb50",
      "stage": "signals.enrich",
      "run_id": "a1db17ec-8f99-4a77-a99f-2b41bab8dc1c",
      "tenant": "energy",
      "service": "api",
      "pipeline": "pipeline_run",
      "correlation_id": "16791989-0f33-4042-80d7-0cfc3334fb9f"
    }
  },
  "story_id": "30d892f6-98ab-4a98-bd3f-44281703aef2",
  "sourceStats": {
    "qualityPolicyVersion": 6,
    "evidenceDocumentCount": 5,
    "uniqueItemCount": 5,
    "uniquePublisherCount": 5,
    "uniqueCanonicalOriginCount": 5,
    "independentNonSocialCount": 5,
    "primaryCount": 0,
    "secondaryCount": 5,
    "uniqueDomainsCount": 5,
    "aggregatorCount": 0,
    "socialCount": 0,
    "sourceTypeDiversityCount": 1,
    "topSourceShare": 0.2,
    "passesTopSignalsGate": true,
    "gateReason": "independentNonSocial=5; primary=0; secondary=5; documents=5; publishers=5; canonicalOrigins=5; topSourceShare=0.2; rule=>=2 unique canonical primary/secondary publishers; aggregators/social excluded"
  },
  "gate": {
    "passesTopSignalsGate": true,
    "gateReason": "independentNonSocial=5; primary=0; secondary=5; documents=5; publishers=5; canonicalOrigins=5; topSourceShare=0.2; 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": 11,
    "structural_priority": true,
    "mostly_social": false,
    "community_chatter": false,
    "reader_label": null,
    "excluded_reasons": [],
    "source_signals": {
      "post_count": 5,
      "unique_origins": 5,
      "source_types_count": 1,
      "independent_non_social_count": 5,
      "social_source_count": 0,
      "non_social_source_count": 0,
      "why_now_count": 2,
      "why_it_matters_count": 2
    },
    "content_quality_ready": true
  },
  "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.