Sign in
Home | API Docs
GET

/v1/entities

v1

List entities

Retrieve a paginated list of entities (people, organizations, locations) with optional filters.

Parameters

q string
query

Search query to filter entities by name

e.g. Roberts

type "person" | "org" | "location"
query

Filter by entity type

e.g. person

subcategory string
query

Filter by subcategory

e.g. politician

limit integer
query

Number of entities to return

Default: 60

e.g. 20

offset integer
query

Number of entities to skip

Default: 0

e.g. 0

Request Examples

bash 
curl "https://api.newsrank.ai/v1/entities?q=Roberts&type=person&subcategory=politician&limit=20&offset=0" \
  -H "Authorization: Bearer nrf_your_api_key"

Response

json 
{
  "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
    }
  ],
  "total": 450,
  "offset": 0,
  "limit": 60
}

Try it

Server

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

Authentication
Demo key (sandbox)
Endpoint
GET /v1/entities
Default: 60
Default: 0