GET /site/v1/pages/{pageId}/main-content

List the main page items available on a published www.ft.com page.

Request

HTTP Request

GET https://api.ft.com/site/v1/pages/pageId/main-content

Parameters

Parameter Name	Value	Description
`pageId`	string	The id of the page.
`feature.blogposts`	string	Allows to enable or disable filtering of blogPosts from the response. Valid values are ‘on’ or ‘off’.

Request Body

Do not supply a request body with this method.

Response

HTTP Statuses

HTTP Status	Description
200 OK	Page exists and list of associated main page items has been returned
404 Not Found	Page does not exist
410 Gone	Page no longer exists

200 OK - Page exists and list of associated main page items has been returned

If successful, this method returns a list of page item resources, a subset of the page resource and the name of the page item list (e.g. main-content) in a standard api response body.

{
  “requestUrl”: string,
  “total”: number,
  “page”: {
        “id”: string,
        “title”: string,
        “apiUrl”: string,
        “webUrl”: string
  },
  “pageItemsListName”: string,
  “pageItems”: [
    {
      “title”: {
        “title”: string
      },
      “lifecycle”: {
        “initialPublishDateTime”: datetime,
        “lastPublishDateTime”: datetime
      },
      … see page item resource representation for full details …
    }
  ]
}

404 Not Found - Page does not exist

If the page does not exist this method returns a standard api error response body

{
  “requestUrl”: string,
  “message”: string
}

410 Gone - Page no longer exists

If the page does not exist this method returns a standard api error response body

{
  “requestUrl”: string,
  “message”: string
}

Example

E.g. Retrieve the main content from the UK Home Page

GET https://api.ft.com/site/v1/pages/4c499f12-4e94-11de-8d4c-00144feabdc0/main-content?apiKey=yourApiKey

{
  “requestUrl”: “https://api.ft.com/site/v1/pages/4c499f12-4e94-11de-8d4c-00144feabdc0/main-content",
  “total”: 10,
  “page”:{
      “ id”: “8e082a2a-2edc-11e0-9877-00144feabdc0”,
      “ title”: “adventures”,
      “apiUrl”: “https://api.ft.com/site/v1/pages/8e082a2a-2edc-11e0-9877-00144feabdc0",
       “webUrl”: “https://www.ft.com/cms/8e082a2a-2edc-11e0-9877-00144feabdc0.html"
  },
  “pageItemsListName”: “main-content”,
  “pageItems”: [
    {
      “title”: {
        “title”: “Whistleblowers drawn by tip-off payouts”
      },
      “lifecycle”: {
        “initialPublishDateTime”: “2012-03-12T21:33:01.000Z”,
        “lastPublishDateTime”: “2012-03-12T21:33:01.000Z”
      },
      …
    }
  ]
}