GET

/v1/item

Get a single article

Retrieve a single article by its URL hash or slug. Provide either `url_hash` or `slug` as a query parameter.

Parameters

Name	Type	Description
`url_hash` query	`string`	The URL hash of the article e.g. `a1b2c3d4e5`
`slug` query	`string`	The slug of the article e.g. `supreme-court-rules-on-landmark-climate-case`

url_hash string

query

The URL hash of the article

e.g. a1b2c3d4e5

slug string

query

The slug of the article

e.g. supreme-court-rules-on-landmark-climate-case

Request Examples

bash

curl "https://api.newsrank.ai/v1/item?url_hash=a1b2c3d4e5&slug=supreme-court-rules-on-landmark-climate-case" \
  -H "Authorization: Bearer nrf_your_api_key"

Response

json

{
  "item": {
    "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"
  }
}

Try it

Server

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

Authentication

Demo key (sandbox)

Endpoint

GET /v1/item

url_hash string

slug string