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."
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/refinitiv-news-article"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.