# title
IPTC ninjs - News in JSON - version 2.1 (approved at IPTC Standards Committee May 2023)

# description
A news item as JSON object -- copyright 2023 IPTC - International Press Telecommunications Council - www.iptc.org - This document is published under the Creative Commons Attribution 4.0 license, see  http://creativecommons.org/licenses/by/4.0/

# $defs.contactinfoType.properties.type.description
Type would be method of communication like phone, mobile, address etc.

# $defs.contactinfoType.properties.address.description
The address of a person, place or organisation.

# $defs.contactinfoType.properties.address.properties.area.description
A subdivision of a country part of the address.

# $defs.contactinfoType.properties.address.properties.lines.description
An array of lines to construct an address. The order is important to construct a correct address.

# $defs.contactinfoType.properties.address.properties.locality.description
A city/town/village etc. part of the address.

# $defs.contactinfoType.properties.lang.description
If this contactinfo object need to be qualified with what language it is in. The value should follow IETF BCP47.

# $defs.contactinfoType.properties.name.description
Human readable name of the contact method, like name for a web page, name of persons twitter account etc

# $defs.contactinfoType.properties.role.description
Role refers to type and could be private, office etc

# $defs.contactinfoType.properties.value.description
Actual phone number, email address, web url etc.

# $defs.ninjsType.description
The root schema of ninjs as a type to make it possible to combine schema parts.

# $defs.ninjsType.properties.title.description
A short natural-language name for the item. Title is metadata, use headlines for publishable headlines. (Added in version 1.2 according to issue #9). nar:itemMeta/title

# $defs.ninjsType.properties.type.description
The generic news type of this news object. (Value 'component' added in version 1.2 as issue #21.). See: http://cv.iptc.org/newscodes/ninature/ nar:itemClass

# $defs.ninjsType.properties.altids.description
Alternative identifiers assigned to the content. Each alternative id can have a role and a value. nar:altId issue #3.

# $defs.ninjsType.properties.associations.description
An array of objects with content of news objects which are associated with this news object.

# $defs.ninjsType.properties.associations.items.description
Each associated object can use all properties in ninjs.

# $defs.ninjsType.properties.associations.items.properties.name.description
Human-readable name of the associated object.

# $defs.ninjsType.properties.bodies.description
An array of body objects with the content as text or with markup. For a simple body use an array with one object only containing the value property. Role and contenttype are then undefined and it is up to the provider.

# $defs.ninjsType.properties.bodies.items.properties.charcount.description
The total character count in this body excluding figure captions. (Added in version 1.2 according to issue #27.). nar:charcount

# $defs.ninjsType.properties.bodies.items.properties.contenttype.description
The IANA (Internet Assigned Numbers Authority) media type of the content of this body. Used to be called MIME type.

# $defs.ninjsType.properties.bodies.items.properties.value.description
The body text identified with the above role and contenttype.

# $defs.ninjsType.properties.bodies.items.properties.wordcount.description
The total number of words in this body excluding figure captions. (Added in version 1.2 according to issue #27.). nar:wordcount

# $defs.ninjsType.properties.by.description
A natural-language statement about the creator (author, photographer etc.) of the content. nar:by

# $defs.ninjsType.properties.contentcreated.description
The date and time when the content of this ninjs object was originally created. For example an old photo that is now handled as a ninjs object. nar:contentCreated

# $defs.ninjsType.properties.copyrightholder.description
The person or organisation claiming the intellectual property for the content. nar:copyrightHolder

# $defs.ninjsType.properties.copyrightnotice.description
Any necessary copyright notice for claiming the intellectual property for the content. nar:copyrightNotice

# $defs.ninjsType.properties.descriptions.description
An array of one or more descriptions of the ninjs object. See also ednote for information from provider to reciever. Descriptions are seen as metadata. For a simple description use an array with one object only containing the value property. Role and contenttype are then undefined and it is up to the provider.

# $defs.ninjsType.properties.descriptions.items.properties.contenttype.description
The IANA (Internet Assigned Numbers Authority) media type of the content of this description. Used to be called MIME type.

# $defs.ninjsType.properties.descriptions.items.properties.value.description
The descriptive text identified with the above role (and contenttype).

# $defs.ninjsType.properties.ednote.description
A note that is intended to be read by internal staff at the receiving organisation, but not intended to be published. (Added in version 1.2 from issue #6.). (Consider using this before using the descriptions array.) ednote: nar:edNote

# $defs.ninjsType.properties.embargoed.description
The date and time before which all versions of the news object are embargoed. If absent, this object is not embargoed. nar:embargoed

# $defs.ninjsType.properties.events.description
An array of objects describing something which happens in a planned or unplanned manner. nar:?

# $defs.ninjsType.properties.events.items.properties.literal.description
An identifier for the event as a free-text string.

# $defs.ninjsType.properties.events.items.properties.rel.description
The relationship of the content of the news object to the event

# $defs.ninjsType.properties.events.items.properties.uri.description
The identifier for the event as a complete uri

# $defs.ninjsType.properties.expires.description
The date and time after which the Item is no longer considered editorially relevant by its provider. nar:expires (Added in 2.1)

# $defs.ninjsType.properties.firstcreated.description
Indicates when the first version of this ninjs object was created. (Added in version 1.2 from issue #5). nar:firstCreated

# $defs.ninjsType.properties.genres.description
A nature, intellectual or journalistic form of the content. nar:genre. (Added in version 1.3)

# $defs.ninjsType.properties.genres.items.properties.literal.description
An identifier for the genre as a free-text string.

# $defs.ninjsType.properties.genres.items.properties.uri.description
The identifier of  the genre as a complete uri

# $defs.ninjsType.properties.headlines.description
An array of objects containing various types of headlines. For a simple headline use an array with one object only containing the value property. Role and contenttype are then undefined and it is up to the provider.

# $defs.ninjsType.properties.headlines.items.properties.contenttype.description
The IANA (Internet Assigned Numbers Authority) media type of the content of this headline. Used to be called MIME type.

# $defs.ninjsType.properties.headlines.items.properties.value.description
The headline identified with the above role and contenttype.

# $defs.ninjsType.properties.infosources.description
An array of parties (person or organisation) which originated, modified, enhanced, distributed, aggregated or supplied the content or provided some information used to create or enhance the content. (Added in version 1.2 according to issue #15.) .    infosource:  nar:infoSource

# $defs.ninjsType.properties.infosources.items.properties.literal.description
An identifier for the infosource as a free-text string.

# $defs.ninjsType.properties.infosources.items.properties.role.description
The role the infosource in relationship to the content as a uri.

# $defs.ninjsType.properties.infosources.items.properties.uri.description
The identifier of the infosource as a complete uri

# $defs.ninjsType.properties.language.description
The human language used by the content. The value should follow IETF BCP47. nar:language

# $defs.ninjsType.properties.located.description
The name of the location from which the content originates. nar:located

# $defs.ninjsType.properties.objects.description
An array of objects describing something material, excluding persons. nar:subject

# $defs.ninjsType.properties.objects.items.properties.literal.description
An identifier for the object as a free-text string.

# $defs.ninjsType.properties.objects.items.properties.rel.description
The relationship of the content of the news object to the object

# $defs.ninjsType.properties.objects.items.properties.uri.description
The identifier for the object as a complete uri

# $defs.ninjsType.properties.organisations.description
An array of objects describing administrative and functional structures which may, for example, act as a business, as a political party or not-for-profit party. nar:subject

# $defs.ninjsType.properties.organisations.items.properties.literal.description
An identifier for the organisation as a free-text string.

# $defs.ninjsType.properties.organisations.items.properties.rel.description
The relationship of the content of the news object to the organisation

# $defs.ninjsType.properties.organisations.items.properties.symbols.description
Symbols used for a financial instrument linked to the organisation at a specific market place

# $defs.ninjsType.properties.organisations.items.properties.symbols.items.properties.exchange.description
Identifier for the marketplace which uses the ticker symbols of the ticker property

# $defs.ninjsType.properties.organisations.items.properties.symbols.items.properties.symbol.description
Compare with hasInstrument in NewsML-G2. Same as symbol in G2.

# $defs.ninjsType.properties.organisations.items.properties.symbols.items.properties.ticker.description
Ticker symbol used for the financial instrument

# $defs.ninjsType.properties.organisations.items.properties.uri.description
The identifier of the organisation as a complete uri

# $defs.ninjsType.properties.people.description
An array of objects describing individual human beings. nar:subject

# $defs.ninjsType.properties.people.items.properties.literal.description
An identifier for the person as a free-text string.

# $defs.ninjsType.properties.people.items.properties.rel.description
The relationship of the content of the news object to the person

# $defs.ninjsType.properties.people.items.properties.uri.description
The identifier for the person as a complete uri with the code.

# $defs.ninjsType.properties.places.description
An array of named locations. nar:subject

# $defs.ninjsType.properties.places.items.properties.literal.description
An identifier for the place as a free-text string.

# $defs.ninjsType.properties.places.items.properties.rel.description
The relationship of the content of the news object to the place

# $defs.ninjsType.properties.places.items.properties.uri.description
The identifier for the place as a complete uri

# $defs.ninjsType.properties.profile.description
An identifier for the structure of the news object. This can be any string but we suggest something identifying the structure of the content such as 'text-only' or 'text-photo'. Profiles are typically provider-specific. nar:profile

# $defs.ninjsType.properties.pubstatus.description
The publishing status of the news object, its value is *usable* by default. nar:pubStatus

# $defs.ninjsType.properties.renditions.description
An array of objects with different renditions of the news object. nar:remoteContent

# $defs.ninjsType.properties.renditions.items.description
A specific rendition of the content of the news object. (Description changed in version 1.2 according to issue #17.)

# $defs.ninjsType.properties.renditions.items.properties.title.description
A title for the link to the rendition resource

# $defs.ninjsType.properties.renditions.items.properties.format.description
A refinement of a generic content type (i.e. IANA media type) by a literal string value. nar:remoteContent@contenttypevariant and nar:remoteContent@format

# $defs.ninjsType.properties.renditions.items.properties.contenttype.description
A media type which applies to this rendition. nar:remoteContent@contenttype

# $defs.ninjsType.properties.renditions.items.properties.duration.description
The total time duration of the content in seconds. (Added in version 1.2. Issue #18). nar:remoteContent@duration

# $defs.ninjsType.properties.renditions.items.properties.height.description
For still and moving images: the height of the display area measured in pixels. nar:remoteContent@height

# $defs.ninjsType.properties.renditions.items.properties.href.description
The URL for accessing the rendition as a resource. nar:remoteContent@ref

# $defs.ninjsType.properties.renditions.items.properties.name.description
The name of this object in the array of renditions. For example 'thumbnail'

# $defs.ninjsType.properties.renditions.items.properties.sizeinbytes.description
The size of the rendition resource in bytes

# $defs.ninjsType.properties.renditions.items.properties.width.description
For still and moving images: the width of the display area measured in pixels. nar:remoteContent@width

# $defs.ninjsType.properties.representationtype.description
Indicates how complete this representation of a news item is. No mapping to nar. Specific for ninjs.

# $defs.ninjsType.properties.rightsinfo.description
Expression of rights to be applied to content. nar:rightsInfo

# $defs.ninjsType.properties.rightsinfo.properties.encodedrights.description
Contains a rights expression as defined by a Rights Expression Language. nar:rightsExpressionXML or nar:rightsExpressionData

# $defs.ninjsType.properties.rightsinfo.properties.langid.description
Identifier for the Rights Expression language used. nar:@langid

# $defs.ninjsType.properties.rightsinfo.properties.linkedrights.description
A link from the current Item to Web resource with rights related information. nar:link

# $defs.ninjsType.properties.slugline.description
A human-readable identifier for the item. (Added in version 1.2 from issue #4.). nar:slugline

# $defs.ninjsType.properties.standard.description
An object with information about standard, version and schema this instance is valid against. nar:standard, nar:standardversion and xml:schema issue #43. (Added in version 1.3)

# $defs.ninjsType.properties.standard.properties.schema.description
The uri of the json schema to use for validation.

# $defs.ninjsType.properties.subjects.description
An array of objects holding concepts with a relationship to the content. nar:subject

# $defs.ninjsType.properties.subjects.items.properties.confidence.description
The confidence with which the metadata has been assigned.

# $defs.ninjsType.properties.subjects.items.properties.creator.description
Specifies which entity (person, organisation or system) that has created or last edited the property.

# $defs.ninjsType.properties.subjects.items.properties.literal.description
An identifier for the subject as a free-text string.

# $defs.ninjsType.properties.subjects.items.properties.rel.description
The relationship of the content of the news object to the subject

# $defs.ninjsType.properties.subjects.items.properties.relevance.description
The relevance of the metadata to the news content to which it is attached.

# $defs.ninjsType.properties.subjects.items.properties.uri.description
The identifier of the subject as a complete uri

# $defs.ninjsType.properties.trustindicators.description
An array of objects to allow links to documents about trust indicators. issue #44. (Added in version 1.3)

# $defs.ninjsType.properties.trustindicators.items.properties.title.description
The title of the resource being referenced.

# $defs.ninjsType.properties.trustindicators.items.properties.href.description
The URL for accessing the trust indicator resource.

# $defs.ninjsType.properties.trustindicators.items.properties.role.description
The role of the trust indicator as a complete uri

# $defs.ninjsType.properties.urgency.description
The editorial urgency of the content. Values from 1 to 9. 1 represents the highest urgency, 9 the lowest. nar:urgency

# $defs.ninjsType.properties.uri.description
The global unique identifier for this news object. This is the only required property and should identify the ninjs object, not be used for links to external resources etc.  nar:newsItem@guid

# $defs.ninjsType.properties.usageterms.description
A natural-language statement about the usage terms pertaining to the content. nar:usageTerms

# $defs.ninjsType.properties.version.description
The version of the news object which is identified by the uri property. nar:newsItem@version

# $defs.ninjsType.properties.versioncreated.description
The date and time when this version of this ninjs object was created. nar:versionCreated