Feed API

Signals via API

Feed API access for integrations is available under Business plans. Public endpoints show a limited or redacted payload; Pro is for individual app access.

Public sample from the feed endpoint. The backend exposes read endpoints for signals, storylines, and briefings.

Public sample

GET /v1/feed/stories?limit=3&timeframe=24h&sort=momentum&tenant=energy

{
  "run_id": "634566e2-5942-4540-95db-d0486a2b621c",
  "timeframe": "24h",
  "items": [
    {
      "type": "storyline",
      "id": "dd086cb6-02b1-45ee-8436-0f09025e872f",
      "story_id": "dd086cb6-02b1-45ee-8436-0f09025e872f",
      "run_id": "634566e2-5942-4540-95db-d0486a2b621c",
      "snapshot_id": "b7322afa-8c1b-4e32-a510-8f0a8b29aa46",
      "narrative_id": "04051165-1211-4e7b-afec-446e82d04d46",
      "first_seen": "2026-09-29T17:07:07.048432+00:00",
      "last_seen": "2026-09-30T05:11:04.104923+00:00",
      "first_seen_at": "2026-09-29T13:42:56+00:00",
      "last_seen_at": "2026-09-29T13:54:46+00:00",
      "status": "open",
      "title": "New 85 W solar shingle adds low-profile power to roofs",
      "summary": "Building products manufacturer CertainTeed has launched Landmark PWR, a direct-to-deck building-integrated photovoltaic (BIPV) roofing system designed to replace conventional rack-mounted solar arrays. Designed to blend with traditional asphalt shingles, the system combines solar shingles with a specialized fire-barrier underlayment to provide Class A fire protection and wind resistance. The syste",
      "top_tickers": [],
      "why_now": [],
      "metrics": {
        "score_total": 0.891392,
        "momentum_24h": 2,
        "post_count": 2,
        "unique_origin_publishers": 2,
        "unique_publisher_types": 1,
        "origin_share_top1": 0.5,
        "amplifier_share_top1": 0.5,
        "duplicate_ratio": 0,
        "evidence_score": 0.5,
        "source_types_count": 1,
        "unique_origin_domains": 2,
        "unique_publishers": 2,
        "quality_policy_version": 6,
        "tenant_claim_coherence_policy_version": 3
      },
      "trend_status": "insufficient_history",
      "trend_sparkline": "▁▁",
      "trend_points_n": 2,
      "trend_window": {
        "lookback_days": 14,
        "max_points": 36,
        "value_key": "score_total"
      },
      "maturity_label": "chatter",
      "maturity_score": 0.49630666666666673,
      "top_sources": [
        {
          "label": "Pv Magazine: New 85 W solar shingle adds low-profile power to roofs",
          "source_type": "rss",
          "evidence_class": "secondary",
          "provenance_role": "origin",
          "publisher_subtype": "news"
        },
        {
          "label": "Pv Magazine Usa: New 85 W solar shingle adds low-profile power to roofs",
          "source_type": "rss",
          "evidence_class": "secondary",
          "provenance_role": "origin",
          "publisher_subtype": "news"
        }
      ],
      "rank_story": 0.6308797941613757,
      "p_score": 1,
      "p_mom": 1,
      "recency": 0.3235191766455034,
      "risk_penalty": 0,
      "badges": [
        "chatter",
        "insufficient_history"
      ],
      "storyline_category": "narrative",
      "storyline_category_reason": "multi_run_continuity",
      "verified_update_issuer_count": 0,
      "storyline_independent_origin_count": 2,
      "storyline_continuity_points": 2,
      "sources": [],
      "llm_title": "CertainTeed launches 85 W solar shingle system",
      "llm_summary": "CertainTeed has launched Landmark PWR, a direct-to-deck building-integrated photovoltaic roofing system designed as an alternative to rack-mounted rooftop arrays. It uses 85 W frameless laminate shingles with 21.1% cell efficiency, two bypass diodes and a specialized fire-barrier underlayment in a low-profile design intended to blend with asphalt shingles.",
      "llm_narrative_frame": "CertainTeed is positioning Landmark PWR as a building-integrated photovoltaic roofing system that places solar generation directly on the roof deck instead of using conventional rack-mounted arrays. The reported design combines 85 W frameless solar shingles with a specialized fire-barrier underlayment and a low-profile form factor intended to blend with asphalt shingles.",
      "llm_narrative_label": "Solar roofing product launch",
      "llm_narrative_type": "one_off_news",
      "llm_why_now": [
        "CertainTeed has announced Landmark PWR as a new solar roofing product.",
        "Reports outline the shingles’ output, efficiency and electrical ratings."
      ],
      "llm_why_it_matters": [
        "The system integrates solar generation into roofing rather than using conventional rack-mounted arrays.",
        "It combines low-profile solar shingles with a fire-barrier underlayment."
      ],
      "llm_top_sources": [
        {
          "label": "pv magazine USA"
        },
        {
          "label": "pv magazine International"
        }
      ],
      "entities": {
        "projects": [
          "Landmark PWR"
        ],
        "companies": [
          "CertainTeed"
        ]
      },
      "recurring_claims": [
        {
          "claim": "CertainTeed has launched Landmark PWR, a direct-to-deck BIPV roofing system intended to replace conventional rack-mounted solar arrays.",
          "evidence_urls": [
            "https://pv-magazine-usa.com/2026/09/29/new-85-w-solar-shingle-adds-low-profile-power-to-roofs",
            "https://pv-magazine.com/2026/09/29/new-85-w-solar-shingle-adds-low-profile-power-to-roofs"
          ]
        },
        {
          "claim": "The system uses 85 W frameless laminate shingles with 21.1% cell efficiency and a specialized fire-barrier underlayment.",
          "evidence_urls": [
            "https://pv-magazine-usa.com/2026/09/29/new-85-w-solar-shingle-adds-low-profile-power-to-roofs",
            "https://pv-magazine.com/2026/09/29/new-85-w-solar-shingle-adds-low-profile-power-to-roofs"
          ]
        }
      ],
      "stance_map": [
        {
          "who": "pv magazine",
          "stance": "neutral",
          "evidence_urls": [
            "https://pv-magazine-usa.com/2026/09/29/new-85-w-solar-shingle-adds-low-profile-power-to-roofs",
            "https://pv-magazine.com/2026/09/29/new-85-w-solar-shingle-adds-low-profile-power-to-roofs"
          ]
        }
      ],
      "quality_flags": {
        "mixed_topic_risk": "low",
        "promo_risk": "medium",
        "source_quality": "high"
      },
      "editor_note": "Two closely matching reports describe the same CertainTeed product launch.",
      "scope_tags": [
        "renewables",
        "solar",
        "distributed_generation",
        "building_integrated_pv"
      ],
      "scope_tags_raw": [
        "renewables",
        "solar",
        "distributed_generation",
        "building_integrated_pv"
      ],
      "llm_status": "accepted",
      "llm_meta": {
        "model": "gpt-5.6-luna",
        "prompt_version": "enrich_v3",
        "input_hash": "548a38d0cca8640f3c9e027ff2d3d8620f762cbc4391d8315434012e1d37aa8d",
        "updated_at": "2026-09-30T05:12:03.580294+00:00",
        "llm_metadata": {
          "env": "prod",
          "host": "83bc069ed062",
          "stage": "signals.enrich",
          "run_id": "634566e2-5942-4540-95db-d0486a2b621c",
          "tenant": "energy",
          "service": "api",
          "pipeline": "pipeline_run",
          "correlation_id": "04051165-1211-4e7b-afec-446e82d04d46"
        }
      },
      "display_title": "CertainTeed launches 85 W solar shingle system",
      "display_summary": "CertainTeed has launched Landmark PWR, a direct-to-deck building-integrated photovoltaic roofing system designed as an alternative to rack-mounted rooftop arrays.",
      "display_tags": [
        "renewables",
        "solar",
        "distributed_generation",
        "building_integrated_pv"
      ],
      "tags": [
        "renewables",
        "solar",
        "distributed_generation",
        "building_integrated_pv"
      ],
      "cscope_tags": [
        "renewables",
        "solar",
        "distributed_generation",
        "building_integrated_pv"
      ],
      "display_why_now": [
        "CertainTeed has announced Landmark PWR as a new solar roofing product.",
        "Reports outline the shingles’ output, efficiency and electrical ratings."
      ],
      "display_why_it_matters": [
        "The system integrates solar generation into roofing rather than using conventional rack-mounted arrays.",
        "It combines low-profile solar shingles with a fire-barrier underlayment."
      ],
      "why_now_display": [
        "CertainTeed has announced Landmark PWR as a new solar roofing product.",
        "Reports outline the shingles’ output, efficiency and electrical ratings."
      ],
      "why_it_matters_display": [
        "The system integrates solar generation into roofing rather than using conventional rack-mounted arrays.",
        "It combines low-profile solar shingles with a fire-barrier underlayment."
      ],
      "show_why": true,
      "sources_display": [
        {
          "label": "pv-magazine-usa.com: pv magazine USA"
        },
        {
          "label": "pv-magazine.com: pv magazine International"
        }
      ],
      "editor_status": "passed",
      "fields_replaced": [],
      "narrative_frame_display": "CertainTeed is positioning Landmark PWR as a building-integrated photovoltaic roofing system that places solar generation directly on the roof deck instead of using conventional rack-mounted arrays. The reported design combines 85 W frameless solar shingles with a specialized fire-barrier underlayment and a low-profile form factor intended to blend with asphalt shingles.",
      "display_rank_base_score": 2,
      "display_rank_score": 1000000002,
      "display_rank_boost": 1000000000,
      "lane": "chatter",
      "lane_reason": "maturity=chatter",
      "evidence_mix": {
        "primary": 0,
        "secondary": 2,
        "specialist": 0,
        "aggregator": 0,
        "social": 0
      },
      "sourceStats": {
        "qualityPolicyVersion": 6,
        "evidenceDocumentCount": 2,
        "uniqueItemCount": 2,
        "uniquePublisherCount": 2,
        "uniqueCanonicalOriginCount": 2,
        "independentNonSocialCount": 2,
        "primaryCount": 0,
        "secondaryCount": 2,
        "uniqueDomainsCount": 2,
        "aggregatorCount": 0,
        "socialCount": 0,
        "sourceTypeDiversityCount": 1,
        "topSourceShare": 0.5,
        "passesTopSignalsGate": true,
        "gateReason": "independentNonSocial=2; primary=0; secondary=2; documents=2; publishers=2; canonicalOrigins=2; topSourceShare=0.5; rule=>=2 unique canonical primary/secondary publishers; aggregators/social excluded"
      },
      "evidence_meta": {
        "post_count": 2,
        "unique_origin_publishers": 2,
        "source_types_count": 1,
        "origin_share_top1": 0.5
      },
      "gate": {
        "passesTopSignalsGate": true,
        "gateReason": "independentNonSocial=2; primary=0; secondary=2; documents=2; publishers=2; canonicalOrigins=2; topSourceShare=0.5; rule=>=2 unique canonical primary/secondary publishers; aggregators/social excluded"
      },
      "tenant_claim_coherence": {
        "tenant": "energy",
        "status": "not_applicable",
        "claim_scope": "not_applicable",
        "reason_codes": [],
        "public_anchors": {},
        "evidence_anchors": {},
        "debug": {
          "evidence_record_count": 2,
          "matching_record_count": 0,
          "independent_support_count": 0,
          "conflicting_record_count": 0
        }
      },
      "evidence_quality_flag": "good"
    }
  ],
  "next_cursor": null,
  "disclaimer": "No investment advice. Research signals and sources only. EarlyNarratives provides informational signals derived from public sources. It does not provide financial, legal, or tax advice."
}
Capabilities
  • Signals and storylines feed endpoints with filtering and rate limits
  • Briefing delivery endpoints for integrations
  • Evidence link payloads for auditability
Integrate in your workflow
  • 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.