Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Kensho NERD API

Named-Entity Recognition and Disambiguation REST service linking text mentions to S&P Capital IQ company identifiers and to Wikimedia entities (people, places, events). Supports asynchronous batch annotation with optional person tagging and originating-entity context for financial documents.

Kensho NERD API is one of 9 APIs that S&P Global publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include NER, Entity Linking, NLP, Capital IQ, and Wikimedia. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, and a JSON-LD context.

This API exposes 4 operations across 1 path, and defines 5 schemas. It is described by OpenAPI 3.0.2, at version 3.0.0.

Requests are made against a single base URL, https://nerd.kensho.com.

4 operations 1 paths 5 schemas 1 DELETE1 GET1 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.2
API Version
3.0.0
Base URL
https://nerd.kensho.com
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Kensho NERD API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (bearerAuth).

Paths & Operations 4

Across 1 path, the API surfaces 4 operations — 1 DELETE, 1 GET, 1 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

annotations-async 4
POST
/api/v1/annotations-async
Start A NERD Annotation Job
api_annotations_async_post body → 2024004014034295XX
PUT
/api/v1/annotations-async
Start A NERD Annotation Job Given A Provided Job ID
api_annotations_async_put 1 param body → 2024004014034295XX
GET
/api/v1/annotations-async
Get Annotations For The Specified Job ID
api_annotations_async_get 1 param → 2004004014034044295XX
DELETE
/api/v1/annotations-async
Delete Annotations For The Specified Job ID
api_annotations_async_delete 1 param → 2004004014034044094295XX

Schemas 5

The contract defines 5 schemas that model the data the API accepts and returns. The most detailed are nerd_response_annotation (9 properties), nerd_request_post (5 properties), nerd_request_put (4 properties), nerd_job_response (4 properties). Each schema is shown below with its type and property counts.

nerd_response_results
object
3 properties
nerd_job_response
object
4 properties
nerd_request_put
object
4 properties
nerd_response_annotation
object
9 properties
nerd_request_post
object
5 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

sp-global-annotations-async-api-openapi.yml Raw ↑

Other APIs S&P Global publishes across the network.

S&P Global LLM-Ready API (kFinance)
Kensho Extract API
Kensho Scribe Batch API v2
Kensho Scribe Real Time API
Kensho Scribe Batch API v1
Kensho Grounding Agent (Alpha)
S&P Capital IQ Pro
S&P Global Marketplace