GET /site/v1/pages/{pageId}

Get a page available on www.ft.com. Provides the page id, title, apiUrl, webUrl and where applicable links to retrieve the main items of content listed on the page and the skyline items of content listed on the page.

Request

HTTP Request

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

Parameters

Parameter NameValueDescription
pageId string The id of the page to get.

Request Body

Do not supply a request body with this method.

Response

HTTP Statuses

Http StatusDescription
200 OK The resource exists and has been returned
404 Not Found The resource could not be found, but may be available in the future
410 Gone The resource no longer exists

200 OK - Page exists and has been returned

If successful, this method returns a Page Resources in a standard api response body.

{
  “requestUrl”: string,
  “page”:{
    “id”: string,
    “title”: string,
    “apiUrl”: string,
    “webUrl”: string,
    “links”: [
      {
        “href”: string,
        “rel”: string
      }
    ]
  }
}

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 UK Home Page

GET https://api.ft.com/site/v1/pages/4c499f12-4e94-11de-8d4c-00144feabdc0?apiKey=yourApiKey
{
  “requestUrl”: “https://api.ft.com/site/v1/pages/4c499f12-4e94-11de-8d4c-00144feabdc0",
  “page”:{
    “id”: “4c499f12-4e94-11de-8d4c-00144feabdc0”,
    “title”: “Front page”,
    “apiUrl”: “https://api.ft.com/site/v1/pages/4c499f12-4e94-11de-8d4c-00144feabdc0",
    “webUrl”: “https://www.ft.com/home/uk",
    “links”: [
      {
        “href”: “https://api.ft.com/site/v1/pages/4c499f12-4e94-11de-8d4c-00144feabdc0/main-content",
        “rel”: “main-content”
      },
      {
        “href”: “https://api.ft.com/site/v1/pages/4c499f12-4e94-11de-8d4c-00144feabdc0/skyline-content",
        “rel”: “skyline-content”
      }
    ]
  }
}