Sign in
Home | API Docs
GET

/v1/stories/ranked

v1

List ranked stories

Retrieve top stories ranked by relevance and recency.

Parameters

limit integer
query

Number of ranked stories to return

Default: 50

e.g. 10

include_embeddings boolean
query

Include centroid embedding vectors in each story. 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/ranked?limit=10" \
  -H "Authorization: Bearer nrf_your_api_key"

Response

json 
{
  "stories": [
    {
      "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"
    }
  ]
}

Try it

Server

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

Authentication
Demo key (sandbox)
Endpoint
GET /v1/stories/ranked
Default: 50
Default: false
Default: json