ninjs: News in JSON

One standard, countless use cases.

ninjs standardises the representation of news in JSON – a lightweight, easy-to-parse, data interchange format.

Almost every media organisation today is working on a project (or ten) that involves expressing the contents of a news item in JSON. From content APIs to mobile applications to document databases, JSON has moved into a position of technical prominence across the enterprise. A few years back, we went around the table at an IPTC meeting and realised nearly all of us had our own internal approaches for serialising news data in JSON. And so a standard was born. Approved and released in October 2013, ninjs provides key properties and structures required to represent news and publishing information. 

Latest Version

In October 2019, ninjs version 1.2 was approved. The JSON Schema file describing ninjs 1.2 is available from iptc.org/std/ninjs.

ninjs User Guide

Our new IPTC ninjs user guide explains how to use ninjs in your own applications, how to validate it using JSON Schema tools, gives some best practice guidelines and detailed descriptions of each property.

ninjs, NewsML-G2 and the IPTC News Architecture

The IPTC News Architecture is the underlying data model behind all of IPTC’s standards. ninjs properties conform with the equivalent elements in the News Architecture which means that it maps to NewsML-G2. The user guide shows how ninjs properties map to their equivalent NewsML-G2 elements.

Discussion Group

IPTC members regularly discuss ninjs at our News in JSON Working Group meetings and on the members-only News in JSON WG discussion group.

Non-members are welcome to discuss ninjs at the public ninjs discussion group.

GitHub repository

For tracking development of ninjs, see the ninjs GitHub repositoryhttps://github.com/iptc/newsinjson.

Feedback and reporting issues

Please leave feedback via the IPTC contact form or by raising an issue on GitHub.