Sign in
Home | API Docs
GET

/v1/graph/story-entity

v1

Get story-entity graph

Retrieve the relationship graph between stories and their mentioned entities. Useful for visualizing how entities connect across different news stories.

Parameters

story_id required integer
query

The story ID to build the graph around

e.g. 1523

limit integer
query

Maximum number of entities to include

Default: 20

e.g. 10

Request Examples

bash 
curl "https://api.newsrank.ai/v1/graph/story-entity?story_id=1523&limit=10" \
  -H "Authorization: Bearer nrf_your_api_key"

Response

json 
{
  "story": {
    "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"
  },
  "entities": [
    {
      "id": 892,
      "name": "John Roberts",
      "type": "person",
      "subcategory": "politician",
      "slug": "john-roberts",
      "description": "Chief Justice of the United States",
      "image_url": "https://example.com/images/roberts.jpg",
      "wikidata_id": "Q11204",
      "wikipedia_url": "https://en.wikipedia.org/wiki/John_Roberts",
      "article_count": 234,
      "aliases": [
        "Chief Justice Roberts",
        "J. Roberts"
      ],
      "enriched": true
    }
  ],
  "edges": [
    {
      "story_id": 0,
      "entity_id": 0,
      "mention_count": 0
    }
  ]
}

Try it

Server

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

Authentication
Demo key (sandbox)
Endpoint
GET /v1/graph/story-entity
Default: 20