For Developers

Commence Making Requests

Previous:

• Install Postman and Import Request Collection

This page:

The following steps outline the necessary actions in order for you to commence making FT API requests

Note: Please Submit a Sales Enquiry if your organisation wishes to discuss purchasing a licence to retrieve content from the FT APIs.

• In Postman, click Collections
• Click Headline License to reveal the list of stored requests available in the Search endpoint folder
• Click POST Search 1: queryString={Banks}, resultContext={Aspects}
• Click Send to POST the request

Request Type

POST

Request URL

https://api.ft.com/content/search/v1?

Request Header

X-Api-Key=yourApiKey
Content-Type=application/json

Request Body

{
    “queryString”: “banks”,
    “resultContext” : {
         “aspects” :[  “title”,“lifecycle”,“location”,“summary”,“editorial” ]
    }
}

Response

{
    “query”: {
        “queryString”: “banks”,
        “queryContext”: {
            “curations”: [
                “ARTICLES”,
                “BLOGS”,
                “PAGES”,
                “PODCASTS”,
                “VIDEOS”
            ]
        },
        “resultContext”: {
            “maxResults”: 100,
            “offset”: 0,
            “contextual”: false,
            “highlight”: false,
            “suppressDefaultSort”: false
        }
    },
    “results”: [
        {
            “indexCount”: 252090,
            “curations”: [
                “ARTICLES”,
                “PAGES”,
                “PODCASTS”,
                “VIDEOS”
            ],
            “results”: [
                {
                    “aspectSet”: “article”,
                    “modelVersion”: “1”,
                    “id”: “4d8f9536-82e6-11e7-a4ce-15b2513cb3ff”,
                    “apiUrl”: “https://api.ft.com/content/items/v1/4d8f9536-82e6-11e7-a4ce-15b2513cb3ff"
                },
                {
                    “aspectSet”: “page”,
                    “modelVersion”: “1”,
                    “id”: “ed6b120a-f7e3-11df-8d91-00144feab49a”
                }
            ]
        }
    ]
}

Investigate Further:

Now investigate and test the following additional Postman stored Headline License requests:

• POST Search 2: queryString={Trump AND Clinton}, curations={Articles}
  • This will search for content that mentions Trump in any of the searchable fields, but where the headline (title) contains Clinton
• POST Search 3: queryString={British Telecom}, facets={Organisations}
  • Find what tag is used for British Telecom. Search for relevant content and ask the search to show details found in the results
• POST Search 4: queryString={Apple AND lastPublishDateTime}, curations={Blogs}
  • Search for blogs that mention Apple and have been published this year
• POST Search 5: queryString={Byline AND lastPublishDateTime}, curations={Artcles}
  • Search for byline Martin Wolf published since 2017
• POST Search 6: queryString={Banks}, sortOrder={Desc}
  • Sort by date (most recent first)

Next:

• Explore FT API Endpoints