Page Items

Page Items is a collection of page item resources, each of which represents an item of content as it appears in page listings on the www.ft.com. Page Items methods enable your application to retrieve a list of the main-content or skyline-content that appears on published pages.

Methods

MethodREST URI Description
main-content GET /site/v1/pages/{pageId}/main-content List of the main page items available on a published www.ft.com page
skyline-content GET /site/v1/pages/{pageId}/skyline-content List of the skyline page items available on a published www.ft.com page

Relative to the base URI: http://api.ft.com

Page Item Resource Representation

A page item is represented in the FT API as a JSON data structure, as shown below, that is received in the body of a response. This representation is the set of all possible fields a page item can contain.

{
  “title”: {
    “title”: string
  },
  “lifecycle”: {
    “initialPublishDateTime”: datetime,
    “lastPublishDateTime”: datetime
  },
  “location”: {
    “uri”: string
  },
  “editorial”: {
    “subheading”: string,
    “leadBody”: string,
    “standFirst”: string,
    “byline”: string
  },
  “metadata”: {
    “primarySection”: {
      “term”: {
        “name”: string,
        “id”: string,
        “attributes”:[
          {
            “key” : string
            “value” : string
          }
        ],
        “taxonomy”: string
      }
    },
    “primaryTheme”: {
      “term”: {
        “name”: string,
        “id”: string,
        “attributes”:[
          {
            “key” : string
            “value” : string
          }
        ],
        “taxonomy”: string
      }
    },
    “tags”: [
      {
        “term”: {
          “name”: string,
          “id”: string,
          “attributes”: [
            {
              “key” : string
              “value” : string
            }
          ],
          “taxonomy”: string
        }
      }
    ] ,
    “brand”: [
      {
        “term”: {
          “name”: string,
          “id”: string,
          “taxonomy”: string
        }
      }
    ],
    “genre”: [
      {
        “term”: {
          “name”: string,
          “id”: string,
          “taxonomy”: string
        }
      }
    ],
    “icb”: [
      {
        “term”: {
          “name”: string,
          “id”: string,
          “taxonomy”: string
        }
      }
    ],
    “iptc”: [
      {
        “term”: {
          “name”: string,
          “id”: string,
          “taxonomy”: string
        }
      }
    ],
    “mediaType”: [
      {
        “term”: {
          “name”: string,
          “id”: string,
          “taxonomy”: string
        }
      }
    ],
    “organisations”: [
      {
        “term”: {
          “name”: string,
          “id”: string,
          “attributes”: [
            {
              “key” : wsod_key
              “value” : string
            },
            {
              “key” : is_company
              “value” : string
            }
          ],
          “taxonomy”: string
        }
      }
    ],
    “people”: [
      {
        “term”: {
          “name”: string,
          “id”: string,
          “taxonomy”: string
        }
      }
    ],
    “regions”: [
      {
        “term”: {
          “name”: string,
          “id”: string,
          “taxonomy”: string
        }
      }
    ],
    “sections”: [
      {
        “term”: {
          “name”: string,
          “id”: string,
          “taxonomy”: string
        }
      }
    ],
    “specialReports”: [
      {
        “term”: {
          “name”: string,
          “id”: string,
          “taxonomy”: string
        }
      }
    ],
    “subjects”: [
      {
        “term”: {
          “name”: string,
          “id”: string,
          “taxonomy”: string
        }
      }
    ],
    “topics”: [
      {
        “term”: {
          “name”: string,
          “id”: string,
          “taxonomy”: string
        }
      }
    ]
  },
  “images”: [
    {
      “url”: string,
      “type”: string,
      “source”: string,
      “alt”: string,
      “caption”: string,
      “height”: number,
      “width”: number,
      “mediaType”: string
    }
  ]
  “links”: [
    {
      “href”: string,
      “rel”: string,
    }
  ]
}

Page Item Properties

Property NameValueDescription
title object The title aspect
title.title string The title of the item
lifecycle object The lifecycle aspect
lifecycle.initialPublishDateTime datetime The date and time the item was first published on www.ft.com, formatted as ISO 8601 format string
lifecycle.lastPublishDateTime datetime The date and time the item was last published on www.ft.com, formatted as ISO 8601 format string
location object The location aspect
location.uri string The URL to view this item on www.ft.com
editorial object The editorial aspect
editorial.subheading string A short summary of content regarding the item. Typically available for ‘News’ content and 6 to 10 words long.
editorial.leadBody string A short summary of content regarding the item. 140 characters max.
editorial.standFirst string A short summary of content regarding the item. Typically available for ‘Comment’ or ‘Analysis’ content, 15 to 20 words and 98 characters max.
editorial.byline string The author(s) of the item
metadata object The metadata aspect
metadata.primarySection object The primary section this item is associated with
metadata.primarySection.term object The primary section term this item is associated with. See Metadata Term Properties below.
metadata.primaryTheme object The primary theme this item is associated with
metadata.primaryTheme.term object The primary theme term this item is associated with. See Metadata Term Properties below.
metadata.tags[] list The list of tags this item has been tagged with
metadata.tags[].term object The metadata term this item has been tagged with. See Metadata Term Properties below.
metadata.brand[] list A list of brand metadata this item of content has been tagged. Brand metadata defines the brands used in the FT’s content, which includes all of our regular columns and microsites/sections. For example: Martin Wolf, FT Alphaville
metadata.brand[].term object A brand metadata term this item of content has been tagged with. See Metadata Term Properties below.
metadata.genre[] list A list of genre metadata this item of content has been tagged with. Genre metadata indicates the journalistic characteristic of the content. For example: News, Comment, Review.
metadata.genre[].term object A genre metadata term this item of content has been tagged with. See Metadata Term Properties below.
metadata.icb[] list A list of ICB metadata this item of content has been tagged with. The Industry Classification Benchmark is a definitive system used to classify publicly listed companies into their respective industry sectors. For example: 8770 Financial Services, 5500 Media.
metadata.icb[].term object An icb metadata term this item of content has been tagged with. See Metadata Term Properties below.
metadata.iptc[] list A list of IPTC metadata this item of content has been tagged with. The IPTC (defined by the International Press Telecommunications Council) is a subject classification for news stories widely used within the news industry. For example: 04008020 - credit and debt, 04008023 - financial markets.
metadata.iptc[].term object An iptc metadata term this item of content has been tagged with. See Metadata Term Properties below.
metadata.mediaType[] list A list of mediaType metadata this item of content has been tagged with. MediaType metadata defines at a broad level the media type of the content. For example: Video, Slideshow.
metadata.mediaType[].term object A mediaType metadata term this item of content has been tagged with. See Metadata Term Properties below.
metadata.organisations[] list A list of Organisation metadata this item of content has been tagged with. Organisation metadata is a controlled list of public and private companies as well as business and political organisations. For example: ThyssenKrupp AG, Bank of England. For Organisation metadata that relates to companies, the WSOD key for that company will be included.
metadata.organisations[].term object An organisation metadata term this item of content has been tagged with. See Metadata Term Properties below.
metadata.people[] list The list of people metadata this item of content has been tagged with. People metadata is a controlled list of notable people mentioned within news content. For example: Gordon Brown.
metadata.people[].term object A person metadata term this item of content has been tagged with. See Metadata Term Properties below.
metadata.regions[] list The list of region metadata this item of content has been tagged with. Region metadata is a hierarchical list of geographical areas covering commonly understood regions, countries and continents. For example: United Kingdom, Greece, London, Europe.
metadata.regions[].term object A region metadata term this item of content has been tagged with. See Metadata Term Properties below.
metadata.sections[] list The list of section metadata this item of content has been tagged with. Sections metadata is a list of categories that correspond to FT.com’s website sections. For example: World, Global Economy.
metadata.sections[].term object A section metadata term this item of content has been tagged with. See Metadata Term Properties below.
metadata.specialReports[] list The list of specialReport metadata this item of content has been tagged with. Special Reports metadata is a list of special reports written by the FT. For example: Energy 2012, Arab World: Banking and Finance.
metadata.specialReports[].term object A specialReports metadata term this item of content has been tagged with. See Metadata Term Properties below.
metadata.subjects[] list The list of subject metadata this item of content has been tagged with. Subject metadata is a hierarchical taxonomy of business and world news subjects, devised by the FT, and used to broadly categorise news content. For example: Mergers & Acquisitions
metadata.subjects[].term object A subject metadata term this item of content has been tagged with. See Metadata Term Properties below.
metadata.topics[] list The list of topic metadata this item of content has been tagged with. Topic metadata is a more volatile list of topical news subjects that reflects the current news agenda. For example: If Greece goes…, Lehman Brothers collapse.
metadata.topics[].term object A topic metadata term this item of content has been tagged with. See Metadata Term Properties below.
images[] list The images aspect containing a list of images associated with this item. See Image Properties below.
links[] list A list of links associated with this page item.
links[].href string The target URI of the link
links[].rel string The relationship the target resource has with this page item. Currently supported relation types are :  content-item - A link to the corresponding content item. There will only be 1 link of this type.

Metadata Term Properties

Property NameValueDescription
id string The id of the metadata term
name string The name of the metadata term
attributes[] list Attributes relating to the metadata term
attributes[].key string The attribute key
attributes[].value string The attribute value
taxonomy string The taxonomy the metadata term belongs to

For organisations metadata, there are two specific attributes:

  • is_company - “true” for an organisation that is a company, “false” otherwise
  • wsod_key - the Wall Street on Demand key for this company. Example: “uk:VOD”. Attribute only present when there’s a value.

Image Properties

Property Name Value Description
url string The URL to retrieve the image shown for this item
type string The image type (i.e. ‘primary’, ‘secondary’, ‘inline’)
source string The originating source
caption string The caption text for the image
alt string The alt text for the image
height number The height of the image in pixels
width number The height of the image in pixels
mediaType string The media type of the image, e.g. image/jpeg