Sign in
Home | API Docs
GET

/v1/entities/{id}/articles

v1

List articles mentioning an entity

Retrieve a paginated list of articles that mention a specific entity, ordered by recency.

Parameters

id required string
path

Entity ID (integer) or slug (string)

e.g. john-roberts

limit integer
query

Number of articles to return (max 100)

Default: 20

e.g. 20

offset integer
query

Number of articles to skip

Default: 0

e.g. 0

Request Examples

bash 
curl "https://api.newsrank.ai/v1/entities/john-roberts/articles?limit=20&offset=0" \
  -H "Authorization: Bearer nrf_your_api_key"

Response

json 
{
  "items": [
    {
      "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"
    }
  ],
  "total": 234,
  "offset": 0,
  "limit": 20
}

Try it

Server

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

Authentication
Demo key (sandbox)
Endpoint
GET /v1/entities/{id}/articles
Default: 20
Default: 0