GET /content/{itemId}

Get FT content by id. Currently supports access to articles that appear on www.ft.com and FastFT.

Resource URL

GET https://api.ft.com/content/{itemId}

Parameters

Parameter NameValueRequiredDefaultDescriptionExample
itemId string yes The id of the content 834ffdf2-728c-11e1-9be9-00144feab49a

Note: The identity of content can be determined in a number of ways:

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

200 OK - Resource exists and has been returned

If successful, this method returns a Content resource. Here is an example FT.com article:

{
    “id”: “http://www.ft.com/thing/ef9602b0-f807-11e3-90fa-00144feabdc0",
    “type”: “https://www.ft.com/ontology/content/Article",
    “bodyXML”: “<body><p>A new ft-content title=\“Facebook scores on hiring but misfires Slingshot chat app - FT.com\” type=\“https://www.ft.com/ontology/content/Article" url=\“https://api.ft.com/content/93e1a320-f019-11e3-9b4c-00144feabdc0">chat app</ft-content> designed for use on planes and trains is soaring in popularity in <ft-content title=\“Obama to send 300 ‘military advisers’ to Iraq - FT.com\” type=\“https://www.ft.com/ontology/content/Article" url=\“https://api.ft.com/content/975dc060-f7d5-11e3-baf5-00144feabdc0">Iraq</ft-content>, as users embrace a “private internet” where they can message each other without fear of the government shutting down access to the web.</p>\n<p>Created on an island in San Francisco bay, FireChat has been rapidly adopted in the war-torn country as the government restricts access to the internet. </p>\n<p>Iraq, where fighting continued over the weekend with security forces claiming to have killed dozens of insurgents, is now the second-largest user of the app after the US.</p>\n<p>FireChat, developed by start-up Open Garden, allows <ft-content title=\“Jihad by social media - FT.com\” type=\“https://www.ft.com/ontology/content/Article" url=\“https://api.ft.com/content/907fd41c-b53c-11e3-af92-00144feabdc0">access to messaging</ft-content> where getting on the internet is difficult, most prominently where governments are trying to control dissent by forcing people offline.</p>\n<p>The app features “mesh networking” technology that uses bluetooth to send messages from smartphone to smartphone, leapfrogging over other FireChat users’ phones to extend the distances that chats can travel. If one user is connected to the internet, everyone in the vicinity can also use that connection to browse.</p>\n<p>Christophe Daligault, vice-president of sales and marketing at <ft-content title=\“Headphones that are easy on the eyes as well as ears - FT.com\” type=\“https://www.ft.com/ontology/content/Article" url=\“https://api.ft.com/content/c03567ac-46d9-11e3-bdd2-00144feabdc0">Open Garden</ft-content>, said it was “literally growing your own internet”. He said the last week had seen a “very big jump” in Iraq, with 35,000 downloads despite there being no Apple app store in the country. </p>\n<p>“We’re amazed that so many people in Iraq managed to find the app,” he said. “There are enough users of FireChat in Baghdad now to create many local ‘intranets’. Even if no device in this local network has access to the internet, people can still exchange messages.”</p>\n<p>FireChat was originally developed as a way for people to communicate in areas with poor mobile phone reception, such as underground trains. Its anonymous chat rooms are used in the US to discuss a range of topics, with the most popular “FireChat” about the TV series <em>Game of Thrones</em>. </p>\n<p>But after its launch three months ago, it quickly gained ground in countries where the internet was blocked. Some 6,300 chat rooms were created in Iraq in the past five days, out of a total of 72,000 worldwide since the app’s launch. </p>\n<p>Iran is the third-largest country for the app, with a rash of downloads last month when the government prevented residents from using WhatsApp, the messaging app that was <ft-content title=\“https://www.ft.com/cms/s/0/44d4fc72-99b2-11e3-b3a2-00144feab7de.html?siteedition=intl" type=\“https://www.ft.com/ontology/content/Article" url=\“https://api.ft.com/content/44d4fc72-99b2-11e3-b3a2-00144feab7de">recently bought by Facebook</ft-content>. </p>\n<p>With just $2m in seed funding from angel investors including Japan’s Digital Garage, Open Garden illustrates how apps can become global businesses with little outside funding. The start-up plans to generate revenue by charging other services a cut of their profits for the extra time their users are online. </p>\n\n</body>”,
    “title”: “‘Private internet’ FireChat app grows in popularity in Iraq”,
    “byline”: “By Hannah Kuchler in San Francisco”,
    “publishedDate”: “2014-06-22T16:29:33.000Z”,
    “contentOrigin”: {
        “originatingSystem”: “https://www.ft.com/ontology/origin/FTComMethode",
        “originatingIdentifier”: “ef9602b0-f807-11e3-90fa-00144feabdc0”
    },
    “requestUrl”: “https://api.ft.com/content/ef9602b0-f807-11e3-90fa-00144feabdc0",
    “brands”: [
        “https://api.ft.com/things/dbb0bdae-1f0c-11e4-b0cb-b2227cce2b54"
    ],
    “webUrl”: “https://www.ft.com/cms/s/ef9602b0-f807-11e3-90fa-00144feabdc0.html"
}

Below is an example of FastFT content:

{
    “id”: “http://www.ft.com/thing/e22c240a-872b-38a8-8400-adef44015795",
    “type”: “https://www.ft.com/ontology/content/Article",
    “bodyXML”: “<body><p>ScottishPower has followed its rivals British Gas and Eon in cutting household gas bills in response to sharp falls in wholesale energy prices.</p>\n<p>The company, which is owned by Spain’s Iberdrola Group, said it would reduce its standard domestic gas prices by 4.8 per cent from February 20.</p>\n<p>Neil Clitheroe, ScottishPower’s chief executive of retail and generation, said:</p>\n\n\n  <p>We are pleased to be able to pass on this price reduction to our customers, which will see the average annual gas bill on our standard tariff reduce by £33.</p>\n\n<p>Today, we have also launched a new fixed-price tariff which is one of the most competitive in the marketplace, with an average dual fuel bill value of £930.</p>\n<p>British Gas yesterday <a href=\“https://on.ft.com/1BsttHn">reduced bills for its customers by 5 per cent</a>. </p>\n<p>But energy industry critics believe the cuts do not go anywhere near far enough considering the dramatic slide in oil and gas prices over the last six months.</p>\n<p>Stephen Murray of Moneysupermarket, a price comparison website, said in response to British Gas’ announcement yesterday: </p>\n\n\n<p>Just like we saw with Eon, this decrease is small in comparison to the whopping 20 per cent drop in the price of wholesale gas over the past 12 months.</p>\n</body>”,
    “title”: “ScottishPower latest to cut household gas bills”,
    “publishedDate”: “2015-01-20T10:55:20.000Z”,
    “contentOrigin”: {
        “originatingSystem”: “https://www.ft.com/ontology/origin/FT-CLAMO",
        “originatingIdentifier”: “264282”
    },
    “identifiers”: [
        {
            “authority”: “https://www.ft.com/ontology/origin/FT-CLAMO",
            “identifierValue”: “264282”
        }
    ],
    “requestUrl”: “https://api.ft.com/content/e22c240a-872b-38a8-8400-adef44015795",
    “brands”: [
        “https://api.ft.com/things/5c7592a8-1f0c-11e4-b0cb-b2227cce2b54",
        “https://api.ft.com/things/dbb0bdae-1f0c-11e4-b0cb-b2227cce2b54"
    ],
    “webUrl”: “https://www.ft.com/fastft?post=264282"
}

See Content resource for full details of these fields.

404 Not Found - The resource could not be found, but may be available in the future

If the content with that id does not exist this method returns a standard api error response body

{
    “message”: “the supplied uuid is invalid”
}