The IPTC Standards Committee is happy to announce that ninjs, IPTC’s schema for marking up news content in JSON, has been revised to versions 2.1 and 1.5.

The vote to approve the new versions was taken at the recent IPTC Spring Meeting in Tallinn, Estonia and online.

This is in keeping with IPTC’s decision to maintain two parallel versions of ninjs: one for those who can’t upgrade to the 2.x version of backwards compatibility reasons, and those who prefer the simpler structure of ninjs 2.x that is easier to handle in some tools.

The ninjs User Guide has been updated to reflect the changes, which are summarised below.

ContactInfo added to ninjs 1.5 and 2.1

ninjs 2.1 and ninjs 1.5 both include the new contactinfo structure which can be used in the people, organisations, places and infosources properties (and their ninjs 1.x equivalents person, organisation, place and infosource).

The contactInfo structure can contain physical or online contact information such as a street address or postal address, a username on social media such as Twitter, Instagram or TikTok, or even a locator such as what3words.

Here are some examples of how the contactinfo property can be used:

"people": [
  {
    "name": "Jonas Svensson",
    "contactinfo": [
      {
        "type":"phone",
        "role": "work",
        "value": "+46 (0)8-7887500"
      }
    ]
  }
],

"organisations": [
  {
    "name": "International Committee of the Red Cross",
    "contactinfo": [
      {
        "type": "web",
        "value": "https://www.icrc.org/"
      },
      {
        "type": "address",
        "address": {
          "lines": [
            "19 Avenue de la paix",
            "1202 Geneva",
            "Switzerland"
          ]
        }
      },
      {
        "type": "telephone",
        "value": "+41 22 734 60 01"
      }
    ]
  }
]

Better support for organisation identifiers such as tickers, ISIN etc

ninjs 2.1 and 1.5 also include the new symboltype and symbol properties under symbols. Symbol can identify any type of URI describing the type of the symbol. The CV http://cv.iptc.org/newscodes/financialinstrumentsymboltype is recommended.

The ticker sub-property under symbols is now deprecated. This means that it can still be used if necessary, but use is not recommended.

We now recommend that ticker symbols are stored using symbol="TCKR" and symboltype="https://cv.iptc.org/newscodes/financialinstrumentsymboltype/Ticker".

Better support for machine classification

The subjects (ninjs 2.x) / subject (ninjs 1.x) properties now allow for the sub-properties creator, relevance and confidence. 

This allows organisations to more accurately use machine-generated subject tags in their content.  while stating that it was created by a machine (using the creator property), and giving numerical values for the relevance and confidence scores that are reported by machine tagging engines. (Of course, these properties can also be used for human-created subject tags if necessary!)

In addition, some internal changes to the schema were made to fix a validation bug that existed in previous versions. In order to accommodate these changes, the ninjs 2.1 schema uses the https://json-schema.org/draft/2020-12/schema version of JSON Schema.

Thanks to Johan Lindgren, welcome Ian Young as Working Group Lead

At the Spring Meeting in Tallinn we said farewell to Johan Lindgren as Lead of the News in JSON Working Group.

Johan, of the TT news agency in Sweden, was instrumental in bringing the News in JSON Working Group back from its quiet period after the initial launch of ninjs. This directly led to the release of several new versions of ninjs over the past few years, and its adoption by many of the world’s top news providers.

The IPTC wishes to thank Johan for all his contributions, and wishes him well for his retirement.

Johan’s work will be taken over by Ian Young from PA Media Group / Alamy based in the UK. Ian steps up to the Lead role after participating in the Working Group for many years, since the earliest days of ninjs.

We thank Ian for being willing to take on the lead role, and we look forward to seeing what developments will emerge from the News in JSON Working Group in the future.

Based on discussions at the recent IPTC Autumn Meeting, the IPTC News in JSON Working Group is updating its view of the use of ninjs and other forms of JSON for handling news content.

If your organisation uses JSON in any way for handling news content, we would like to hear from you.

We are looking for input from IPTC members and non-members, from agencies, publishers, broadcasters and software vendors.

Please help us by filling in the short survey via this Google Form.

Following many change requests submitted by news organisations all over the world, the IPTC News in JSON Working Group is happy to announce the 1.2 version of its standard ninjs.

The JSON Schema of the new version can be accessed at https://www.iptc.org/std/ninjs/.

We also created a ninjs User Guide that will enable new and existing users to understand how to put ninjs to use at their organisation.

Version 1.2 is backwards-compatible with version 1.0 and 1.1 and makes no breaking changes.

It includes the following new properties and structures:

• The firstcreated property goes along with the versioncreated property to specify the date/time when the first version of a news item was published.
• The charcount and wordcount properties allow the publisher to specify the total character count and word count of a news item (excluding figure captions and metadata).
• The slugline, property allows the publisher to specify a “slug”, a human-readable identifier for the item. (note that no conditions are placed on the usage of this property, usage is up to each publisher).
• The ednote, property allows publishers to specify instructions to editors.
• The infosource structure can specify one or many information sources for the news item. It is a metadata structure that can handle literal strings or values from a controlled vocabulary.
• The title property handles “A short natural-language name for the item.”

Also the following sub-properties were added:

• The value component was added to the allowed values for type to specify parts of a larger news item.
• The description of the renditions property was changed to allow for any type of rendition, not just images, and new sub-properties duration and format were added to enable audio and video renditions (for example, an audio version of a text story).

We have also included a test and validation suite so new versions of the JSON Schema can automatically be checked for compliance and backwards compatibility.

ninjs 1.2 is now included in the SchemaStore.org JSON Schema repository, to aid with editing and validation of ninjs 1.2 files in a range of popular code editors such as Visual Studio Code and Visual Studio 2013+, IntelliJ IDEA, PyCharm and PHPStorm.

For more information, please see:

• The ninjs GitHub repository
• ninjs example documents
• The ninjs User Guide
• The ninjs 1.2 JSON Schema specification
• A new interactive tool for creating example ninjs documents – the ninjs Generator

If you have any questions or comments, please contact the News in JSON Working Group via the public ninjs discussion group, or contact IPTC via the Contact Us form.