API Reference

Quick Start Guides

 

The API reference section contains information on all aspects of the APIs irrespective of your access rights. To help you getting started using your key we have prepared Quick Start documents for the following licence types:

Noticed anything incorrect or missing? Please contact us to report this.

Connect to FT APIs

All your requests to any FT API should use the following base URL:

http://api.ft.com

You must supply a valid API Key with each request. This should be done with an X-Api-Key request header:

X-Api-Key: yourApiKey

Your API key identifies your application as a legitimate user of the FT API. It may only be shared in accordance with the terms of your license.

In particular, you must not include your API key in any app, Web site or script which is served to unlicensed users. For example, if you are building a browser-based app, the browser should only make requests to a service under your control, which would be responsible for authorizing the app, making FT API calls as necessary, and building an appropriate response.

Your API key may be throttled if it makes too many requests. To ensure your application continues to function, you should agree an appropriate traffic level with us beforehand, taking into account any opportunities you will have to cache data. 

You can also supply an API key in a query parameter apiKey

GET /{endpoint}/?apiKey=yourApiKey

If you use this method, you should make sure your client correctly supplies this parameter to all requests, including in response to redirects.

 

If you want specific guidance on how best to use the FT API in your application, please get in touch with us 

 

Content API v2 Reference

The second version of the FT's Content API  provides access to information about FT articles, blog posts and FastFT posts. A change feed provides a way to find new content as it is published.

We do not expect to make changes that break existing integrations, but you should make sure your code is flexible, for example able to cope with new fields being included in responses.

Content Items

For content item resource details, see Content Items

 

 

 

ResourceDescription
GET /content/{itemId} Get an item of content.

 

 

 


Content Notifications

For notifications resource details, see Content Notifications

 

 

 

ResourceDescription
GET /content/notifications Get a list of content that has been created, changed or deleted.

 

Content Search

ResourceDescription
POST /content/search/v1 Search all items of content. This will return a list of content items. Some item properties are not available using this method. Full details can be retrieved using the get method for a particular item of content.

Note: although the endpoint for this API contains "v1", we are extending its life so it will continue to function after the other v1 endpoints (see below) are removed. You can continue using this API for existing and new projects.


Search Tutorial

Search is a flexible and powerful tool for finding FT content. For full details of how to use it, see the Search Tutorial.

 

 

 

Content API v1 (deprecated) 

The first version of the FT's Content API provides access to articles, slideshows and blog posts. Content can be found for specific pages, or via a flexible search. A notifications feed provides a way to find new content as it is published.

This version of the API is deprecated and should not be used for new projects. We are expecting to remove access to these endpoints at the end of May 2017.

Content Items

For content item resource details, see Content Items

 

 

ResourceDescription
GET /content/items/v1/{itemId} Get an item of content.

 

 

 


Content Items Notification (v1, deprecated)

For Content Items Notification resource details, see Content Items Notification Resource Representation.

 

 

ResourceDescription
GET /content/notifications/v1/items Get a list of content items that have been created, changed or deleted.

 

 

 


Pages (deprecated)

For page resource details, see Page Resource Representation.

 

 

ResourceDescription
GET /site/v1/pages List all pages available on www.ft.com. For full details of a specific page, use the get method for a page.
GET /site/v1/pages/{pageId} Get a page available on www.ft.com.

 

 

 


Page Items (deprecated)

For page item Resource details, see Page Item Resource Representation.

 

 

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

 

 

 

 

 

 



Docs Navigation