Overview

Copy

The Security Master API provides a centralized, canonical dataset of identifiers and metadata for global instruments. It is designed to serve as the foundational reference layer for any financial data platform, ensuring consistency across tickers, company names, CUSIPs, ISINs, FIGIs, PermIDs, exchange codes, and other identifiers used across downstream applications.

Concepts

Copy

The following table defines general concepts related to the Dow Jones Newswires Real-Time Search API:

Attribute

Definition

Article

It is a piece of writing on a particular subject. It is usually an independent entity included with others in a newspaper, journal, magazine, or other publication.

Search

It is a query string to look for information based on Dow Jones Newswires taxonomy codes. Dow Jones Newswires taxonomy codes allow you to exclude or filter the information using not in a query string. Dow Jones Newswires taxonomy codes support and and or keywords to include more than one selection or filtering specifications. Use ( and ) to group information. For example: (pdt:>20220307080000000 and pdt:<20220307163059000). You can use other keywords, operators (or, and, not, <, >, =), parameters, headline (hd=), language (la=), (significant and about) and DJN taxonomy codes (djn=). For example: "value": "djn=p/pmdm and (pdt:>20220307080000000 and pdt:<20220307163059000)". To use Dow Jones Newswires Taxonomy, assign "djn=p/pmdm" to the search_string object value parameter. For example: "value": "djn=p/pmdm".

Significant

About Nucor Corp. using ticker – djn:djnabout:nue

About Nucor Corp using ISIN – djn:djnabout:us6703461052

Significant news on Nucor Corp using ticker – djn:sig:nue

Significant news on Nucor Corp using ISIN – djn:sig:us6703461052

Significant company news – ili:DJNCOMPANYSIGNIFICANT

Request Body Data Definitions

Copy

Copy

Copy

The following table defines general concepts related to the Dow Jones Newswires Real-Time Search API:

Important: The Dow Jones Newswires Real-Time API schema includes attributes that do not apply to the API request. This section describes only the functional features.

The following sections describe the request body parameters and a sample request body.

Sample Search Request Body

Copy

Copy

Copy

Note: Some fields and objects are replaced with ... to improve the readability of the responses in this document.

The following code snippet illustrates a sample search request body:

Copy

Copy

Copy

{
    "data": {
        "id": "Search",
        "type": "content",
        "attributes": {
            "query": {
                "search_string": [
                    {
                        "mode": "Unified",
                        "value": "djn=p/pmdm"
                    }
                ],
                "date": {
                    "days_range": "LastDay"
                }
            },
            "formatting": {
                "is_return_rich_article_id": true
            },
            "navigation":{
                "is_return_headline_coding": true,
                "is_return_djn_headline_coding": true
            },
            "page_offset": 0,
            "page_limit": 10
        }
    }
}

Important: The input request has a limit of 10K characters. This limit applies to the whole POST call, including its authentication.

Search Request Data Headers

Copy

Copy

Copy

The following table describes the data headers of a search request:

Concept

Concept

Definition

id

String

Identifier for the REST request. Fixed value: Search

type

String

The type of the expected response. Fixed value: content

attributes

Object

Attributes to define the search criteria.