Sign in
Home | API Docs
GET

/v1/stories/{id}

v1

Get a single story

Retrieve a single story by its numeric ID or slug. Returns full story detail including articles and developments timeline.

Parameters

id required string
path

Story ID (integer) or slug (string)

e.g. supreme-court-climate-ruling

include_embeddings boolean
query

Include embedding vectors for the story centroid and each member article. Requires Pro tier or higher.

Default: false

embedding_format "json" | "base64"
query

Embedding output format (only used when include_embeddings=true)

Default: json

Request Examples

bash 
curl "https://api.newsrank.ai/v1/stories/supreme-court-climate-ruling" \
  -H "Authorization: Bearer nrf_your_api_key"

Response

json 
{
  "id": 1523,
  "slug": "supreme-court-climate-ruling",
  "headline": "Supreme Court Issues Landmark Climate Ruling",
  "summary": "The Supreme Court ruled 6-3 in favor of stricter emissions standards...",
  "image_url": "https://example.com/images/court.jpg",
  "article_count": 47,
  "sources": [
    "Reuters",
    "AP News",
    "BBC"
  ],
  "top_entities": [
    "Supreme Court",
    "EPA",
    "John Roberts"
  ],
  "category": "politics",
  "first_seen": 1708300800000,
  "last_updated": 1708387200000,
  "label": "Breaking",
  "rich_summary": "## Background\nThe case originated from...",
  "articles": [
    {
      "id": 48210,
      "url_hash": "a1b2c3d4e5",
      "title": "Supreme Court Rules on Landmark Climate Case",
      "url": "https://example.com/article/supreme-court-climate",
      "source_id": 12,
      "source_name": "Reuters",
      "category": "politics",
      "published_at": 1708300800000,
      "discovered_at": 1708301400000,
      "excerpt": "The Supreme Court issued a landmark ruling today on...",
      "image_url": "https://example.com/images/court.jpg",
      "content_status": "has_content",
      "headline_summary": "Supreme Court sides with environmental regulators",
      "slug": "supreme-court-rules-on-landmark-climate-case"
    }
  ],
  "developments": [
    {
      "id": 42,
      "cluster_id": 1523,
      "created_at_ms": 1708300800000,
      "title": "Court announces ruling date",
      "description": "The Supreme Court has set a date for the landmark climate ruling...",
      "significance": "major",
      "previous_headline": "Climate Case Heads to Supreme Court",
      "new_headline": "Supreme Court Issues Landmark Climate Ruling",
      "trigger_article_hashes": [
        "a1b2c3d4e5"
      ],
      "enrichment_seq": 3
    }
  ]
}

Try it

Server

Using sandbox demo key (5 req/min) — no signup required

Authentication
Demo key (sandbox)
Endpoint
GET /v1/stories/{id}
Default: false
Default: json