Refinitiv · Schema

Refinitiv News Article

Represents a news article or headline from the Refinitiv Data Platform News API, including metadata, content, and classification information.

Properties

Name Type Description
storyId string Unique identifier for the news story.
title string The headline text of the news article.
body stringnull The full text body of the news article, available when retrieving the complete story.
versionCreated string Timestamp when the article was originally created or published.
firstCreated stringnull Timestamp of the first version of the story.
sourceCode stringnull Code identifying the news source such as NS:RTRS for Reuters.
sourceName stringnull Human-readable name of the news source.
language stringnull ISO 639-1 language code of the article.
urgency integernull The urgency level of the news, with lower values indicating higher urgency.
subjects arraynull Subject classification codes for the article.
audiences arraynull Target audience codes for the article.
instruments arraynull Financial instruments referenced in the article.
newsItem stringnull A reference identifier for the news item.
View JSON Schema on GitHub

JSON Schema

refinitiv-news-article-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://api.refinitiv.com/schemas/refinitiv/news-article.json",
  "title": "Refinitiv News Article",
  "description": "Represents a news article or headline from the Refinitiv Data Platform News API, including metadata, content, and classification information.",
  "type": "object",
  "required": ["storyId", "title", "versionCreated"],
  "properties": {
    "storyId": {
      "type": "string",
      "description": "Unique identifier for the news story."
    },
    "title": {
      "type": "string",
      "description": "The headline text of the news article."
    },
    "body": {
      "type": ["string", "null"],
      "description": "The full text body of the news article, available when retrieving the complete story."
    },
    "versionCreated": {
      "type": "string",
      "format": "date-time",
      "description": "Timestamp when the article was originally created or published."
    },
    "firstCreated": {
      "type": ["string", "null"],
      "format": "date-time",
      "description": "Timestamp of the first version of the story."
    },
    "sourceCode": {
      "type": ["string", "null"],
      "description": "Code identifying the news source such as NS:RTRS for Reuters."
    },
    "sourceName": {
      "type": ["string", "null"],
      "description": "Human-readable name of the news source."
    },
    "language": {
      "type": ["string", "null"],
      "description": "ISO 639-1 language code of the article.",
      "pattern": "^[a-z]{2}$"
    },
    "urgency": {
      "type": ["integer", "null"],
      "description": "The urgency level of the news, with lower values indicating higher urgency.",
      "minimum": 1
    },
    "subjects": {
      "type": ["array", "null"],
      "items": {
        "type": "string"
      },
      "description": "Subject classification codes for the article."
    },
    "audiences": {
      "type": ["array", "null"],
      "items": {
        "type": "string"
      },
      "description": "Target audience codes for the article."
    },
    "instruments": {
      "type": ["array", "null"],
      "items": {
        "type": "object",
        "properties": {
          "ric": {
            "type": "string",
            "description": "RIC of the related instrument."
          },
          "name": {
            "type": ["string", "null"],
            "description": "Name of the related instrument."
          }
        }
      },
      "description": "Financial instruments referenced in the article."
    },
    "newsItem": {
      "type": ["string", "null"],
      "description": "A reference identifier for the news item."
    }
  }
}