Enriched Content

An enriched content item, for example an FT article, is represented in the API as a JSON data structure (shown below) that is received in the body of a response for a successful request.

{
    "id": string,
    "type": string,
    "bodyXML": string,
    "title": string,
    "standfirst": string,

    "byline": string,
        "firstpublishedDate": datetime, 
        "publishedDate": datetime,
    "requestUrl": string,
    "brands": [
            string
    ],
    "standout":
        "canbeSyndicated":
        "apiUrl": string,
        "prefLabel": string,
    "types": [
            string,
    ],    
    "annotations": [
            string,
    ],
    "curatedRelatedContent": [
            string,
    ],
    "webUrl": string
}

Enriched Content Properties

Property Name	Value	Description
`id`	string	The unique identifier for the content
`type`	string	The type of this content. Currently only "https://www.ft.com/ontology/content/Article" is supported.
`bodyXML`	string	The body of the content. HTML-compatible XML, enclosed in a <body> tag. This property is not present for live blog article content.
`title`	string	The title of the content. For articles this is the main headline
`standfirst`	string	TBC
`byline`	string	The author(s) of the content
`firstpublishedDate`	datetime	The date and time the content was first published on www.ft.com, formatted as a string in ISO 8601 format
`publishedDate`	datetime	The date and time the content was last published on www.ft.com, formatted as a string in ISO 8601 format
`requestUrl`	string	The URL for the request made to retrieve this content.
`brands`	string	A list of URIs that represent the content's brand(s)
`realtime`	boolean	`true` indicates that the content is experienced by the consumer in realtime, such as a live blog post, and the body of the content is not present. For other content this property is not present.
`standout`	boolean	Can be "exclusive", "scoop" and "editorsChoice". They indicate that the content is worthy of special attention. "Scoop" identifies news that is not yet reported by any other media organisations, which only the FT has knowledge of and and is breaking ahead of other news providers. "Exclusive" identifies content only available through the FT (eg interview, comment). Not necessarily a scoop and can be about an event or subject that has been previously reported."EditorsChoice" identifies journalism that our Editorial team wish to highlight because it is worthy of special attention.
`canbeSyndicated`	string	Can be "yes", "no" or "verify". If "yes" then if you have a syndication agreement with the FT then this content may be available to syndicate, subject to the conditions of the agreement. If "no" then you can't, even if you have a syndication agreement. If "verify", then it may be available to syndicate, but there are extra restrictions or additional payment requirements, and you should contact the FT to find out what these are.
`apiUrl`	string	The URL of the content in the API.
`prefLabel`	string	The title of the content. For articles this is the main headline.
`types`	string	A list of content types shown in hierarchy. E.g. https://www.ft.com/ontology/content/Article.
`annotations`	string	Annotations are data about the content intended to describe its subject matter. (might need expanding).
`curatedRelatedContent`	string	A list of other related content that the editorial team consider particularly pertinent.
`webUrl`	string	The URL of the content on FT.com website.

Body XML

The body is supplied as HTML-compatible XML. The following HTML tags may be included in the structured body.

Text Formatting

The following markup is currently supported in the body of FT content:

HTML Tag	Description
`<h1>`to `<h6>`	Headings
`<br>`	Line breaks
`<strong>`	Strong text
`<u>`	Underlined text
`<em>`	Emphasised text
`<del>`	Defines text that has been deleted
`<sub>`	Subscript
`<sup>`	Superscript

Block Elements

The following block elements are supported:

HTML Tag	Description
`<ol>`, `<ul>` and `<li>`	Ordered lists, unordered lists and list items
`<p>`	Paragraphs
`<blockquote>`	Specifies a section that is quoted

Links to FT Content

Links to FT content represented by a element are those which are currently available via API v2.

Example:

<ft-content title="Bankrupt Energy Future Holdings’ value surges - FT.com" type="https://www.ft.com/ontology/content/Article" url="https://api.ft.com/content/8bb0966a-0a9b-11e4-ac2a-00144feabdc0">Energy Future Holdings</ft-content>

The url attribute provides access to that content in the API (when used with a valid API Key).