Sign in
stories

Get a story containing updates

Get a single news story given its UUID.

get/v1/stories/{story_id}

Path parameters

story_idstring required

The story UUID, update UUID, or URL safe title

The story UUID, update UUID, or URL safe title

Query parameters

expand_updatesboolean

Whether to expand updates

Whether to expand updates

max_updatesinteger

Max number of updates to include in the story object

Max number of updates to include in the story object

max_articlesinteger

Max articles to include per update

Max articles to include per update

redditinteger

Whether to include Reddit analysis

Whether to include Reddit analysis

citation_method'brackets' | 'urls' | 'none'

Method to use for citation filtering.

Method to use for citation filtering.

condense_auxillary_updatesboolean

When requesting a particular story update, you can expand the assocaited updates by settined max_updates to the total you would like to get. If you want those updates to by condensed for reduced latency, you can set condense_auxillary_updates to 'False'.

When requesting a particular story update, you can expand the assocaited updates by settined max_updates to the total you would like to get. If you want those updates to by condensed for reduced latency, you can set condense_auxillary_updates to 'False'.

Response

A story object containing updates

uuidstring uuid required
categoriesstring[] required
countriesobject required
countries_pctobject required
current_update_uuidstring required
requested_update_uuidstring required
generate_imageboolean required
keywordsstring[] required
languagesobject required
languages_pctobject required
locationsstring[] required
meta_typestring required
n_articlesinteger[] required
n_updatesinteger required
peoplestring[] required
reddit_sentiment_timestampsinteger[] required
rolling_sentimentnumber[] required
sentimentinteger[] required
sentiment_timestampsinteger[] required
sourcesobject required
sources_urlsobject required
topicstring required
topicsstring[] required
updated_tsinteger required
update_uuidsstring[] required

Changes

No recorded changes to this endpoint across all 1 revision of this API.