ASasknews
stories

Get a story containing updates

Changed on

Get a single news story given its UUID.

get/v1/stories/{story_id}

Request

Path parameters

story_idstring required

The story UUID, update UUID, or URL safe title

Query parameters

expand_updatesboolean

Whether to expand updates

max_updatesinteger

Max number of updates to include in the story object

max_articlesinteger

Max articles to include per update

redditinteger

Whether to include Reddit analysis

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

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'.

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

  • 6513c99e2917Revision changes
    • info

      added the optional property //////// to the response with the status

    • info

      added the optional property //////// to the response with the status

  • f1818f4f772bRevision changes
    • breaking

      the response property //// became optional for the status

    • breaking

      the response property //// became optional for the status

    • breaking

      the response property //// became optional for the status

    • breaking

      the response property //// became optional for the status

    • breaking

      response property updates/items/cluster_articles/items/centroid_distance list-of-types was widened by adding types null to media type application/json of response 200

    • breaking

      response property updates/items/cluster_articles/items/cluster_probability list-of-types was widened by adding types null to media type application/json of response 200

    • breaking

      response property updates/items/prompt_articles/items/centroid_distance list-of-types was widened by adding types null to media type application/json of response 200

    • breaking

      response property updates/items/prompt_articles/items/cluster_probability list-of-types was widened by adding types null to media type application/json of response 200