--- title: "Get a story containing updates" method: GET path: "/v1/stories/{story_id}" tags: ["stories"] --- # Get a story containing updates `GET /v1/stories/{story_id}` Get a single news story given its UUID. ## Path parameters - `story_id` string, required — The story UUID, update UUID, or URL safe title ## Query parameters - `expand_updates` boolean — Whether to expand updates - `max_updates` integer — Max number of updates to include in the story object - `max_articles` integer — Max articles to include per update - `reddit` integer — Whether to include Reddit analysis - `citation_method` 'brackets' | 'urls' | 'none' — Method to use for citation filtering. - `condense_auxillary_updates` boolean — 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 `200` A story object containing updates - StoryResponse - `uuid` string, uuid, required - `categories` string[], required - `countries` object, required - `countries_pct` object, required - `current_update_uuid` string, required - `requested_update_uuid` string, required - `generate_image` boolean, required - `keywords` string[], required - `languages` object, required - `languages_pct` object, required - `locations` string[], required - `meta_type` string, required - `n_articles` integer[], required - `n_updates` integer, required - `people` string[], required - `reddit_sentiment` union[], required - union - integer - number - `reddit_sentiment_timestamps` integer[], required - `rolling_sentiment` number[], required - `sentiment` integer[], required - `sentiment_timestamps` integer[], required - `sources` object, required - `sources_urls` object, required - `topic` string, required - `topics` string[], required - `updates` StoryUpdate[], required - `uuid` string, uuid, required - `cluster_articles` Article[], required - `article_url` string, uri, required - `article_id` string, uuid, required - `classification` union, required - string[] - string - `country` string, required - `source_id` string, required - `page_rank` integer, required - `domain_url` string, required - `eng_title` string, required - `entities` Entities, required - `Person` string[] - `Organization` string[] - `Location` string[] - `Nationality` string[] - `Date` string[] - `Event` string[] - `Money` string[] - `Law` string[] - `Quantity` string[] - `Time` string[] - `Sports` string[] - `Politics` string[] - `Title` string[] - `Number` string[] - `Arms` string[] - `Product` string[] - `Media` string[] - `Transportation` string[] - `Religion` string[] - `Technology` string[] - `Space` string[] - `Medicine` string[] - `Language` string[] - `Science` string[] - `image_url` string, nullable - `keywords` string[], required - `language` string, required - `pub_date` string, date-time, required - `summary` string, required - `key_points` string[], nullable - `title` string, required - `sentiment` integer, required - `centroid_distance` number, required - `cluster_probability` number, required - `markdown_citation` string - `provocative` 'unknown' | 'low' | 'medium' | 'high' - `reporting_voice` union - 'Objective' | 'Subjective' | 'Investigative' | 'Narrative' | 'Analytical' | 'Advocacy' | 'Conversational' | 'Satirical' | 'Emotive' | 'Explanatory' | 'UnknownPersuasive' | 'Sensational' - string - `entity_relation_graph` AsknewsApiSchemaV1CommonGraphRelationships - `nodes` object[] - `edges` object[] - `geo_coordinates` object, nullable - `continent` 'Africa' | 'Asia' | 'Europe' | 'Middle East' | 'North America' | 'South America' | 'Oceania', nullable - `assets` Assets - `images` string[], nullable - `videos` string[], nullable - `social_embeds` string[], nullable - `bias` 'Political' | 'Gender' | 'Cultural' | 'Age' | 'Religious' | 'Statement' | 'Illogical Claims' | 'Slant' | 'Source Selection' | 'Omission of Source Attribution' | 'Spin' | 'Sensationalism' | 'Negativity' | 'Subjective Adjectives' | 'Ad Hominem' | 'Mind Reading' | 'Opinion-as-Fact' | 'None' | 'Unknown', nullable - `authors` Author[], nullable - `email` string, nullable - `name` string, nullable - `url` string, nullable - `full_text` string, nullable - `original_language_summary` string, nullable - `image_description` string, nullable - `crawl_date` string, date-time, nullable - `content_type` 'news' | 'opinion' | 'analysis' | 'review' | 'listicle' | 'guide' | 'interview' | 'profile' | 'forum' | 'liveblog' | 'fact-check' | 'press_release' | 'obituary' | 'data_journalism', nullable - `prompt_articles` Article[], required - `article_url` string, uri, required - `article_id` string, uuid, required - `classification` union, required - string[] - string - `country` string, required - `source_id` string, required - `page_rank` integer, required - `domain_url` string, required - `eng_title` string, required - `entities` Entities, required - `Person` string[] - `Organization` string[] - `Location` string[] - `Nationality` string[] - `Date` string[] - `Event` string[] - `Money` string[] - `Law` string[] - `Quantity` string[] - `Time` string[] - `Sports` string[] - `Politics` string[] - `Title` string[] - `Number` string[] - `Arms` string[] - `Product` string[] - `Media` string[] - `Transportation` string[] - `Religion` string[] - `Technology` string[] - `Space` string[] - `Medicine` string[] - `Language` string[] - `Science` string[] - `image_url` string, nullable - `keywords` string[], required - `language` string, required - `pub_date` string, date-time, required - `summary` string, required - `key_points` string[], nullable - `title` string, required - `sentiment` integer, required - `centroid_distance` number, required - `cluster_probability` number, required - `markdown_citation` string - `provocative` 'unknown' | 'low' | 'medium' | 'high' - `reporting_voice` union - 'Objective' | 'Subjective' | 'Investigative' | 'Narrative' | 'Analytical' | 'Advocacy' | 'Conversational' | 'Satirical' | 'Emotive' | 'Explanatory' | 'UnknownPersuasive' | 'Sensational' - string - `entity_relation_graph` AsknewsApiSchemaV1CommonGraphRelationships - `nodes` object[] - `edges` object[] - `geo_coordinates` object, nullable - `continent` 'Africa' | 'Asia' | 'Europe' | 'Middle East' | 'North America' | 'South America' | 'Oceania', nullable - `assets` Assets - `images` string[], nullable - `videos` string[], nullable - `social_embeds` string[], nullable - `bias` 'Political' | 'Gender' | 'Cultural' | 'Age' | 'Religious' | 'Statement' | 'Illogical Claims' | 'Slant' | 'Source Selection' | 'Omission of Source Attribution' | 'Spin' | 'Sensationalism' | 'Negativity' | 'Subjective Adjectives' | 'Ad Hominem' | 'Mind Reading' | 'Opinion-as-Fact' | 'None' | 'Unknown', nullable - `authors` Author[], nullable - `email` string, nullable - `name` string, nullable - `url` string, nullable - `full_text` string, nullable - `original_language_summary` string, nullable - `image_description` string, nullable - `crawl_date` string, date-time, nullable - `content_type` 'news' | 'opinion' | 'analysis' | 'review' | 'listicle' | 'guide' | 'interview' | 'profile' | 'forum' | 'liveblog' | 'fact-check' | 'press_release' | 'obituary' | 'data_journalism', nullable - `n_articles` integer, required - `entities` Entities, required - `Person` string[] - `Organization` string[] - `Location` string[] - `Nationality` string[] - `Date` string[] - `Event` string[] - `Money` string[] - `Law` string[] - `Quantity` string[] - `Time` string[] - `Sports` string[] - `Politics` string[] - `Title` string[] - `Number` string[] - `Arms` string[] - `Product` string[] - `Media` string[] - `Transportation` string[] - `Religion` string[] - `Technology` string[] - `Space` string[] - `Medicine` string[] - `Language` string[] - `Science` string[] - `headline` string, required - `story` string, required - `story_update_ts` integer, required - `sources_urls` object, required - `languages_pct` object, required - `countries_pct` object, required - `key_takeaways` string[], required - `contradictions` string[], required - `continent` string, required - `people` string[], required - `locations` string[], required - `new_information` string, required - `image_url` string, uri, required - `url_safe_title` string, required - `story_uuid` string, uuid, required - `categories` string[], required - `image_prompt` string, required - `reddit_perspective` RedditPerspective, required - `sentiment` union, required - integer - number - `relevant` boolean, required - `summary` string, required - `reddit_threads` RedditThread[], required - `author` string, required - `author_comment_karma` integer, required - `author_link_karma` integer, required - `body` string, required - `classification` union, required - string[] - string - `comments` RedditComment[], required - `author` string, required - `body` string, required - `date` string, date-time, required - `upvotes` integer, required - `comments_count` integer, required - `date` string, date-time, required - `entities` RedditEntities, required - `DATE` string[] - `EVENT` string[] - `GPE` string[] - `ORG` string[] - `PERSON` string[] - `NORP` string[] - `CARDINAL` string[] - `id` string, uuid, required - `key_takeaways` string[] - `keywords` string[], required - `sentiment` union, required - integer - number - `subreddit_name` string, required - `subreddit_url` string, required - `summary` string, required - `title` string, required - `topic` string, required - `upvotes` integer, required - `url` string, required - `main_speculation` string - `languages` object, required - `keywords` string[], required - `intra_cluster_statistics` IntraClusterStatistics, required - `cluster_articles_pct` number - `cluster_countries_pct` number - `cluster_domains_pct` number - `cluster_languages_pct` number - `cluster_probabilities` object - `silhouette_score` object, required - `article_ids` string[], required - `countries` object, required - `markdown_citations` string[], required - `confidence` number - `provocative` 'unknown' | 'low' | 'medium' | 'high' - `reporting_voice` string - `relationships` AsknewsApiSchemaV1StoriesGraphRelationships, required - `nodes` object[], required - `edges` object[], required - `mermaid` string, required - `cc_image_url` string, required - `display_image_urls` union[], required - union - DisplayImageUrl - `source_id` string, required - `image_url` string, uri, required - string - `alignment` integer - `updated_ts` integer, required - `update_uuids` string[], required ## Other responses - `400` — Bad Request - `401` — Unauthorized - `403` — Forbidden - `405` — Method Not Allowed - `422` — Unprocessable Entity - `500` — Internal Server Error --- [API](https://skmtc.dev/asknews/apis/asknews-api.md) · [All operations](https://skmtc.dev/asknews/apis/asknews-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/asknews/asknews-api/revisions/dd4286769887/schema)