News API

The News API provides real-time and historical access to global news content at scale.

The default method of authentication against all Intelligence Fusion APIs is done through a stateless JWT token provided as an Authorization: Bearer header. The documentation below provides support for creating user tokens for user initiated communication and application tokens for machine to machine communication.

Servers

  • Production: https://news.intelligencefusion.co.uk
  • Staging: https://news.staging.intelligencefusion.co.uk

GET /news Get news

This endpoint gets all available news items. The news items returned can be filtered in scope by adding query parameters to your request.

HTTP Request

curl -X GET 'https://news.intelligencefusion.co.uk/news' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {{YOUR_AUTHENTICATION_TOKEN}}' \
  -d 'search=eq:rockets' \
  -d 'countryCode=in:AFG,IND,KOR' \
  -d 'taxonomyId=in:8cfb8d8a-cd8c-41d8-8a58-da149c874e9b' \
  -d 'publishedAt=lte:162515530' \
  -d 'sort=publishedAt_desc' \
  -d 'limit=200' \
  -d 'page=30' \
  --compressed

Headers

Name Type Required Description
Authorization string ✔️ Your authentication token (see the Auth API section for more information)

Query Parameters

Name Type Filter Description
search string eq/neq A search term against the title and summary of news items
countryCode string in/nin A comma separated list of 3 Alpha-3 country codes
taxonomyId string in/nin A comma separated list of Taxonomy UUIDs
publishedAt string bt / gte / lte Either a single timestamp to filter before or after, or two comma separated timestamps to filter between. Defaults to 24 hours before the request is sent.
sort string ~ What order to display the items in. Available options publishedAt_asc or publishedAt_desc. If no sort order is specified then results are sorted in chronological order
limit int ~ A limited result set between 1 and 10000. Defaults to 1000
page int ~ A paginated result set between 1 and 10000. Defaults to 1

HTTP Response

{
    "status": "success",
    "data": {
        "news": [
            {
                "id": "c1b8f161-e978-423b-981c-76301b6025cb",
                "title": "Eid al-Adha prayers continue as rockets fired in Afghanistan",
                "summary": "Rockets could be heard exploding nearby during prayers in Afghanistan to mark the start of the Muslim festival Eid al-Adha.",
                "permalink": "https://www.bbc.co.uk/news/av/world-asia-57900618",
                "taxonomy": {
                    "id": "8cfb8d8a-cd8c-41d8-8a58-da149c874e9b",
                    "score": 0.80
                },
                "subTaxonomies": [
                    {
                        "id": "a0841b07-e0d6-45b9-870c-1dd0a20b1845",
                        "score": 0.70
                    }
                ],
                "industries": [
                    {
                        "reference": "in.pol",
                        "name": "Politics"
                    }
                ],
                "countries": [
                    {
                        "code": "USA",
                        "name": "United States of America"
                    }
                ],
                "keywords": [
                    "man",
                    "prayers"
                ],
                "incidentId": null,
                "publishedAt": 1625155307,
                "createdAt": 1625155307,
                "updatedAt": 1625155307
            }
        ],
        "meta": {
            "total": 1,
            "page": 1,
            "pages": 1,
            "pageSize": 100
        }
    }
}

Success

Code Status Description
200 Success Returns a body containing all valid News items

Errors

Code Status Description
401 Unauthorized Expired or Invalid Authentication token
422 Unprocessable Entity Incorrect or invalid parameter

GET /taxonomies Get taxonomies

This endpoint provides the information about our new taxonomy schema. Sub-taxonomies are nested within each main taxonomy under the subTaxonomies array. Taxonomies and sub-taxonomies can be used to filter News items allowing consumers to reach into our news data in a more effective way.

HTTP Request

curl -X GET 'https://news.intelligencefusion.co.uk/taxonomies' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {{YOUR_AUTHENTICATION_TOKEN}}' \
  --compressed

Headers

Name Type Required Description
Authorization string ✔️ Your authentication token (see the Auth API section for more information)

HTTP Response

{
    "status": "success",
    "data": {
        "taxonomies": [
            {
                "id": "606e8a19-660c-4aef-bbe2-8dd84e2e474d",
                "name": "Propaganda",
                "subTaxonomies": []
            },
            {
                "id": "f6e9b8a1-f1e1-4488-a43a-84a27bd0516b",
                "name": "Transportation Safety",
                "subTaxonomies": [
                    {
                        "id": "4da372b1-a5e7-413e-8d0a-2135a24f9156",
                        "name": "Air Safety"
                    },
                    {
                        "id": "b0459a97-5874-4064-8263-19f6c6b1be99",
                        "name": "Air Traffic Control"
                    }
                ]
            }
        ]
    }
}

Success

Code Status Description
200 Success Returns a body containing all valid Taxonomies.

Errors

Code Status Description
401 Unauthorized Expired or Invalid Authentication token