Story Search Type- ahead

Telling the World’s Stories.
NBC News is a global leader in news across all broadcast and digital platforms.

Story Search Type- ahead API

Welcome to the Story Type-ahead API! This API uses semantic technology combined with the News Taxonomy to provide natural language search of NBC News stories. It is designed to respond quickly and is currently used as a type ahead, returning matches as a user enters text.

Authentication

The story type ahead API uses API keys to allow access to the API. You can register a new API key at the developer portal. The API expects for the API key to be included in all API requests to the server.

Request

The endpoint url to be used is :

GET http://api.nbcuniversal.com/v1/resources/story-sem-suggestsTry Now

This End point retrieves all the stories matching the search term submitted with the request.

Query Parameters

Name	Default	Description
rs:searchTerm		Search Term to fetch the stories from
rs:tags	0	If set to 1, the result also search in tags.
rs:boost		Enter prioritized tags for your search
api_key		Mashery API key for authentication

Sample Response

 [
  {
    "story-title": "Hillary Clinton Tim Kaine 2016 Presidential Campaign",
    "uri": "/typeahead/story/story-9771.xml",
    "story-id": "9771",
    "story-status": "ready",
    "story-tags": "hillary clinton, political unit, politics, presidential campaign, decision 2016, democrat, tim kaine"
  },
  {
    "story-title": "Clinton Presidential Library Releases Photo's of Donald Trump and Bill Clinton",
    "uri": "/typeahead/story/story-26162.xml",
    "story-id": "26162",
    "story-status": "ready",
    "story-tags": "bill clinton, donald trump"
  }
]