For Developers

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

Relative to the base URI: https://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

Metadata Term Properties

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