Sign in
Home | API Docs
GET

/v1/stories/{id}/updates

v1

Get story updates since timestamp

Check for new articles and changes to a story since a given timestamp. Returns new articles, sources, entities, and a significance assessment.

Parameters

id required string
path

Story ID (integer) or slug (string)

e.g. 1523

since_ms required integer (int64)
query

Unix timestamp in milliseconds to check for updates since

e.g. 1708300800000

Request Examples

bash 
curl "https://api.newsrank.ai/v1/stories/1523/updates?since_ms=1708300800000" \
  -H "Authorization: Bearer nrf_your_api_key"

Response

json 
{
  "cluster_id": 1523,
  "new_articles": [
    {
      "url_hash": "string",
      "title": "string",
      "source_name": "string",
      "published_at": 0
    }
  ],
  "new_article_count": 3,
  "new_sources": [
    "CNN",
    "BBC"
  ],
  "new_entities": [
    "John Roberts"
  ],
  "significance": "moderate",
  "significance_reasons": [
    "3 new sources reporting",
    "major entity mentioned"
  ],
  "baseline_member_count": 47,
  "checked_at_ms": 1708387200000
}

Try it

Server

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

Authentication
Demo key (sandbox)
Endpoint
GET /v1/stories/{id}/updates