Reuters · Schema

Reuters Connect Search Result

A search response from the Reuters Connect API containing a list of content items matching the search criteria, along with metadata about the total result count and the query that was executed.

BusinessFinanceJournalismMediaNewsWire Service

Properties

Name	Type	Description
results	array	Array of content item summaries matching the search criteria.
totalResults	integer	Total number of items matching the search criteria across all pages.
query	string	The search query string that was executed.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://github.com/kinlane/reuters/json-schema/reuters-search-result-schema.json",
  "title": "Reuters Connect Search Result",
  "description": "A search response from the Reuters Connect API containing a list of content items matching the search criteria, along with metadata about the total result count and the query that was executed.",
  "type": "object",
  "required": [
    "results",
    "totalResults"
  ],
  "properties": {
    "results": {
      "type": "array",
      "description": "Array of content item summaries matching the search criteria.",
      "items": {
        "$ref": "#/$defs/itemSummary"
      }
    },
    "totalResults": {
      "type": "integer",
      "description": "Total number of items matching the search criteria across all pages.",
      "minimum": 0
    },
    "query": {
      "type": "string",
      "description": "The search query string that was executed."
    }
  },
  "$defs": {
    "itemSummary": {
      "type": "object",
      "description": "A summary representation of a content item containing key metadata for display in search results without the full content body.",
      "required": [
        "id",
        "headline"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "The unique identifier for the item, typically in tag URI format.",
          "examples": [
            "tag:reuters.com,2025:newsml_L1N3KT0AB:1"
          ]
        },
        "guid": {
          "type": "string",
          "description": "A globally unique identifier for the item regardless of version."
        },
        "version": {
          "type": "string",
          "description": "The version number of this item revision."
        },
        "headline": {
          "type": "string",
          "description": "The headline or title of the content item."
        },
        "dateCreated": {
          "type": "string",
          "format": "date-time",
          "description": "The date and time when the item was originally created."
        },
        "dateModified": {
          "type": "string",
          "format": "date-time",
          "description": "The date and time when the item was last modified."
        },
        "channel": {
          "type": "string",
          "description": "The alias of the channel this item belongs to."
        },
        "mediaType": {
          "type": "string",
          "description": "The media type of the content.",
          "enum": [
            "TEXT",
            "PICTURE",
            "VIDEO",
            "GRAPHIC",
            "COMPOSITE"
          ]
        },
        "slug": {
          "type": "string",
          "description": "A short keyword slug summarizing the item topic."
        }
      }
    }
  }
}