{"openapi":"3.1.0","info":{"title":"AskNews API","description":"AskNews API [![status](https://status.asknews.app/api/badge/2/status?style=for-the-badge)](https://status.asknews.app/status/prod)","version":"0.31.1"},"servers":[{"url":"https://api.asknews.app"}],"paths":{"/v1/news/search":{"get":{"tags":["news"],"summary":"Search for enriched real-time news context","description":"Search for any news, up to the last 5 minutes or in our extensive historical archive\nfilled with 100s of millions of articles.\n\nGeared toward low-latency applications, where time is of the essence. For example, this\nendpoint is commonly used for quickly getting news context for an LLM.\n\nThis endpoint is also commonly used for synthetic data curation. For example, say you\nare fine-tuning a model for sports. You could filter  with `classification=\"Sports\"`\nand build a dataset of sports articles.\n\nNews articles come with an abundance of valuable metadata, including full summaries, sentiment,\nentities, reporting voice, page rank, language, and much much more.\n\nAn example of this data in action can be found and interacted with at `https://asknews.app/chat`","operationId":"search_news","security":[{"APIKey":["news"]}],"parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string","description":"Query string that can be any phrase, keyword, question, or paragraph. If method='nl', then this will be used as a natural language query. If method='kw', then this will be used as a direct keyword query. This is not required, if it is not passed, then the search is based on the remaining filters only.","default":"","title":"Query"},"description":"Query string that can be any phrase, keyword, question, or paragraph. If method='nl', then this will be used as a natural language query. If method='kw', then this will be used as a direct keyword query. This is not required, if it is not passed, then the search is based on the remaining filters only."},{"name":"n_articles","in":"query","required":false,"schema":{"type":"integer","maximum":101,"exclusiveMinimum":0,"description":"Number of articles to return","default":10,"title":"N Articles"},"description":"Number of articles to return"},{"name":"start_timestamp","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Timestamp to start search from","title":"Start Timestamp"},"description":"Timestamp to start search from"},{"name":"end_timestamp","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Timestamp to end search at","title":"End Timestamp"},"description":"Timestamp to end search at"},{"name":"time_filter","in":"query","required":false,"schema":{"enum":["crawl_date","pub_date"],"type":"string","description":"Control which date type to filter on. 'crawl_date' is the date the article was crawled, 'pub_date' is the date the article was published.","default":"crawl_date","title":"Time Filter"},"description":"Control which date type to filter on. 'crawl_date' is the date the article was crawled, 'pub_date' is the date the article was published."},{"name":"return_type","in":"query","required":false,"schema":{"enum":["string","dicts","both"],"type":"string","description":"Type of return value. 'string' means that the return is prompt-optimized and ready to be immediately injected into any prompt. 'dicts' means that the return is a structured dictionary, containing additional metadata (like a classic news api). Can be 'string' or 'dicts', or 'both'. 'string' guarantees the lowest-latency response 'dicts' requires more I/O, therefore increases latency (very slightly, depending on your network connection).","default":"dicts","title":"Return Type"},"description":"Type of return value. 'string' means that the return is prompt-optimized and ready to be immediately injected into any prompt. 'dicts' means that the return is a structured dictionary, containing additional metadata (like a classic news api). Can be 'string' or 'dicts', or 'both'. 'string' guarantees the lowest-latency response 'dicts' requires more I/O, therefore increases latency (very slightly, depending on your network connection)."},{"name":"historical","in":"query","required":false,"schema":{"type":"boolean","description":"Search on archive of historical news. Defaults to False, meaning that the search will only look through the most recent news (48 hours)","default":false,"title":"Historical"},"description":"Search on archive of historical news. Defaults to False, meaning that the search will only look through the most recent news (48 hours)"},{"name":"method","in":"query","required":false,"schema":{"enum":["nl","kw","both"],"type":"string","description":"Method to use for searching. 'nl' means Natural Language, which is a string that can be any phrase, keyword, question, or paragraph that will be used for semantic search on the news. 'kw' means Keyword, which can also be any keyword(s), phrase, or paragraph, however the search is a direct keyword search on the database. 'both' means both methods will be used and results will be ranked according to IRR. 'both' may reduce latency by 10 pct in exchange  for improved accuracy.","default":"kw","title":"Method"},"description":"Method to use for searching. 'nl' means Natural Language, which is a string that can be any phrase, keyword, question, or paragraph that will be used for semantic search on the news. 'kw' means Keyword, which can also be any keyword(s), phrase, or paragraph, however the search is a direct keyword search on the database. 'both' means both methods will be used and results will be ranked according to IRR. 'both' may reduce latency by 10 pct in exchange  for improved accuracy."},{"name":"similarity_score_threshold","in":"query","required":false,"schema":{"type":"number","description":"Similarity score threshold to determine which articles to return. Lower means less similar results  are allowed.","default":0.5,"title":"Similarity Score Threshold"},"description":"Similarity score threshold to determine which articles to return. Lower means less similar results  are allowed."},{"name":"offset","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"string","format":"uuid"}],"description":"Offset for pagination. The n_articles is your page size, while your offset is the number of articles to skip to get to your page of interest. For example, if you want to get page 3 for n_article page size of 10, you would set offset to 20.","default":0,"title":"Offset"},"description":"Offset for pagination. The n_articles is your page size, while your offset is the number of articles to skip to get to your page of interest. For example, if you want to get page 3 for n_article page size of 10, you would set offset to 20."},{"name":"categories","in":"query","required":false,"schema":{"type":"array","items":{"enum":["All","Business","Economy","Crime","Politics","Science","Sports","Technology","Military","Health","Entertainment","Finance","Culture","Climate","Environment","World"],"type":"string"},"description":"Categories of news to filter on","title":"Categories"},"description":"Categories of news to filter on"},{"name":"doc_start_delimiter","in":"query","required":false,"schema":{"type":"string","description":"Document start delimiter for string return.","default":"<doc>","title":"Doc Start Delimiter"},"description":"Document start delimiter for string return."},{"name":"doc_end_delimiter","in":"query","required":false,"schema":{"type":"string","description":"Document end delimiter for string return.","default":"</doc>","title":"Doc End Delimiter"},"description":"Document end delimiter for string return."},{"name":"provocative","in":"query","required":false,"schema":{"enum":["unknown","low","medium","high","all"],"type":"string","description":"Filter articles based on how provocative they are deemed based on the use of provocative language and emotional vocabulary.","title":"Provocative"},"description":"Filter articles based on how provocative they are deemed based on the use of provocative language and emotional vocabulary."},{"name":"reporting_voice","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"enum":["Objective","Subjective","Investigative","Narrative","Analytical","Advocacy","Conversational","Satirical","Emotive","Explanatory","Persuasive","Sensational","Unknown","all"],"type":"string"}},{"enum":["Objective","Subjective","Investigative","Narrative","Analytical","Advocacy","Conversational","Satirical","Emotive","Explanatory","Persuasive","Sensational","Unknown","all"],"type":"string"}],"description":"Type of reporting voice to filer by.","title":"Reporting Voice"},"description":"Type of reporting voice to filer by."},{"name":"domain_url","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"string"},{"type":"null"}],"description":"filter by domain url of interest. This can be a single domain or a list of domains. For example, 'npr.org' or ['nature.com', 'npr.org']","title":"Domain Url"},"description":"filter by domain url of interest. This can be a single domain or a list of domains. For example, 'npr.org' or ['nature.com', 'npr.org']"},{"name":"bad_domain_url","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"string"},{"type":"null"}],"description":"blacklist of domains that must be excluded from resultsThis can be a single domain url or a list of domain urls.","title":"Bad Domain Url"},"description":"blacklist of domains that must be excluded from resultsThis can be a single domain url or a list of domain urls."},{"name":"podcasts","in":"query","required":false,"schema":{"enum":["include","only","none"],"type":"string","description":"Control whether podcasts are included in search results. 'include' searches news and podcasts, 'only' searches podcasts only, and 'none' excludes podcasts.","default":"include","title":"Podcasts"},"description":"Control whether podcasts are included in search results. 'include' searches news and podcasts, 'only' searches podcasts only, and 'none' excludes podcasts."},{"name":"page_rank","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Maximum allowed page rank for returned articles.","title":"Page Rank"},"description":"Maximum allowed page rank for returned articles."},{"name":"diversify_sources","in":"query","required":false,"schema":{"type":"boolean","description":"Ensure that the return set of articles are selected from diverse sources. This adds latency to the search, but attempts to balance the representation of sources by country and source origins. In summary, a net is cast around your search, then the diversity of sources is analyzed, and your final result matches the large net diversity distribution. This means that your search accuracy is reduced, but you gain more diverse perspectives.","default":false,"title":"Diversify Sources"},"description":"Ensure that the return set of articles are selected from diverse sources. This adds latency to the search, but attempts to balance the representation of sources by country and source origins. In summary, a net is cast around your search, then the diversity of sources is analyzed, and your final result matches the large net diversity distribution. This means that your search accuracy is reduced, but you gain more diverse perspectives."},{"name":"strategy","in":"query","required":false,"schema":{"enum":["latest news","news knowledge","default"],"type":"string","description":"Strategy to use for searching. 'latest news' automatically setsmethod='nl', historical=False, and looks within the past 24 hours. 'news knowledge' automatically sets method='kw', historical=True, and looks within the past 60 days. 'news knowledge' will increase latency due to the  larger search space in the archive. Use 'default' if you want to control  start_timestamp, end_timestamp, historical, and method.","default":"default","title":"Strategy"},"description":"Strategy to use for searching. 'latest news' automatically setsmethod='nl', historical=False, and looks within the past 24 hours. 'news knowledge' automatically sets method='kw', historical=True, and looks within the past 60 days. 'news knowledge' will increase latency due to the  larger search space in the archive. Use 'default' if you want to control  start_timestamp, end_timestamp, historical, and method."},{"name":"hours_back","in":"query","required":false,"schema":{"type":"integer","description":"Can be set to easily control the look back on the search. This is the same as controlling the 'start_timestamp' parameter. The difference is that this is not a timestamp, it is the number of hours back to look from the current time. Defaults to 24 hours.","default":24,"title":"Hours Back"},"description":"Can be set to easily control the look back on the search. This is the same as controlling the 'start_timestamp' parameter. The difference is that this is not a timestamp, it is the number of hours back to look from the current time. Defaults to 24 hours."},{"name":"string_guarantee","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"If defined, the search will only occur on articles that contain strings in this list.","title":"String Guarantee"},"description":"If defined, the search will only occur on articles that contain strings in this list."},{"name":"string_guarantee_op","in":"query","required":false,"schema":{"enum":["AND","OR"],"type":"string","description":"Operator to use for string guarantee list.","default":"AND","title":"String Guarantee Op"},"description":"Operator to use for string guarantee list."},{"name":"reverse_string_guarantee","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"If defined, the search will only occur on articles that do not contain strings in this list.","title":"Reverse String Guarantee"},"description":"If defined, the search will only occur on articles that do not contain strings in this list."},{"name":"entity_guarantee","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Entity guarantee to filter by. This is a list of strings, where each string includes entity type and entity value separated by a colon. The first element is the entity type and the second element is the entity value. For example ['Location:Paris', 'Person:John']","title":"Entity Guarantee"},"description":"Entity guarantee to filter by. This is a list of strings, where each string includes entity type and entity value separated by a colon. The first element is the entity type and the second element is the entity value. For example ['Location:Paris', 'Person:John']"},{"name":"reverse_entity_guarantee","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Reverse entity guarantee to filter by. This is a list of strings, where each string includes entity type and entity value separated by a colon. The first element is the entity type and the second element is the entity value. For example ['Location:Paris', 'Person:John']","title":"Reverse Entity Guarantee"},"description":"Reverse entity guarantee to filter by. This is a list of strings, where each string includes entity type and entity value separated by a colon. The first element is the entity type and the second element is the entity value. For example ['Location:Paris', 'Person:John']"},{"name":"entity_guarantee_op","in":"query","required":false,"schema":{"enum":["AND","OR"],"type":"string","description":"Operator to use for entity guarantee list.","default":"OR","title":"Entity Guarantee Op"},"description":"Operator to use for entity guarantee list."},{"name":"return_graphs","in":"query","required":false,"schema":{"type":"boolean","description":"Return graphs for the articles. Only available to Analyst tier and above.","default":false,"title":"Return Graphs"},"description":"Return graphs for the articles. Only available to Analyst tier and above."},{"name":"return_geo","in":"query","required":false,"schema":{"type":"boolean","description":"Return GeoCoordinates associated with locations discussed  inside the articles. Only available to Analyst tier and above.","default":false,"title":"Return Geo"},"description":"Return GeoCoordinates associated with locations discussed  inside the articles. Only available to Analyst tier and above."},{"name":"languages","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"enum":["sq","ar","az","ca","zh","hr","cs","da","nl","en","eo","fi","fr","gl","de","el","he","hi","hu","is","id","ia","it","ja","kk","km","ko","ky","ms","mt","mhr","mn","no","or","pl","pt","pa","ro","ru","sr","sk","sl","es","sv","ta","te","th","tr","uk","vi","unknown"],"type":"string"}},{"type":"null"}],"description":"Languages to filter by. This is the two-letter 'set 1' of the ISO 639-1 standard. For example: English is 'en'.","title":"Languages"},"description":"Languages to filter by. This is the two-letter 'set 1' of the ISO 639-1 standard. For example: English is 'en'."},{"name":"countries","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Source countries to filter by (this is only for the publisher location, not the locations mentioned in articles. For Locations mentioned in articles, refer to entity_guarantee), countries must be the two-letter ISO country codeFor example: United States is 'US', France is 'FR', Sweden is 'SE'.","title":"Countries"},"description":"Source countries to filter by (this is only for the publisher location, not the locations mentioned in articles. For Locations mentioned in articles, refer to entity_guarantee), countries must be the two-letter ISO country codeFor example: United States is 'US', France is 'FR', Sweden is 'SE'."},{"name":"countries_blacklist","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Source countries to blacklist from search (this is only for the publisher location, not the locations mentioned in articles. For Locations mentioned in articles, refer to reverse_entity_guarantee), countries must be the two-letter ISO country codeFor example: United States is 'US', France is 'FR', Sweden is 'SE'.","title":"Countries Blacklist"},"description":"Source countries to blacklist from search (this is only for the publisher location, not the locations mentioned in articles. For Locations mentioned in articles, refer to reverse_entity_guarantee), countries must be the two-letter ISO country codeFor example: United States is 'US', France is 'FR', Sweden is 'SE'."},{"name":"continents","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"enum":["Africa","Asia","Oceania","Europe","Middle East","North America","South America"],"type":"string"}},{"type":"null"}],"description":"Continents to filter by.","title":"Continents"},"description":"Continents to filter by."},{"name":"sentiment","in":"query","required":false,"schema":{"anyOf":[{"enum":["negative","neutral","positive"],"type":"string"},{"type":"null"}],"description":"Sentiment to filter articles by.","title":"Sentiment"},"description":"Sentiment to filter articles by."},{"name":"premium","in":"query","required":false,"schema":{"type":"boolean","description":"Include premium sources.","default":false,"title":"Premium"},"description":"Include premium sources."},{"name":"authors","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Authors to filter articles by.","title":"Authors"},"description":"Authors to filter articles by."},{"name":"try_cache","in":"query","required":false,"schema":{"anyOf":[{"enum":["1h","6h","12h","24h","3d","7d"],"type":"string"},{"type":"null"}],"description":"Enable response caching with the specified TTL. When a cached response is returned, usage is charged at 0.25x the normal rate. Valid values: '1h' (1 hour), '6h' (6 hours), '12h' (12 hours), '24h' (24 hours), '3d' (3 days), '7d' (7 days).","title":"Try Cache"},"description":"Enable response caching with the specified TTL. When a cached response is returned, usage is charged at 0.25x the normal rate. Valid values: '1h' (1 hour), '6h' (6 hours), '12h' (12 hours), '24h' (24 hours), '3d' (3 days), '7d' (7 days)."},{"name":"geo_lat","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Latitude for geo-radius filter. Must be provided together with geo_lon and geo_radius. Filters articles whose coordinates fall within the specified circle.","title":"Geo Lat"},"description":"Latitude for geo-radius filter. Must be provided together with geo_lon and geo_radius. Filters articles whose coordinates fall within the specified circle."},{"name":"geo_lon","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Longitude for geo-radius filter. Must be provided together with geo_lat and geo_radius.","title":"Geo Lon"},"description":"Longitude for geo-radius filter. Must be provided together with geo_lat and geo_radius."},{"name":"geo_radius","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Radius in meters for geo-radius filter. Must be provided together with geo_lat and geo_lon.","title":"Geo Radius"},"description":"Radius in meters for geo-radius filter. Must be provided together with geo_lat and geo_lon."},{"name":"geo_polygon","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"JSON string defining a polygon for geo filtering. Must contain an 'exterior' key with a list of {lon, lat} points. The first and last point must be the same. Optionally include 'interiors' as a list of rings (each a list of {lon, lat} points) to exclude areas. Example: {\"exterior\": [{\"lon\": -70, \"lat\": -70}, {\"lon\": 60, \"lat\": -70}, {\"lon\": 60, \"lat\": 60}, {\"lon\": -70, \"lat\": 60}, {\"lon\": -70, \"lat\": -70}]}","title":"Geo Polygon"},"description":"JSON string defining a polygon for geo filtering. Must contain an 'exterior' key with a list of {lon, lat} points. The first and last point must be the same. Optionally include 'interiors' as a list of rings (each a list of {lon, lat} points) to exclude areas. Example: {\"exterior\": [{\"lon\": -70, \"lat\": -70}, {\"lon\": 60, \"lat\": -70}, {\"lon\": 60, \"lat\": 60}, {\"lon\": -70, \"lat\": 60}, {\"lon\": -70, \"lat\": -70}]}"}],"responses":{"200":{"description":"A string or a list of dictionaries","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__4"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__3"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__2"}}},"description":"Forbidden"},"405":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__1"}}},"description":"Method Not Allowed"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationErrorModel"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/asknews_api__errors__APIErrorModel"}}},"description":"Internal Server Error"}}}},"/v1/news/graph":{"post":{"tags":["graph"],"summary":"Build a custom mega-news-knowledge graph","description":"Explore our mega-news-knowledge-graph at which ever level of resolution you need.\n\nFully disambiguated and ready to be used in any downstream application.\n\nPass a natural language query to get a graph of the latest news. Add parameters\nto build a graph from our archive, filter your graph by language, country, reporting voice,\nsentiment, provocative levels, and much more.","operationId":"build_graph","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_build_graph"}}}},"responses":{"200":{"description":"A fully disambiguated knowledge graph, dismabiguation metadata, and the full list of news articles","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GraphResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__8"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__7"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__6"}}}},"405":{"description":"Method Not Allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__5"}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationErrorModel"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/asknews_api__errors__APIErrorModel"}}}}},"security":[{"APIKey":["news"]}]}},"/v1/news/index_urls":{"post":{"tags":["index_urls"],"summary":"Index a list of URLs into AskNews","description":"Index a list of news article URLs.","operationId":"index_urls","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/URLIndexingRequest","description":"Payload containing list of URL objects to index. "}}},"required":true},"responses":{"200":{"description":"Job ID and status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexUrlsResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__12"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__11"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__10"}}}},"405":{"description":"Method Not Allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__9"}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationErrorModel"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/asknews_api__errors__APIErrorModel"}}}}},"security":[{"APIKey":["news"]}]}},"/v1/news":{"get":{"tags":["news"],"summary":"Get multiple articles by UUID","description":"Get articles given a list of UUIDs.","operationId":"get_articles","security":[{"APIKey":["news"]}],"parameters":[{"name":"article_ids","in":"query","required":true,"schema":{"type":"array","items":{"type":"string","format":"uuid"},"description":"Article UUIDs to fetch.","title":"Article Ids"},"description":"Article UUIDs to fetch."},{"name":"full_text","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to return the full text of the articles.","default":false,"title":"Full Text"},"description":"Whether to return the full text of the articles."}],"responses":{"200":{"description":"A list of news articles","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SearchResponseDictItem"},"title":"Response 200 Get Articles"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__16"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__15"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__14"}}},"description":"Forbidden"},"405":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__13"}}},"description":"Method Not Allowed"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationErrorModel"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/asknews_api__errors__APIErrorModel"}}},"description":"Internal Server Error"}}}},"/v1/news/{article_id}":{"get":{"tags":["news"],"summary":"Get an article by its UUID","description":"Get a single article given a UUID.","operationId":"get_article","security":[{"APIKey":["news"]}],"parameters":[{"name":"article_id","in":"path","required":true,"schema":{"type":"string","description":"Article ID to retrieve","title":"Article Id"},"description":"Article ID to retrieve"}],"responses":{"200":{"description":"A single news article","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponseDictItem"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__20"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__19"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__18"}}},"description":"Forbidden"},"405":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__17"}}},"description":"Method Not Allowed"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationErrorModel"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/asknews_api__errors__APIErrorModel"}}},"description":"Internal Server Error"}}}},"/v1/sources":{"get":{"tags":["news"],"summary":"Get the sources underlying AskNews","description":"This endpoint is primarly used for transparency and monitoring the\ndiversity of the data.\n\nVisualized at `https://asknews.app/transparency`.\n\nGet the distribution of sources/languages/countries underlying AskNews content.","operationId":"get_sources_report","security":[{"APIKey":["news"]}],"parameters":[{"name":"n_points","in":"query","required":false,"schema":{"type":"integer","description":"Number of points to return","default":100,"title":"N Points"},"description":"Number of points to return"},{"name":"start_timestamp","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Start timestamp to filter by","title":"Start Timestamp"},"description":"Start timestamp to filter by"},{"name":"end_timestamp","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"End timestamp to filter by","title":"End Timestamp"},"description":"End timestamp to filter by"},{"name":"metric","in":"query","required":false,"schema":{"enum":["duplication","countries_diversity","languages_diversity","sources_diversity","bucket_loss"],"type":"string","description":"Metric to filter by","default":"countries_diversity","title":"Metric"},"description":"Metric to filter by"},{"name":"sampling","in":"query","required":false,"schema":{"enum":["5m","1h","4h","1d"],"type":"string","description":"Sampling to use","default":"1h","title":"Sampling"},"description":"Sampling to use"}],"responses":{"200":{"description":"A time-series for distribution of sources, countries, and languages of underling AskNews content and analytics.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceReportResponse"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__24"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__23"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__22"}}},"description":"Forbidden"},"405":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__21"}}},"description":"Method Not Allowed"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationErrorModel"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/asknews_api__errors__APIErrorModel"}}},"description":"Internal Server Error"}}}},"/v1/index_counts":{"get":{"tags":["news"],"summary":"Get the index counts underlying AskNews","description":"This endpoint is primarly used for the publisher dashboard, to\nshow the number of articles indexed per source.","operationId":"get_index_counts","security":[{"APIKey":["news"]}],"parameters":[{"name":"start_datetime","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Start timestamp to filter by","title":"Start Datetime"},"description":"Start timestamp to filter by"},{"name":"end_datetime","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"End timestamp to filter by","title":"End Datetime"},"description":"End timestamp to filter by"},{"name":"domains","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Domain or list of domains to get indexing counts for","title":"Domains"},"description":"Domain or list of domains to get indexing counts for"},{"name":"sampling","in":"query","required":false,"schema":{"enum":["5m","1h","12h","1d","1w","1m"],"type":"string","description":"Sampling to use","default":"1d","title":"Sampling"},"description":"Sampling to use"},{"name":"time_filter","in":"query","required":false,"schema":{"enum":["crawl_date","pub_date"],"type":"string","description":"Control which date type to filter on. 'crawl_date' is the date the article was crawled, 'pub_date' is the date the article was published.","default":"pub_date","title":"Time Filter"},"description":"Control which date type to filter on. 'crawl_date' is the date the article was crawled, 'pub_date' is the date the article was published."},{"name":"categories","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"enum":["All","Business","Crime","Politics","Science","Sports","Technology","Military","Health","Entertainment","Finance","Culture","Climate","Environment","World"],"type":"string"}},{"type":"null"}],"description":"Categories of news to filter on","title":"Categories"},"description":"Categories of news to filter on"},{"name":"provocative","in":"query","required":false,"schema":{"anyOf":[{"enum":["unknown","low","medium","high","all"],"type":"string"},{"type":"null"}],"description":"Filter articles based on how provocative they are deemed based on the use of provocative language and emotional vocabulary.","title":"Provocative"},"description":"Filter articles based on how provocative they are deemed based on the use of provocative language and emotional vocabulary."},{"name":"reporting_voice","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"enum":["Objective","Subjective","Investigative","Narrative","Analytical","Advocacy","Conversational","Satirical","Emotive","Explanatory","Persuasive","Sensational","Unknown","all"],"type":"string"}},{"type":"null"}],"description":"Type of reporting voice to filer by.","title":"Reporting Voice"},"description":"Type of reporting voice to filer by."},{"name":"bad_domain_url","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"string"},{"type":"null"}],"description":"blacklist of domains that must be excluded from resultsThis can be a single domain url or a list of domain urls.","title":"Bad Domain Url"},"description":"blacklist of domains that must be excluded from resultsThis can be a single domain url or a list of domain urls."},{"name":"page_rank","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"maximum allowed pagerank for returned articles","title":"Page Rank"},"description":"maximum allowed pagerank for returned articles"},{"name":"string_guarantee","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"If defined, the search will only occur on articles that contain this string.","title":"String Guarantee"},"description":"If defined, the search will only occur on articles that contain this string."},{"name":"string_guarantee_op","in":"query","required":false,"schema":{"enum":["AND","OR"],"type":"string","description":"Operator to use for string guarantee.","default":"AND","title":"String Guarantee Op"},"description":"Operator to use for string guarantee."},{"name":"reverse_string_guarantee","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"If defined, the search will only occur on articles that do not contain this string.","title":"Reverse String Guarantee"},"description":"If defined, the search will only occur on articles that do not contain this string."},{"name":"entity_guarantee","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Entity guarantee to filter by. This is a list of strings, where each string includes entity type and entity value separated by a colon. The first element is the entity type and the second element is the entity value. For example ['Location:Paris', 'Person:John']","title":"Entity Guarantee"},"description":"Entity guarantee to filter by. This is a list of strings, where each string includes entity type and entity value separated by a colon. The first element is the entity type and the second element is the entity value. For example ['Location:Paris', 'Person:John']"},{"name":"entity_guarantee_op","in":"query","required":false,"schema":{"enum":["AND","OR"],"type":"string","description":"Operator to use for entity guarantee.","default":"OR","title":"Entity Guarantee Op"},"description":"Operator to use for entity guarantee."},{"name":"languages","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"enum":["sq","ar","az","ca","zh","hr","cs","da","nl","en","eo","fi","fr","gl","de","el","he","hi","hu","is","id","ia","it","ja","kk","km","ko","ky","ms","mt","mhr","mn","no","or","pl","pt","pa","ro","ru","sr","sk","sl","es","sv","ta","te","th","tr","uk","vi","unknown"],"type":"string"}},{"type":"null"}],"description":"Languages to filter by. This is the two-letter 'set 1' of the ISO 639-1 standard. For example: English is 'en'.","title":"Languages"},"description":"Languages to filter by. This is the two-letter 'set 1' of the ISO 639-1 standard. For example: English is 'en'."},{"name":"countries","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Source countries to filter by (this is only for the publisher location, not the locations mentioned in articles. For Locations mentioned in articles, refer to entity_guarantee), countries must be the two-letter ISO country codeFor example: United States is 'US', France is 'FR', Sweden is 'SE'.","title":"Countries"},"description":"Source countries to filter by (this is only for the publisher location, not the locations mentioned in articles. For Locations mentioned in articles, refer to entity_guarantee), countries must be the two-letter ISO country codeFor example: United States is 'US', France is 'FR', Sweden is 'SE'."},{"name":"countries_blacklist","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Source countries to blacklist from search (this is only for the publisher location, not the locations mentioned in articles. For Locations mentioned in articles, refer to reverse_entity_guarantee), countries must be the two-letter ISO country codeFor example: United States is 'US', France is 'FR', Sweden is 'SE'.","title":"Countries Blacklist"},"description":"Source countries to blacklist from search (this is only for the publisher location, not the locations mentioned in articles. For Locations mentioned in articles, refer to reverse_entity_guarantee), countries must be the two-letter ISO country codeFor example: United States is 'US', France is 'FR', Sweden is 'SE'."},{"name":"continents","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"enum":["Africa","Asia","Oceania","Europe","Middle East","North America","South America"],"type":"string"}},{"type":"null"}],"description":"Continents to filter by","title":"Continents"},"description":"Continents to filter by"},{"name":"sentiment","in":"query","required":false,"schema":{"anyOf":[{"enum":["negative","neutral","positive"],"type":"string"},{"type":"null"}],"description":"Sentiment to filter news articles by.","title":"Sentiment"},"description":"Sentiment to filter news articles by."}],"responses":{"200":{"description":"A time-series for distribution of index counts for domains.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/IndexCountItem"},"title":"Response 200 Get Index Counts"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__28"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__27"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__26"}}},"description":"Forbidden"},"405":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__25"}}},"description":"Method Not Allowed"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationErrorModel"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/asknews_api__errors__APIErrorModel"}}},"description":"Internal Server Error"}}}},"/v1/openai/chat/completions":{"post":{"tags":["chat"],"summary":"Get chat completions from a news-infused AI assistant","description":"Get the chat completions for a given user message. This endpoint follows the\nOpenAI API spec. It includes a couple extra params, which include:\n\n- **journalist_mode**: Whether to activate an auto prompt that is more keen on AP styling,\ncitations, and fair reporting. Setting to false, you get a vanilla LLM with the news pre\nadded to the system prompt. No other prompting.\n- **inline_citations**: Decides how you want the bot to cite sources. It can use brackets,\nor it can also include the markdown with URL automatically.\n- **asknews_watermark**: Whether to include the AskNews watermark in the response.","operationId":"get_chat_completions","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateChatCompletionRequest"}}},"required":true},"responses":{"200":{"description":"Chat completions for a given user message","content":{"application/json":{"schema":{"$defs":{"CreateChatCompletionRequestMessage":{"properties":{"role":{"type":"string","title":"Role"},"content":{"type":"string","title":"Content"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"function_call":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Function Call"}},"type":"object","required":["role","content"],"title":"CreateChatCompletionRequestMessage"},"CreateChatCompletionResponseChoice":{"properties":{"index":{"type":"integer","title":"Index"},"message":{"properties":{"role":{"type":"string","title":"Role"},"content":{"type":"string","title":"Content"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"function_call":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Function Call"}},"type":"object","required":["role","content"],"title":"CreateChatCompletionRequestMessage"},"finish_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Finish Reason"}},"type":"object","required":["index","message"],"title":"CreateChatCompletionResponseChoice"},"CreateChatCompletionResponseUsage":{"properties":{"prompt_tokens":{"type":"integer","title":"Prompt Tokens"},"completion_tokens":{"type":"integer","title":"Completion Tokens"},"total_tokens":{"type":"integer","title":"Total Tokens"}},"type":"object","required":["prompt_tokens","completion_tokens","total_tokens"],"title":"CreateChatCompletionResponseUsage"}},"anyOf":[{"$ref":"#/components/schemas/CreateChatCompletionResponse"},{"items":{"$ref":"#/components/schemas/CreateChatCompletionResponseStream"},"type":"array"}],"properties":{"id":{"type":"string","title":"Id"},"created":{"type":"integer","title":"Created"},"object":{"type":"string","title":"Object","default":"chat.completion"},"model":{"type":"string","title":"Model","default":"gpt-4o-mini"},"usage":{"properties":{"prompt_tokens":{"type":"integer","title":"Prompt Tokens"},"completion_tokens":{"type":"integer","title":"Completion Tokens"},"total_tokens":{"type":"integer","title":"Total Tokens"}},"type":"object","required":["prompt_tokens","completion_tokens","total_tokens"],"title":"CreateChatCompletionResponseUsage"},"choices":{"items":{"properties":{"index":{"type":"integer","title":"Index"},"message":{"properties":{"role":{"type":"string","title":"Role"},"content":{"type":"string","title":"Content"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"function_call":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Function Call"}},"type":"object","required":["role","content"],"title":"CreateChatCompletionRequestMessage"},"finish_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Finish Reason"}},"type":"object","required":["index","message"],"title":"CreateChatCompletionResponseChoice"},"type":"array","title":"Choices"}},"type":"object","required":["id","created","usage","choices"],"title":"CreateChatCompletionResponse"}},"text/event-stream":{"schema":{"$defs":{"CreateChatCompletionRequestMessage":{"properties":{"role":{"type":"string","title":"Role"},"content":{"type":"string","title":"Content"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"function_call":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Function Call"}},"type":"object","required":["role","content"],"title":"CreateChatCompletionRequestMessage"},"CreateChatCompletionResponseStreamChoice":{"properties":{"index":{"type":"integer","title":"Index"},"delta":{"properties":{"role":{"type":"string","title":"Role"},"content":{"type":"string","title":"Content"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"function_call":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Function Call"}},"type":"object","required":["role","content"],"title":"CreateChatCompletionRequestMessage"},"finish_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Finish Reason"}},"type":"object","required":["index","delta"],"title":"CreateChatCompletionResponseStreamChoice"},"CreateChatCompletionResponseUsage":{"properties":{"prompt_tokens":{"type":"integer","title":"Prompt Tokens"},"completion_tokens":{"type":"integer","title":"Completion Tokens"},"total_tokens":{"type":"integer","title":"Total Tokens"}},"type":"object","required":["prompt_tokens","completion_tokens","total_tokens"],"title":"CreateChatCompletionResponseUsage"}},"properties":{"id":{"type":"string","title":"Id"},"created":{"type":"integer","title":"Created"},"object":{"type":"string","title":"Object","default":"chat.completion.chunk"},"model":{"type":"string","title":"Model","default":"gpt-4o-mini"},"usage":{"properties":{"prompt_tokens":{"type":"integer","title":"Prompt Tokens"},"completion_tokens":{"type":"integer","title":"Completion Tokens"},"total_tokens":{"type":"integer","title":"Total Tokens"}},"type":"object","required":["prompt_tokens","completion_tokens","total_tokens"],"title":"CreateChatCompletionResponseUsage"},"choices":{"items":{"properties":{"index":{"type":"integer","title":"Index"},"delta":{"properties":{"role":{"type":"string","title":"Role"},"content":{"type":"string","title":"Content"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"function_call":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Function Call"}},"type":"object","required":["role","content"],"title":"CreateChatCompletionRequestMessage"},"finish_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Finish Reason"}},"type":"object","required":["index","delta"],"title":"CreateChatCompletionResponseStreamChoice"},"type":"array","title":"Choices"}},"type":"object","required":["id","created","usage","choices"],"title":"CreateChatCompletionResponseStream"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__32"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__31"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__30"}}}},"405":{"description":"Method Not Allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__29"}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationErrorModel"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/asknews_api__errors__APIErrorModel"}}}}},"security":[{"APIKey":["chat"]}]}},"/v1/chat/deepnews":{"post":{"tags":["chat"],"summary":"Deep research into real-time news, archive news, and Google.","operationId":"deep_news","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateDeepNewsRequest"}}},"required":true},"responses":{"200":{"description":"Deep news research.","content":{"application/json":{"schema":{"$defs":{"Assets":{"properties":{"images":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Images"},"videos":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Videos"}},"type":"object","title":"Assets"},"Author":{"properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"}},"type":"object","title":"Author"},"CreateDeepNewsRequestMessage":{"properties":{"role":{"type":"string","title":"Role"},"content":{"type":"string","title":"Content"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"function_call":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Function Call"}},"type":"object","required":["role","content"],"title":"CreateDeepNewsRequestMessage"},"CreateDeepNewsResponseChoice":{"properties":{"index":{"type":"integer","title":"Index"},"message":{"properties":{"role":{"type":"string","title":"Role"},"content":{"type":"string","title":"Content"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"function_call":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Function Call"}},"type":"object","required":["role","content"],"title":"CreateDeepNewsRequestMessage"},"finish_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Finish Reason"}},"type":"object","required":["index","message"],"title":"CreateDeepNewsResponseChoice"},"CreateDeepNewsResponseUsage":{"properties":{"prompt_tokens":{"type":"integer","title":"Prompt Tokens"},"completion_tokens":{"type":"integer","title":"Completion Tokens"},"total_tokens":{"type":"integer","title":"Total Tokens"},"tool_usage":{"anyOf":[{"additionalProperties":{"type":"integer"},"type":"object"},{"type":"null"}],"title":"Tool Usage"}},"type":"object","required":["prompt_tokens","completion_tokens","total_tokens"],"title":"CreateDeepNewsResponseUsage"},"DeepNewsResponseSources":{"properties":{"news":{"anyOf":[{"items":{"properties":{"article_url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Article Url"},"article_id":{"type":"string","format":"uuid","title":"Article Id"},"classification":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"title":"Classification"},"country":{"type":"string","title":"Country"},"source_id":{"type":"string","title":"Source Id"},"page_rank":{"type":"integer","title":"Page Rank"},"domain_url":{"type":"string","title":"Domain Url"},"eng_title":{"type":"string","title":"Eng Title"},"entities":{"properties":{"Person":{"items":{"type":"string"},"type":"array","title":"Person","default":[]},"Organization":{"items":{"type":"string"},"type":"array","title":"Organization","default":[]},"Location":{"items":{"type":"string"},"type":"array","title":"Location","default":[]},"Nationality":{"items":{"type":"string"},"type":"array","title":"Nationality","default":[]},"Date":{"items":{"type":"string"},"type":"array","title":"Date","default":[]},"Event":{"items":{"type":"string"},"type":"array","title":"Event","default":[]},"Money":{"items":{"type":"string"},"type":"array","title":"Money","default":[]},"Law":{"items":{"type":"string"},"type":"array","title":"Law","default":[]},"Quantity":{"items":{"type":"string"},"type":"array","title":"Quantity","default":[]},"Time":{"items":{"type":"string"},"type":"array","title":"Time","default":[]},"Sports":{"items":{"type":"string"},"type":"array","title":"Sports","default":[]},"Politics":{"items":{"type":"string"},"type":"array","title":"Politics","default":[]},"Title":{"items":{"type":"string"},"type":"array","title":"Title","default":[]},"Number":{"items":{"type":"string"},"type":"array","title":"Number","default":[]},"Arms":{"items":{"type":"string"},"type":"array","title":"Arms","default":[]},"Product":{"items":{"type":"string"},"type":"array","title":"Product","default":[]},"Media":{"items":{"type":"string"},"type":"array","title":"Media","default":[]},"Transportation":{"items":{"type":"string"},"type":"array","title":"Transportation","default":[]},"Religion":{"items":{"type":"string"},"type":"array","title":"Religion","default":[]},"Technology":{"items":{"type":"string"},"type":"array","title":"Technology","default":[]},"Space":{"items":{"type":"string"},"type":"array","title":"Space","default":[]},"Medicine":{"items":{"type":"string"},"type":"array","title":"Medicine","default":[]},"Language":{"items":{"type":"string"},"type":"array","title":"Language","default":[]},"Science":{"items":{"type":"string"},"type":"array","title":"Science","default":[]}},"type":"object","title":"Entities"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url"},"keywords":{"items":{"type":"string"},"type":"array","title":"Keywords"},"language":{"type":"string","title":"Language"},"pub_date":{"type":"string","format":"date-time","title":"Pub Date"},"summary":{"type":"string","title":"Summary"},"key_points":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Key Points"},"title":{"type":"string","title":"Title"},"sentiment":{"type":"integer","title":"Sentiment"},"centroid_distance":{"type":"number","title":"Centroid Distance"},"cluster_probability":{"type":"number","title":"Cluster Probability"},"markdown_citation":{"type":"string","title":"Markdown Citation","default":""},"provocative":{"type":"string","enum":["unknown","low","medium","high"],"title":"Provocative","default":"unknown"},"reporting_voice":{"anyOf":[{"type":"string","enum":["Objective","Subjective","Investigative","Narrative","Analytical","Advocacy","Conversational","Satirical","Emotive","Explanatory","UnknownPersuasive","Sensational"]},{"type":"string"}],"title":"Reporting Voice","default":"Unknown"},"entity_relation_graph":{"anyOf":[{"properties":{"nodes":{"items":{"additionalProperties":{"type":"string"},"propertyNames":{"enum":["id","type","detailed_type","ner_type"]},"type":"object"},"type":"array","title":"Nodes","default":[]},"edges":{"items":{"additionalProperties":{"type":"string"},"propertyNames":{"enum":["from","to","label"]},"type":"object"},"type":"array","title":"Edges","default":[]}},"type":"object","title":"GraphRelationships"},{"type":"null"}]},"geo_coordinates":{"anyOf":[{"additionalProperties":{"properties":{"latitude":{"type":"number","title":"Latitude"},"longitude":{"type":"number","title":"Longitude"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["latitude","longitude","metadata"],"title":"GeoCoordinate"},"type":"object"},{"type":"null"}],"title":"Geo Coordinates"},"continent":{"anyOf":[{"type":"string","enum":["Africa","Asia","Europe","Middle East","North America","South America","Oceania"]},{"type":"null"}],"title":"Continent"},"assets":{"anyOf":[{"properties":{"images":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Images"},"videos":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Videos"}},"type":"object","title":"Assets"},{"type":"null"}]},"social_embeds":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Social Embeds"},"bias":{"anyOf":[{"type":"string","enum":["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"]},{"type":"null"}],"title":"Bias"},"authors":{"anyOf":[{"items":{"properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"}},"type":"object","title":"Author"},"type":"array"},{"type":"null"}],"title":"Authors"},"full_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Text"},"original_language_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Original Language Summary"},"image_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Description"},"crawl_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Crawl Date"},"content_type":{"anyOf":[{"type":"string","enum":["news","opinion","analysis","review","listicle","guide","interview","profile","forum","liveblog","fact-check","press_release","obituary","data_journalism"]},{"type":"null"}],"title":"Content Type"},"as_string_key":{"type":"string","title":"As String Key"}},"type":"object","required":["article_url","article_id","classification","country","source_id","page_rank","domain_url","eng_title","entities","keywords","language","pub_date","summary","title","sentiment","centroid_distance","cluster_probability","as_string_key"],"title":"SearchResponseDictItem"},"type":"array"},{"type":"null"}],"title":"News"},"web":{"anyOf":[{"items":{"properties":{"title":{"type":"string","title":"Title"},"url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Url"},"source":{"type":"string","title":"Source"},"published":{"type":"string","title":"Published"},"key_points":{"items":{"type":"string"},"type":"array","title":"Key Points"},"raw_text":{"type":"string","title":"Raw Text","default":""},"as_string_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"As String Key"}},"type":"object","required":["title","url","source","published","key_points"],"title":"WebSearchResult"},"type":"array"},{"type":"null"}],"title":"Web"}},"type":"object","title":"DeepNewsResponseSources"},"Entities":{"properties":{"Person":{"items":{"type":"string"},"type":"array","title":"Person","default":[]},"Organization":{"items":{"type":"string"},"type":"array","title":"Organization","default":[]},"Location":{"items":{"type":"string"},"type":"array","title":"Location","default":[]},"Nationality":{"items":{"type":"string"},"type":"array","title":"Nationality","default":[]},"Date":{"items":{"type":"string"},"type":"array","title":"Date","default":[]},"Event":{"items":{"type":"string"},"type":"array","title":"Event","default":[]},"Money":{"items":{"type":"string"},"type":"array","title":"Money","default":[]},"Law":{"items":{"type":"string"},"type":"array","title":"Law","default":[]},"Quantity":{"items":{"type":"string"},"type":"array","title":"Quantity","default":[]},"Time":{"items":{"type":"string"},"type":"array","title":"Time","default":[]},"Sports":{"items":{"type":"string"},"type":"array","title":"Sports","default":[]},"Politics":{"items":{"type":"string"},"type":"array","title":"Politics","default":[]},"Title":{"items":{"type":"string"},"type":"array","title":"Title","default":[]},"Number":{"items":{"type":"string"},"type":"array","title":"Number","default":[]},"Arms":{"items":{"type":"string"},"type":"array","title":"Arms","default":[]},"Product":{"items":{"type":"string"},"type":"array","title":"Product","default":[]},"Media":{"items":{"type":"string"},"type":"array","title":"Media","default":[]},"Transportation":{"items":{"type":"string"},"type":"array","title":"Transportation","default":[]},"Religion":{"items":{"type":"string"},"type":"array","title":"Religion","default":[]},"Technology":{"items":{"type":"string"},"type":"array","title":"Technology","default":[]},"Space":{"items":{"type":"string"},"type":"array","title":"Space","default":[]},"Medicine":{"items":{"type":"string"},"type":"array","title":"Medicine","default":[]},"Language":{"items":{"type":"string"},"type":"array","title":"Language","default":[]},"Science":{"items":{"type":"string"},"type":"array","title":"Science","default":[]}},"type":"object","title":"Entities"},"GeoCoordinate":{"properties":{"latitude":{"type":"number","title":"Latitude"},"longitude":{"type":"number","title":"Longitude"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["latitude","longitude","metadata"],"title":"GeoCoordinate"},"GraphRelationships":{"properties":{"nodes":{"items":{"additionalProperties":{"type":"string"},"propertyNames":{"enum":["id","type","detailed_type","ner_type"]},"type":"object"},"type":"array","title":"Nodes","default":[]},"edges":{"items":{"additionalProperties":{"type":"string"},"propertyNames":{"enum":["from","to","label"]},"type":"object"},"type":"array","title":"Edges","default":[]}},"type":"object","title":"GraphRelationships"},"SearchResponseDictItem":{"properties":{"article_url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Article Url"},"article_id":{"type":"string","format":"uuid","title":"Article Id"},"classification":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"title":"Classification"},"country":{"type":"string","title":"Country"},"source_id":{"type":"string","title":"Source Id"},"page_rank":{"type":"integer","title":"Page Rank"},"domain_url":{"type":"string","title":"Domain Url"},"eng_title":{"type":"string","title":"Eng Title"},"entities":{"properties":{"Person":{"items":{"type":"string"},"type":"array","title":"Person","default":[]},"Organization":{"items":{"type":"string"},"type":"array","title":"Organization","default":[]},"Location":{"items":{"type":"string"},"type":"array","title":"Location","default":[]},"Nationality":{"items":{"type":"string"},"type":"array","title":"Nationality","default":[]},"Date":{"items":{"type":"string"},"type":"array","title":"Date","default":[]},"Event":{"items":{"type":"string"},"type":"array","title":"Event","default":[]},"Money":{"items":{"type":"string"},"type":"array","title":"Money","default":[]},"Law":{"items":{"type":"string"},"type":"array","title":"Law","default":[]},"Quantity":{"items":{"type":"string"},"type":"array","title":"Quantity","default":[]},"Time":{"items":{"type":"string"},"type":"array","title":"Time","default":[]},"Sports":{"items":{"type":"string"},"type":"array","title":"Sports","default":[]},"Politics":{"items":{"type":"string"},"type":"array","title":"Politics","default":[]},"Title":{"items":{"type":"string"},"type":"array","title":"Title","default":[]},"Number":{"items":{"type":"string"},"type":"array","title":"Number","default":[]},"Arms":{"items":{"type":"string"},"type":"array","title":"Arms","default":[]},"Product":{"items":{"type":"string"},"type":"array","title":"Product","default":[]},"Media":{"items":{"type":"string"},"type":"array","title":"Media","default":[]},"Transportation":{"items":{"type":"string"},"type":"array","title":"Transportation","default":[]},"Religion":{"items":{"type":"string"},"type":"array","title":"Religion","default":[]},"Technology":{"items":{"type":"string"},"type":"array","title":"Technology","default":[]},"Space":{"items":{"type":"string"},"type":"array","title":"Space","default":[]},"Medicine":{"items":{"type":"string"},"type":"array","title":"Medicine","default":[]},"Language":{"items":{"type":"string"},"type":"array","title":"Language","default":[]},"Science":{"items":{"type":"string"},"type":"array","title":"Science","default":[]}},"type":"object","title":"Entities"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url"},"keywords":{"items":{"type":"string"},"type":"array","title":"Keywords"},"language":{"type":"string","title":"Language"},"pub_date":{"type":"string","format":"date-time","title":"Pub Date"},"summary":{"type":"string","title":"Summary"},"key_points":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Key Points"},"title":{"type":"string","title":"Title"},"sentiment":{"type":"integer","title":"Sentiment"},"centroid_distance":{"type":"number","title":"Centroid Distance"},"cluster_probability":{"type":"number","title":"Cluster Probability"},"markdown_citation":{"type":"string","title":"Markdown Citation","default":""},"provocative":{"type":"string","enum":["unknown","low","medium","high"],"title":"Provocative","default":"unknown"},"reporting_voice":{"anyOf":[{"type":"string","enum":["Objective","Subjective","Investigative","Narrative","Analytical","Advocacy","Conversational","Satirical","Emotive","Explanatory","UnknownPersuasive","Sensational"]},{"type":"string"}],"title":"Reporting Voice","default":"Unknown"},"entity_relation_graph":{"anyOf":[{"properties":{"nodes":{"items":{"additionalProperties":{"type":"string"},"propertyNames":{"enum":["id","type","detailed_type","ner_type"]},"type":"object"},"type":"array","title":"Nodes","default":[]},"edges":{"items":{"additionalProperties":{"type":"string"},"propertyNames":{"enum":["from","to","label"]},"type":"object"},"type":"array","title":"Edges","default":[]}},"type":"object","title":"GraphRelationships"},{"type":"null"}]},"geo_coordinates":{"anyOf":[{"additionalProperties":{"properties":{"latitude":{"type":"number","title":"Latitude"},"longitude":{"type":"number","title":"Longitude"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["latitude","longitude","metadata"],"title":"GeoCoordinate"},"type":"object"},{"type":"null"}],"title":"Geo Coordinates"},"continent":{"anyOf":[{"type":"string","enum":["Africa","Asia","Europe","Middle East","North America","South America","Oceania"]},{"type":"null"}],"title":"Continent"},"assets":{"anyOf":[{"properties":{"images":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Images"},"videos":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Videos"}},"type":"object","title":"Assets"},{"type":"null"}]},"social_embeds":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Social Embeds"},"bias":{"anyOf":[{"type":"string","enum":["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"]},{"type":"null"}],"title":"Bias"},"authors":{"anyOf":[{"items":{"properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"}},"type":"object","title":"Author"},"type":"array"},{"type":"null"}],"title":"Authors"},"full_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Text"},"original_language_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Original Language Summary"},"image_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Description"},"crawl_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Crawl Date"},"content_type":{"anyOf":[{"type":"string","enum":["news","opinion","analysis","review","listicle","guide","interview","profile","forum","liveblog","fact-check","press_release","obituary","data_journalism"]},{"type":"null"}],"title":"Content Type"},"as_string_key":{"type":"string","title":"As String Key"}},"type":"object","required":["article_url","article_id","classification","country","source_id","page_rank","domain_url","eng_title","entities","keywords","language","pub_date","summary","title","sentiment","centroid_distance","cluster_probability","as_string_key"],"title":"SearchResponseDictItem"},"WebSearchResult":{"properties":{"title":{"type":"string","title":"Title"},"url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Url"},"source":{"type":"string","title":"Source"},"published":{"type":"string","title":"Published"},"key_points":{"items":{"type":"string"},"type":"array","title":"Key Points"},"raw_text":{"type":"string","title":"Raw Text","default":""},"as_string_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"As String Key"}},"type":"object","required":["title","url","source","published","key_points"],"title":"WebSearchResult"}},"anyOf":[{"$ref":"#/components/schemas/CreateDeepNewsResponse"},{"items":{"$ref":"#/components/schemas/CreateDeepNewsResponseStreamSource"},"type":"array"},{"items":{"$ref":"#/components/schemas/CreateDeepNewsResponseStreamChunk"},"type":"array"},{"items":{"$ref":"#/components/schemas/CreateDeepNewsResponseStreamChunkV2"},"type":"array"}],"properties":{"id":{"type":"string","title":"Id"},"created":{"type":"integer","title":"Created"},"object":{"type":"string","title":"Object","default":"chat.completion"},"model":{"type":"string","title":"Model","default":"claude-sonnet-5"},"usage":{"properties":{"prompt_tokens":{"type":"integer","title":"Prompt Tokens"},"completion_tokens":{"type":"integer","title":"Completion Tokens"},"total_tokens":{"type":"integer","title":"Total Tokens"},"tool_usage":{"anyOf":[{"additionalProperties":{"type":"integer"},"type":"object"},{"type":"null"}],"title":"Tool Usage"}},"type":"object","required":["prompt_tokens","completion_tokens","total_tokens"],"title":"CreateDeepNewsResponseUsage"},"choices":{"items":{"properties":{"index":{"type":"integer","title":"Index"},"message":{"properties":{"role":{"type":"string","title":"Role"},"content":{"type":"string","title":"Content"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"function_call":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Function Call"}},"type":"object","required":["role","content"],"title":"CreateDeepNewsRequestMessage"},"finish_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Finish Reason"}},"type":"object","required":["index","message"],"title":"CreateDeepNewsResponseChoice"},"type":"array","title":"Choices"},"sources":{"properties":{"news":{"anyOf":[{"items":{"properties":{"article_url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Article Url"},"article_id":{"type":"string","format":"uuid","title":"Article Id"},"classification":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"title":"Classification"},"country":{"type":"string","title":"Country"},"source_id":{"type":"string","title":"Source Id"},"page_rank":{"type":"integer","title":"Page Rank"},"domain_url":{"type":"string","title":"Domain Url"},"eng_title":{"type":"string","title":"Eng Title"},"entities":{"properties":{"Person":{"items":{"type":"string"},"type":"array","title":"Person","default":[]},"Organization":{"items":{"type":"string"},"type":"array","title":"Organization","default":[]},"Location":{"items":{"type":"string"},"type":"array","title":"Location","default":[]},"Nationality":{"items":{"type":"string"},"type":"array","title":"Nationality","default":[]},"Date":{"items":{"type":"string"},"type":"array","title":"Date","default":[]},"Event":{"items":{"type":"string"},"type":"array","title":"Event","default":[]},"Money":{"items":{"type":"string"},"type":"array","title":"Money","default":[]},"Law":{"items":{"type":"string"},"type":"array","title":"Law","default":[]},"Quantity":{"items":{"type":"string"},"type":"array","title":"Quantity","default":[]},"Time":{"items":{"type":"string"},"type":"array","title":"Time","default":[]},"Sports":{"items":{"type":"string"},"type":"array","title":"Sports","default":[]},"Politics":{"items":{"type":"string"},"type":"array","title":"Politics","default":[]},"Title":{"items":{"type":"string"},"type":"array","title":"Title","default":[]},"Number":{"items":{"type":"string"},"type":"array","title":"Number","default":[]},"Arms":{"items":{"type":"string"},"type":"array","title":"Arms","default":[]},"Product":{"items":{"type":"string"},"type":"array","title":"Product","default":[]},"Media":{"items":{"type":"string"},"type":"array","title":"Media","default":[]},"Transportation":{"items":{"type":"string"},"type":"array","title":"Transportation","default":[]},"Religion":{"items":{"type":"string"},"type":"array","title":"Religion","default":[]},"Technology":{"items":{"type":"string"},"type":"array","title":"Technology","default":[]},"Space":{"items":{"type":"string"},"type":"array","title":"Space","default":[]},"Medicine":{"items":{"type":"string"},"type":"array","title":"Medicine","default":[]},"Language":{"items":{"type":"string"},"type":"array","title":"Language","default":[]},"Science":{"items":{"type":"string"},"type":"array","title":"Science","default":[]}},"type":"object","title":"Entities"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url"},"keywords":{"items":{"type":"string"},"type":"array","title":"Keywords"},"language":{"type":"string","title":"Language"},"pub_date":{"type":"string","format":"date-time","title":"Pub Date"},"summary":{"type":"string","title":"Summary"},"key_points":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Key Points"},"title":{"type":"string","title":"Title"},"sentiment":{"type":"integer","title":"Sentiment"},"centroid_distance":{"type":"number","title":"Centroid Distance"},"cluster_probability":{"type":"number","title":"Cluster Probability"},"markdown_citation":{"type":"string","title":"Markdown Citation","default":""},"provocative":{"type":"string","enum":["unknown","low","medium","high"],"title":"Provocative","default":"unknown"},"reporting_voice":{"anyOf":[{"type":"string","enum":["Objective","Subjective","Investigative","Narrative","Analytical","Advocacy","Conversational","Satirical","Emotive","Explanatory","UnknownPersuasive","Sensational"]},{"type":"string"}],"title":"Reporting Voice","default":"Unknown"},"entity_relation_graph":{"anyOf":[{"properties":{"nodes":{"items":{"additionalProperties":{"type":"string"},"propertyNames":{"enum":["id","type","detailed_type","ner_type"]},"type":"object"},"type":"array","title":"Nodes","default":[]},"edges":{"items":{"additionalProperties":{"type":"string"},"propertyNames":{"enum":["from","to","label"]},"type":"object"},"type":"array","title":"Edges","default":[]}},"type":"object","title":"GraphRelationships"},{"type":"null"}]},"geo_coordinates":{"anyOf":[{"additionalProperties":{"properties":{"latitude":{"type":"number","title":"Latitude"},"longitude":{"type":"number","title":"Longitude"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["latitude","longitude","metadata"],"title":"GeoCoordinate"},"type":"object"},{"type":"null"}],"title":"Geo Coordinates"},"continent":{"anyOf":[{"type":"string","enum":["Africa","Asia","Europe","Middle East","North America","South America","Oceania"]},{"type":"null"}],"title":"Continent"},"assets":{"anyOf":[{"properties":{"images":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Images"},"videos":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Videos"}},"type":"object","title":"Assets"},{"type":"null"}]},"social_embeds":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Social Embeds"},"bias":{"anyOf":[{"type":"string","enum":["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"]},{"type":"null"}],"title":"Bias"},"authors":{"anyOf":[{"items":{"properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"}},"type":"object","title":"Author"},"type":"array"},{"type":"null"}],"title":"Authors"},"full_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Text"},"original_language_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Original Language Summary"},"image_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Description"},"crawl_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Crawl Date"},"content_type":{"anyOf":[{"type":"string","enum":["news","opinion","analysis","review","listicle","guide","interview","profile","forum","liveblog","fact-check","press_release","obituary","data_journalism"]},{"type":"null"}],"title":"Content Type"},"as_string_key":{"type":"string","title":"As String Key"}},"type":"object","required":["article_url","article_id","classification","country","source_id","page_rank","domain_url","eng_title","entities","keywords","language","pub_date","summary","title","sentiment","centroid_distance","cluster_probability","as_string_key"],"title":"SearchResponseDictItem"},"type":"array"},{"type":"null"}],"title":"News"},"web":{"anyOf":[{"items":{"properties":{"title":{"type":"string","title":"Title"},"url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Url"},"source":{"type":"string","title":"Source"},"published":{"type":"string","title":"Published"},"key_points":{"items":{"type":"string"},"type":"array","title":"Key Points"},"raw_text":{"type":"string","title":"Raw Text","default":""},"as_string_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"As String Key"}},"type":"object","required":["title","url","source","published","key_points"],"title":"WebSearchResult"},"type":"array"},{"type":"null"}],"title":"Web"}},"type":"object","title":"DeepNewsResponseSources"}},"type":"object","required":["id","created","usage","choices","sources"],"title":"CreateDeepNewsResponse"}},"text/event-stream":{"schema":{"oneOf":[{"$defs":{"CreateDeepNewsRequestMessage":{"properties":{"role":{"type":"string","title":"Role"},"content":{"type":"string","title":"Content"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"function_call":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Function Call"}},"type":"object","required":["role","content"],"title":"CreateDeepNewsRequestMessage"},"CreateDeepNewsResponseStreamChunkChoice":{"properties":{"index":{"type":"integer","title":"Index"},"delta":{"properties":{"role":{"type":"string","title":"Role"},"content":{"type":"string","title":"Content"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"function_call":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Function Call"}},"type":"object","required":["role","content"],"title":"CreateDeepNewsRequestMessage"},"finish_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Finish Reason"}},"type":"object","required":["index","delta"],"title":"CreateDeepNewsResponseStreamChunkChoice"},"CreateDeepNewsResponseUsage":{"properties":{"prompt_tokens":{"type":"integer","title":"Prompt Tokens"},"completion_tokens":{"type":"integer","title":"Completion Tokens"},"total_tokens":{"type":"integer","title":"Total Tokens"},"tool_usage":{"anyOf":[{"additionalProperties":{"type":"integer"},"type":"object"},{"type":"null"}],"title":"Tool Usage"}},"type":"object","required":["prompt_tokens","completion_tokens","total_tokens"],"title":"CreateDeepNewsResponseUsage"}},"properties":{"id":{"type":"string","title":"Id"},"created":{"type":"integer","title":"Created"},"object":{"type":"string","title":"Object","default":"chat.completion.chunk"},"model":{"type":"string","title":"Model","default":"claude-sonnet-5"},"usage":{"properties":{"prompt_tokens":{"type":"integer","title":"Prompt Tokens"},"completion_tokens":{"type":"integer","title":"Completion Tokens"},"total_tokens":{"type":"integer","title":"Total Tokens"},"tool_usage":{"anyOf":[{"additionalProperties":{"type":"integer"},"type":"object"},{"type":"null"}],"title":"Tool Usage"}},"type":"object","required":["prompt_tokens","completion_tokens","total_tokens"],"title":"CreateDeepNewsResponseUsage"},"choices":{"items":{"properties":{"index":{"type":"integer","title":"Index"},"delta":{"properties":{"role":{"type":"string","title":"Role"},"content":{"type":"string","title":"Content"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"function_call":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Function Call"}},"type":"object","required":["role","content"],"title":"CreateDeepNewsRequestMessage"},"finish_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Finish Reason"}},"type":"object","required":["index","delta"],"title":"CreateDeepNewsResponseStreamChunkChoice"},"type":"array","title":"Choices"}},"type":"object","required":["id","created","usage","choices"],"title":"CreateDeepNewsResponseStreamChunk"},{"$defs":{"AnthropicInputJsonDelta":{"properties":{"type":{"type":"string","const":"input_json_delta","title":"Type","default":"input_json_delta"},"partial_json":{"type":"string","title":"Partial Json"}},"type":"object","required":["partial_json"],"title":"AnthropicInputJsonDelta"},"AnthropicTextBlock":{"properties":{"type":{"type":"string","const":"text","title":"Type","default":"text"},"text":{"type":"string","title":"Text","default":""}},"type":"object","title":"AnthropicTextBlock"},"AnthropicTextDelta":{"properties":{"type":{"type":"string","const":"text_delta","title":"Type","default":"text_delta"},"text":{"type":"string","title":"Text"}},"type":"object","required":["text"],"title":"AnthropicTextDelta"},"AnthropicThinkingBlock":{"properties":{"type":{"type":"string","const":"thinking","title":"Type","default":"thinking"},"thinking":{"type":"string","title":"Thinking","default":""}},"type":"object","title":"AnthropicThinkingBlock"},"AnthropicThinkingDelta":{"properties":{"type":{"type":"string","const":"thinking_delta","title":"Type","default":"thinking_delta"},"thinking":{"type":"string","title":"Thinking"}},"type":"object","required":["thinking"],"title":"AnthropicThinkingDelta"},"AnthropicToolUseBlock":{"properties":{"type":{"type":"string","const":"tool_use","title":"Type","default":"tool_use"},"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"input":{"additionalProperties":true,"type":"object","title":"Input"}},"type":"object","required":["id","name"],"title":"AnthropicToolUseBlock"},"ContentBlockDeltaEvent":{"properties":{"type":{"type":"string","const":"content_block_delta","title":"Type","default":"content_block_delta"},"index":{"type":"integer","title":"Index"},"delta":{"oneOf":[{"properties":{"type":{"type":"string","const":"text_delta","title":"Type","default":"text_delta"},"text":{"type":"string","title":"Text"}},"type":"object","required":["text"],"title":"AnthropicTextDelta"},{"properties":{"type":{"type":"string","const":"thinking_delta","title":"Type","default":"thinking_delta"},"thinking":{"type":"string","title":"Thinking"}},"type":"object","required":["thinking"],"title":"AnthropicThinkingDelta"},{"properties":{"type":{"type":"string","const":"input_json_delta","title":"Type","default":"input_json_delta"},"partial_json":{"type":"string","title":"Partial Json"}},"type":"object","required":["partial_json"],"title":"AnthropicInputJsonDelta"}],"title":"Delta"}},"type":"object","required":["index","delta"],"title":"ContentBlockDeltaEvent"},"ContentBlockStartEvent":{"properties":{"type":{"type":"string","const":"content_block_start","title":"Type","default":"content_block_start"},"index":{"type":"integer","title":"Index"},"content_block":{"oneOf":[{"properties":{"type":{"type":"string","const":"text","title":"Type","default":"text"},"text":{"type":"string","title":"Text","default":""}},"type":"object","title":"AnthropicTextBlock"},{"properties":{"type":{"type":"string","const":"thinking","title":"Type","default":"thinking"},"thinking":{"type":"string","title":"Thinking","default":""}},"type":"object","title":"AnthropicThinkingBlock"},{"properties":{"type":{"type":"string","const":"tool_use","title":"Type","default":"tool_use"},"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"input":{"additionalProperties":true,"type":"object","title":"Input"}},"type":"object","required":["id","name"],"title":"AnthropicToolUseBlock"}],"title":"Content Block"}},"type":"object","required":["index","content_block"],"title":"ContentBlockStartEvent"},"ContentBlockStopEvent":{"properties":{"type":{"type":"string","const":"content_block_stop","title":"Type","default":"content_block_stop"},"index":{"type":"integer","title":"Index"}},"type":"object","required":["index"],"title":"ContentBlockStopEvent"},"CreateDeepNewsResponseStreamChunkChoiceV2":{"properties":{"index":{"type":"integer","title":"Index"},"delta":{"oneOf":[{"properties":{"type":{"type":"string","const":"message_start","title":"Type","default":"message_start"},"role":{"type":"string","const":"assistant","title":"Role","default":"assistant"}},"type":"object","title":"MessageStartEvent"},{"properties":{"type":{"type":"string","const":"content_block_start","title":"Type","default":"content_block_start"},"index":{"type":"integer","title":"Index"},"content_block":{"oneOf":[{"properties":{"type":{"type":"string","const":"text","title":"Type","default":"text"},"text":{"type":"string","title":"Text","default":""}},"type":"object","title":"AnthropicTextBlock"},{"properties":{"type":{"type":"string","const":"thinking","title":"Type","default":"thinking"},"thinking":{"type":"string","title":"Thinking","default":""}},"type":"object","title":"AnthropicThinkingBlock"},{"properties":{"type":{"type":"string","const":"tool_use","title":"Type","default":"tool_use"},"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"input":{"additionalProperties":true,"type":"object","title":"Input"}},"type":"object","required":["id","name"],"title":"AnthropicToolUseBlock"}],"title":"Content Block"}},"type":"object","required":["index","content_block"],"title":"ContentBlockStartEvent"},{"properties":{"type":{"type":"string","const":"content_block_delta","title":"Type","default":"content_block_delta"},"index":{"type":"integer","title":"Index"},"delta":{"oneOf":[{"properties":{"type":{"type":"string","const":"text_delta","title":"Type","default":"text_delta"},"text":{"type":"string","title":"Text"}},"type":"object","required":["text"],"title":"AnthropicTextDelta"},{"properties":{"type":{"type":"string","const":"thinking_delta","title":"Type","default":"thinking_delta"},"thinking":{"type":"string","title":"Thinking"}},"type":"object","required":["thinking"],"title":"AnthropicThinkingDelta"},{"properties":{"type":{"type":"string","const":"input_json_delta","title":"Type","default":"input_json_delta"},"partial_json":{"type":"string","title":"Partial Json"}},"type":"object","required":["partial_json"],"title":"AnthropicInputJsonDelta"}],"title":"Delta"}},"type":"object","required":["index","delta"],"title":"ContentBlockDeltaEvent"},{"properties":{"type":{"type":"string","const":"content_block_stop","title":"Type","default":"content_block_stop"},"index":{"type":"integer","title":"Index"}},"type":"object","required":["index"],"title":"ContentBlockStopEvent"},{"properties":{"type":{"type":"string","const":"message_stop","title":"Type","default":"message_stop"}},"type":"object","title":"MessageStopEvent"}],"title":"Delta"},"finish_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Finish Reason"}},"type":"object","required":["index","delta"],"title":"CreateDeepNewsResponseStreamChunkChoiceV2"},"CreateDeepNewsResponseUsage":{"properties":{"prompt_tokens":{"type":"integer","title":"Prompt Tokens"},"completion_tokens":{"type":"integer","title":"Completion Tokens"},"total_tokens":{"type":"integer","title":"Total Tokens"},"tool_usage":{"anyOf":[{"additionalProperties":{"type":"integer"},"type":"object"},{"type":"null"}],"title":"Tool Usage"}},"type":"object","required":["prompt_tokens","completion_tokens","total_tokens"],"title":"CreateDeepNewsResponseUsage"},"MessageStartEvent":{"properties":{"type":{"type":"string","const":"message_start","title":"Type","default":"message_start"},"role":{"type":"string","const":"assistant","title":"Role","default":"assistant"}},"type":"object","title":"MessageStartEvent"},"MessageStopEvent":{"properties":{"type":{"type":"string","const":"message_stop","title":"Type","default":"message_stop"}},"type":"object","title":"MessageStopEvent"}},"properties":{"id":{"type":"string","title":"Id"},"created":{"type":"integer","title":"Created"},"object":{"type":"string","title":"Object","default":"chat.completion.chunk"},"model":{"type":"string","title":"Model","default":"claude-sonnet-5"},"usage":{"properties":{"prompt_tokens":{"type":"integer","title":"Prompt Tokens"},"completion_tokens":{"type":"integer","title":"Completion Tokens"},"total_tokens":{"type":"integer","title":"Total Tokens"},"tool_usage":{"anyOf":[{"additionalProperties":{"type":"integer"},"type":"object"},{"type":"null"}],"title":"Tool Usage"}},"type":"object","required":["prompt_tokens","completion_tokens","total_tokens"],"title":"CreateDeepNewsResponseUsage"},"choices":{"items":{"properties":{"index":{"type":"integer","title":"Index"},"delta":{"oneOf":[{"properties":{"type":{"type":"string","const":"message_start","title":"Type","default":"message_start"},"role":{"type":"string","const":"assistant","title":"Role","default":"assistant"}},"type":"object","title":"MessageStartEvent"},{"properties":{"type":{"type":"string","const":"content_block_start","title":"Type","default":"content_block_start"},"index":{"type":"integer","title":"Index"},"content_block":{"oneOf":[{"properties":{"type":{"type":"string","const":"text","title":"Type","default":"text"},"text":{"type":"string","title":"Text","default":""}},"type":"object","title":"AnthropicTextBlock"},{"properties":{"type":{"type":"string","const":"thinking","title":"Type","default":"thinking"},"thinking":{"type":"string","title":"Thinking","default":""}},"type":"object","title":"AnthropicThinkingBlock"},{"properties":{"type":{"type":"string","const":"tool_use","title":"Type","default":"tool_use"},"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"input":{"additionalProperties":true,"type":"object","title":"Input"}},"type":"object","required":["id","name"],"title":"AnthropicToolUseBlock"}],"title":"Content Block"}},"type":"object","required":["index","content_block"],"title":"ContentBlockStartEvent"},{"properties":{"type":{"type":"string","const":"content_block_delta","title":"Type","default":"content_block_delta"},"index":{"type":"integer","title":"Index"},"delta":{"oneOf":[{"properties":{"type":{"type":"string","const":"text_delta","title":"Type","default":"text_delta"},"text":{"type":"string","title":"Text"}},"type":"object","required":["text"],"title":"AnthropicTextDelta"},{"properties":{"type":{"type":"string","const":"thinking_delta","title":"Type","default":"thinking_delta"},"thinking":{"type":"string","title":"Thinking"}},"type":"object","required":["thinking"],"title":"AnthropicThinkingDelta"},{"properties":{"type":{"type":"string","const":"input_json_delta","title":"Type","default":"input_json_delta"},"partial_json":{"type":"string","title":"Partial Json"}},"type":"object","required":["partial_json"],"title":"AnthropicInputJsonDelta"}],"title":"Delta"}},"type":"object","required":["index","delta"],"title":"ContentBlockDeltaEvent"},{"properties":{"type":{"type":"string","const":"content_block_stop","title":"Type","default":"content_block_stop"},"index":{"type":"integer","title":"Index"}},"type":"object","required":["index"],"title":"ContentBlockStopEvent"},{"properties":{"type":{"type":"string","const":"message_stop","title":"Type","default":"message_stop"}},"type":"object","title":"MessageStopEvent"}],"title":"Delta"},"finish_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Finish Reason"}},"type":"object","required":["index","delta"],"title":"CreateDeepNewsResponseStreamChunkChoiceV2"},"type":"array","title":"Choices"}},"type":"object","required":["id","created","usage","choices"],"title":"CreateDeepNewsResponseStreamChunkV2"},{"$defs":{"Assets":{"properties":{"images":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Images"},"videos":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Videos"}},"type":"object","title":"Assets"},"Author":{"properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"}},"type":"object","title":"Author"},"ChartParameters":{"properties":{"chart_type":{"type":"string","enum":["line","bar","bar_pct"],"title":"Chart Type","description":"The type of chart to create"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"The title of the chart"},"series":{"items":{"properties":{"name":{"type":"string","title":"Name"},"start_datetime":{"type":"string","format":"date-time","title":"Start Datetime"},"end_datetime":{"type":"string","format":"date-time","title":"End Datetime"},"sampling":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sampling","default":"1d"},"time_filter":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time Filter","default":"pub_date"},"categories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Categories"},"domains":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Domains"},"bad_domain_url":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Bad Domain Url"},"page_rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page Rank"},"string_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"String Guarantee"},"string_guarantee_op":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"String Guarantee Op","default":"OR"},"reverse_string_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Reverse String Guarantee"},"entity_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Entity Guarantee"},"entity_guarantee_op":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Guarantee Op","default":"OR"},"countries":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Countries"},"countries_blacklist":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Countries Blacklist"},"continents":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Continents"},"languages":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Languages"},"sentiment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sentiment"},"reporting_voice":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Reporting Voice"},"provocative":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provocative","default":"all"}},"type":"object","required":["name","start_datetime","end_datetime"],"title":"SeriesConfig"},"type":"array","title":"Series","description":"The series configurations for the chart"}},"type":"object","required":["chart_type","series"],"title":"ChartParameters"},"ChartResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"chart_json":{"additionalProperties":true,"type":"object","title":"Chart Json","description":"The plotly fig.to_json() JSON representation of the chart"},"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query"},"reasoning":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reasoning"},"parameters":{"anyOf":[{"properties":{"chart_type":{"type":"string","enum":["line","bar","bar_pct"],"title":"Chart Type","description":"The type of chart to create"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"The title of the chart"},"series":{"items":{"properties":{"name":{"type":"string","title":"Name"},"start_datetime":{"type":"string","format":"date-time","title":"Start Datetime"},"end_datetime":{"type":"string","format":"date-time","title":"End Datetime"},"sampling":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sampling","default":"1d"},"time_filter":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time Filter","default":"pub_date"},"categories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Categories"},"domains":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Domains"},"bad_domain_url":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Bad Domain Url"},"page_rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page Rank"},"string_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"String Guarantee"},"string_guarantee_op":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"String Guarantee Op","default":"OR"},"reverse_string_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Reverse String Guarantee"},"entity_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Entity Guarantee"},"entity_guarantee_op":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Guarantee Op","default":"OR"},"countries":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Countries"},"countries_blacklist":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Countries Blacklist"},"continents":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Continents"},"languages":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Languages"},"sentiment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sentiment"},"reporting_voice":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Reporting Voice"},"provocative":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provocative","default":"all"}},"type":"object","required":["name","start_datetime","end_datetime"],"title":"SeriesConfig"},"type":"array","title":"Series","description":"The series configurations for the chart"}},"type":"object","required":["chart_type","series"],"title":"ChartParameters"},{"type":"null"}]},"context":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Context"},"iterations_used":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Iterations Used"},"last_reasoning":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Reasoning"},"last_parameters":{"anyOf":[{"properties":{"chart_type":{"type":"string","enum":["line","bar","bar_pct"],"title":"Chart Type","description":"The type of chart to create"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"The title of the chart"},"series":{"items":{"properties":{"name":{"type":"string","title":"Name"},"start_datetime":{"type":"string","format":"date-time","title":"Start Datetime"},"end_datetime":{"type":"string","format":"date-time","title":"End Datetime"},"sampling":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sampling","default":"1d"},"time_filter":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time Filter","default":"pub_date"},"categories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Categories"},"domains":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Domains"},"bad_domain_url":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Bad Domain Url"},"page_rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page Rank"},"string_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"String Guarantee"},"string_guarantee_op":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"String Guarantee Op","default":"OR"},"reverse_string_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Reverse String Guarantee"},"entity_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Entity Guarantee"},"entity_guarantee_op":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Guarantee Op","default":"OR"},"countries":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Countries"},"countries_blacklist":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Countries Blacklist"},"continents":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Continents"},"languages":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Languages"},"sentiment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sentiment"},"reporting_voice":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Reporting Voice"},"provocative":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provocative","default":"all"}},"type":"object","required":["name","start_datetime","end_datetime"],"title":"SeriesConfig"},"type":"array","title":"Series","description":"The series configurations for the chart"}},"type":"object","required":["chart_type","series"],"title":"ChartParameters"},{"type":"null"}]},"png_data":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Png Data","description":"Base64-encoded PNG image data of the chart"},"png_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Png Url","description":"URL to the PNG image of the chart"},"chart_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chart Url","description":"URL to the chart JSON object in S3"}},"type":"object","required":["success","chart_json"],"title":"ChartResponse"},"CreateDeepNewsResponseStreamSourcesChartSource":{"properties":{"kind":{"type":"string","const":"chart","title":"Kind","default":"chart"},"data":{"properties":{"success":{"type":"boolean","title":"Success"},"chart_json":{"additionalProperties":true,"type":"object","title":"Chart Json","description":"The plotly fig.to_json() JSON representation of the chart"},"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query"},"reasoning":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reasoning"},"parameters":{"anyOf":[{"properties":{"chart_type":{"type":"string","enum":["line","bar","bar_pct"],"title":"Chart Type","description":"The type of chart to create"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"The title of the chart"},"series":{"items":{"properties":{"name":{"type":"string","title":"Name"},"start_datetime":{"type":"string","format":"date-time","title":"Start Datetime"},"end_datetime":{"type":"string","format":"date-time","title":"End Datetime"},"sampling":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sampling","default":"1d"},"time_filter":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time Filter","default":"pub_date"},"categories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Categories"},"domains":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Domains"},"bad_domain_url":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Bad Domain Url"},"page_rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page Rank"},"string_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"String Guarantee"},"string_guarantee_op":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"String Guarantee Op","default":"OR"},"reverse_string_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Reverse String Guarantee"},"entity_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Entity Guarantee"},"entity_guarantee_op":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Guarantee Op","default":"OR"},"countries":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Countries"},"countries_blacklist":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Countries Blacklist"},"continents":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Continents"},"languages":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Languages"},"sentiment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sentiment"},"reporting_voice":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Reporting Voice"},"provocative":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provocative","default":"all"}},"type":"object","required":["name","start_datetime","end_datetime"],"title":"SeriesConfig"},"type":"array","title":"Series","description":"The series configurations for the chart"}},"type":"object","required":["chart_type","series"],"title":"ChartParameters"},{"type":"null"}]},"context":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Context"},"iterations_used":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Iterations Used"},"last_reasoning":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Reasoning"},"last_parameters":{"anyOf":[{"properties":{"chart_type":{"type":"string","enum":["line","bar","bar_pct"],"title":"Chart Type","description":"The type of chart to create"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"The title of the chart"},"series":{"items":{"properties":{"name":{"type":"string","title":"Name"},"start_datetime":{"type":"string","format":"date-time","title":"Start Datetime"},"end_datetime":{"type":"string","format":"date-time","title":"End Datetime"},"sampling":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sampling","default":"1d"},"time_filter":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time Filter","default":"pub_date"},"categories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Categories"},"domains":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Domains"},"bad_domain_url":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Bad Domain Url"},"page_rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page Rank"},"string_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"String Guarantee"},"string_guarantee_op":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"String Guarantee Op","default":"OR"},"reverse_string_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Reverse String Guarantee"},"entity_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Entity Guarantee"},"entity_guarantee_op":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Guarantee Op","default":"OR"},"countries":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Countries"},"countries_blacklist":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Countries Blacklist"},"continents":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Continents"},"languages":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Languages"},"sentiment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sentiment"},"reporting_voice":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Reporting Voice"},"provocative":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provocative","default":"all"}},"type":"object","required":["name","start_datetime","end_datetime"],"title":"SeriesConfig"},"type":"array","title":"Series","description":"The series configurations for the chart"}},"type":"object","required":["chart_type","series"],"title":"ChartParameters"},{"type":"null"}]},"png_data":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Png Data","description":"Base64-encoded PNG image data of the chart"},"png_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Png Url","description":"URL to the PNG image of the chart"},"chart_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chart Url","description":"URL to the chart JSON object in S3"}},"type":"object","required":["success","chart_json"],"title":"ChartResponse"}},"type":"object","required":["data"],"title":"CreateDeepNewsResponseStreamSourcesChartSource"},"CreateDeepNewsResponseStreamSourcesGraphSource":{"properties":{"kind":{"type":"string","const":"graph","title":"Kind","default":"graph"},"data":{"type":"string","minLength":1,"format":"uri","title":"Data"}},"type":"object","required":["data"],"title":"CreateDeepNewsResponseStreamSourcesGraphSource"},"CreateDeepNewsResponseStreamSourcesNewsSource":{"properties":{"kind":{"type":"string","const":"news","title":"Kind","default":"news"},"data":{"properties":{"article_url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Article Url"},"article_id":{"type":"string","format":"uuid","title":"Article Id"},"classification":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"title":"Classification"},"country":{"type":"string","title":"Country"},"source_id":{"type":"string","title":"Source Id"},"page_rank":{"type":"integer","title":"Page Rank"},"domain_url":{"type":"string","title":"Domain Url"},"eng_title":{"type":"string","title":"Eng Title"},"entities":{"properties":{"Person":{"items":{"type":"string"},"type":"array","title":"Person","default":[]},"Organization":{"items":{"type":"string"},"type":"array","title":"Organization","default":[]},"Location":{"items":{"type":"string"},"type":"array","title":"Location","default":[]},"Nationality":{"items":{"type":"string"},"type":"array","title":"Nationality","default":[]},"Date":{"items":{"type":"string"},"type":"array","title":"Date","default":[]},"Event":{"items":{"type":"string"},"type":"array","title":"Event","default":[]},"Money":{"items":{"type":"string"},"type":"array","title":"Money","default":[]},"Law":{"items":{"type":"string"},"type":"array","title":"Law","default":[]},"Quantity":{"items":{"type":"string"},"type":"array","title":"Quantity","default":[]},"Time":{"items":{"type":"string"},"type":"array","title":"Time","default":[]},"Sports":{"items":{"type":"string"},"type":"array","title":"Sports","default":[]},"Politics":{"items":{"type":"string"},"type":"array","title":"Politics","default":[]},"Title":{"items":{"type":"string"},"type":"array","title":"Title","default":[]},"Number":{"items":{"type":"string"},"type":"array","title":"Number","default":[]},"Arms":{"items":{"type":"string"},"type":"array","title":"Arms","default":[]},"Product":{"items":{"type":"string"},"type":"array","title":"Product","default":[]},"Media":{"items":{"type":"string"},"type":"array","title":"Media","default":[]},"Transportation":{"items":{"type":"string"},"type":"array","title":"Transportation","default":[]},"Religion":{"items":{"type":"string"},"type":"array","title":"Religion","default":[]},"Technology":{"items":{"type":"string"},"type":"array","title":"Technology","default":[]},"Space":{"items":{"type":"string"},"type":"array","title":"Space","default":[]},"Medicine":{"items":{"type":"string"},"type":"array","title":"Medicine","default":[]},"Language":{"items":{"type":"string"},"type":"array","title":"Language","default":[]},"Science":{"items":{"type":"string"},"type":"array","title":"Science","default":[]}},"type":"object","title":"Entities"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url"},"keywords":{"items":{"type":"string"},"type":"array","title":"Keywords"},"language":{"type":"string","title":"Language"},"pub_date":{"type":"string","format":"date-time","title":"Pub Date"},"summary":{"type":"string","title":"Summary"},"key_points":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Key Points"},"title":{"type":"string","title":"Title"},"sentiment":{"type":"integer","title":"Sentiment"},"centroid_distance":{"type":"number","title":"Centroid Distance"},"cluster_probability":{"type":"number","title":"Cluster Probability"},"markdown_citation":{"type":"string","title":"Markdown Citation","default":""},"provocative":{"type":"string","enum":["unknown","low","medium","high"],"title":"Provocative","default":"unknown"},"reporting_voice":{"anyOf":[{"type":"string","enum":["Objective","Subjective","Investigative","Narrative","Analytical","Advocacy","Conversational","Satirical","Emotive","Explanatory","UnknownPersuasive","Sensational"]},{"type":"string"}],"title":"Reporting Voice","default":"Unknown"},"entity_relation_graph":{"anyOf":[{"properties":{"nodes":{"items":{"additionalProperties":{"type":"string"},"propertyNames":{"enum":["id","type","detailed_type","ner_type"]},"type":"object"},"type":"array","title":"Nodes","default":[]},"edges":{"items":{"additionalProperties":{"type":"string"},"propertyNames":{"enum":["from","to","label"]},"type":"object"},"type":"array","title":"Edges","default":[]}},"type":"object","title":"GraphRelationships"},{"type":"null"}]},"geo_coordinates":{"anyOf":[{"additionalProperties":{"properties":{"latitude":{"type":"number","title":"Latitude"},"longitude":{"type":"number","title":"Longitude"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["latitude","longitude","metadata"],"title":"GeoCoordinate"},"type":"object"},{"type":"null"}],"title":"Geo Coordinates"},"continent":{"anyOf":[{"type":"string","enum":["Africa","Asia","Europe","Middle East","North America","South America","Oceania"]},{"type":"null"}],"title":"Continent"},"assets":{"anyOf":[{"properties":{"images":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Images"},"videos":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Videos"}},"type":"object","title":"Assets"},{"type":"null"}]},"social_embeds":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Social Embeds"},"bias":{"anyOf":[{"type":"string","enum":["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"]},{"type":"null"}],"title":"Bias"},"authors":{"anyOf":[{"items":{"properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"}},"type":"object","title":"Author"},"type":"array"},{"type":"null"}],"title":"Authors"},"full_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Text"},"original_language_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Original Language Summary"},"image_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Description"},"crawl_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Crawl Date"},"content_type":{"anyOf":[{"type":"string","enum":["news","opinion","analysis","review","listicle","guide","interview","profile","forum","liveblog","fact-check","press_release","obituary","data_journalism"]},{"type":"null"}],"title":"Content Type"},"as_string_key":{"type":"string","title":"As String Key"}},"type":"object","required":["article_url","article_id","classification","country","source_id","page_rank","domain_url","eng_title","entities","keywords","language","pub_date","summary","title","sentiment","centroid_distance","cluster_probability","as_string_key"],"title":"SearchResponseDictItem"}},"type":"object","required":["data"],"title":"CreateDeepNewsResponseStreamSourcesNewsSource"},"CreateDeepNewsResponseStreamSourcesWebSource":{"properties":{"kind":{"type":"string","const":"web","title":"Kind","default":"web"},"data":{"properties":{"title":{"type":"string","title":"Title"},"url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Url"},"source":{"type":"string","title":"Source"},"published":{"type":"string","title":"Published"},"key_points":{"items":{"type":"string"},"type":"array","title":"Key Points"},"raw_text":{"type":"string","title":"Raw Text","default":""},"as_string_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"As String Key"}},"type":"object","required":["title","url","source","published","key_points"],"title":"WebSearchResult"}},"type":"object","required":["data"],"title":"CreateDeepNewsResponseStreamSourcesWebSource"},"Entities":{"properties":{"Person":{"items":{"type":"string"},"type":"array","title":"Person","default":[]},"Organization":{"items":{"type":"string"},"type":"array","title":"Organization","default":[]},"Location":{"items":{"type":"string"},"type":"array","title":"Location","default":[]},"Nationality":{"items":{"type":"string"},"type":"array","title":"Nationality","default":[]},"Date":{"items":{"type":"string"},"type":"array","title":"Date","default":[]},"Event":{"items":{"type":"string"},"type":"array","title":"Event","default":[]},"Money":{"items":{"type":"string"},"type":"array","title":"Money","default":[]},"Law":{"items":{"type":"string"},"type":"array","title":"Law","default":[]},"Quantity":{"items":{"type":"string"},"type":"array","title":"Quantity","default":[]},"Time":{"items":{"type":"string"},"type":"array","title":"Time","default":[]},"Sports":{"items":{"type":"string"},"type":"array","title":"Sports","default":[]},"Politics":{"items":{"type":"string"},"type":"array","title":"Politics","default":[]},"Title":{"items":{"type":"string"},"type":"array","title":"Title","default":[]},"Number":{"items":{"type":"string"},"type":"array","title":"Number","default":[]},"Arms":{"items":{"type":"string"},"type":"array","title":"Arms","default":[]},"Product":{"items":{"type":"string"},"type":"array","title":"Product","default":[]},"Media":{"items":{"type":"string"},"type":"array","title":"Media","default":[]},"Transportation":{"items":{"type":"string"},"type":"array","title":"Transportation","default":[]},"Religion":{"items":{"type":"string"},"type":"array","title":"Religion","default":[]},"Technology":{"items":{"type":"string"},"type":"array","title":"Technology","default":[]},"Space":{"items":{"type":"string"},"type":"array","title":"Space","default":[]},"Medicine":{"items":{"type":"string"},"type":"array","title":"Medicine","default":[]},"Language":{"items":{"type":"string"},"type":"array","title":"Language","default":[]},"Science":{"items":{"type":"string"},"type":"array","title":"Science","default":[]}},"type":"object","title":"Entities"},"GeoCoordinate":{"properties":{"latitude":{"type":"number","title":"Latitude"},"longitude":{"type":"number","title":"Longitude"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["latitude","longitude","metadata"],"title":"GeoCoordinate"},"GraphRelationships":{"properties":{"nodes":{"items":{"additionalProperties":{"type":"string"},"propertyNames":{"enum":["id","type","detailed_type","ner_type"]},"type":"object"},"type":"array","title":"Nodes","default":[]},"edges":{"items":{"additionalProperties":{"type":"string"},"propertyNames":{"enum":["from","to","label"]},"type":"object"},"type":"array","title":"Edges","default":[]}},"type":"object","title":"GraphRelationships"},"SearchResponseDictItem":{"properties":{"article_url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Article Url"},"article_id":{"type":"string","format":"uuid","title":"Article Id"},"classification":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"title":"Classification"},"country":{"type":"string","title":"Country"},"source_id":{"type":"string","title":"Source Id"},"page_rank":{"type":"integer","title":"Page Rank"},"domain_url":{"type":"string","title":"Domain Url"},"eng_title":{"type":"string","title":"Eng Title"},"entities":{"properties":{"Person":{"items":{"type":"string"},"type":"array","title":"Person","default":[]},"Organization":{"items":{"type":"string"},"type":"array","title":"Organization","default":[]},"Location":{"items":{"type":"string"},"type":"array","title":"Location","default":[]},"Nationality":{"items":{"type":"string"},"type":"array","title":"Nationality","default":[]},"Date":{"items":{"type":"string"},"type":"array","title":"Date","default":[]},"Event":{"items":{"type":"string"},"type":"array","title":"Event","default":[]},"Money":{"items":{"type":"string"},"type":"array","title":"Money","default":[]},"Law":{"items":{"type":"string"},"type":"array","title":"Law","default":[]},"Quantity":{"items":{"type":"string"},"type":"array","title":"Quantity","default":[]},"Time":{"items":{"type":"string"},"type":"array","title":"Time","default":[]},"Sports":{"items":{"type":"string"},"type":"array","title":"Sports","default":[]},"Politics":{"items":{"type":"string"},"type":"array","title":"Politics","default":[]},"Title":{"items":{"type":"string"},"type":"array","title":"Title","default":[]},"Number":{"items":{"type":"string"},"type":"array","title":"Number","default":[]},"Arms":{"items":{"type":"string"},"type":"array","title":"Arms","default":[]},"Product":{"items":{"type":"string"},"type":"array","title":"Product","default":[]},"Media":{"items":{"type":"string"},"type":"array","title":"Media","default":[]},"Transportation":{"items":{"type":"string"},"type":"array","title":"Transportation","default":[]},"Religion":{"items":{"type":"string"},"type":"array","title":"Religion","default":[]},"Technology":{"items":{"type":"string"},"type":"array","title":"Technology","default":[]},"Space":{"items":{"type":"string"},"type":"array","title":"Space","default":[]},"Medicine":{"items":{"type":"string"},"type":"array","title":"Medicine","default":[]},"Language":{"items":{"type":"string"},"type":"array","title":"Language","default":[]},"Science":{"items":{"type":"string"},"type":"array","title":"Science","default":[]}},"type":"object","title":"Entities"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url"},"keywords":{"items":{"type":"string"},"type":"array","title":"Keywords"},"language":{"type":"string","title":"Language"},"pub_date":{"type":"string","format":"date-time","title":"Pub Date"},"summary":{"type":"string","title":"Summary"},"key_points":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Key Points"},"title":{"type":"string","title":"Title"},"sentiment":{"type":"integer","title":"Sentiment"},"centroid_distance":{"type":"number","title":"Centroid Distance"},"cluster_probability":{"type":"number","title":"Cluster Probability"},"markdown_citation":{"type":"string","title":"Markdown Citation","default":""},"provocative":{"type":"string","enum":["unknown","low","medium","high"],"title":"Provocative","default":"unknown"},"reporting_voice":{"anyOf":[{"type":"string","enum":["Objective","Subjective","Investigative","Narrative","Analytical","Advocacy","Conversational","Satirical","Emotive","Explanatory","UnknownPersuasive","Sensational"]},{"type":"string"}],"title":"Reporting Voice","default":"Unknown"},"entity_relation_graph":{"anyOf":[{"properties":{"nodes":{"items":{"additionalProperties":{"type":"string"},"propertyNames":{"enum":["id","type","detailed_type","ner_type"]},"type":"object"},"type":"array","title":"Nodes","default":[]},"edges":{"items":{"additionalProperties":{"type":"string"},"propertyNames":{"enum":["from","to","label"]},"type":"object"},"type":"array","title":"Edges","default":[]}},"type":"object","title":"GraphRelationships"},{"type":"null"}]},"geo_coordinates":{"anyOf":[{"additionalProperties":{"properties":{"latitude":{"type":"number","title":"Latitude"},"longitude":{"type":"number","title":"Longitude"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["latitude","longitude","metadata"],"title":"GeoCoordinate"},"type":"object"},{"type":"null"}],"title":"Geo Coordinates"},"continent":{"anyOf":[{"type":"string","enum":["Africa","Asia","Europe","Middle East","North America","South America","Oceania"]},{"type":"null"}],"title":"Continent"},"assets":{"anyOf":[{"properties":{"images":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Images"},"videos":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Videos"}},"type":"object","title":"Assets"},{"type":"null"}]},"social_embeds":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Social Embeds"},"bias":{"anyOf":[{"type":"string","enum":["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"]},{"type":"null"}],"title":"Bias"},"authors":{"anyOf":[{"items":{"properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"}},"type":"object","title":"Author"},"type":"array"},{"type":"null"}],"title":"Authors"},"full_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Text"},"original_language_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Original Language Summary"},"image_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Description"},"crawl_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Crawl Date"},"content_type":{"anyOf":[{"type":"string","enum":["news","opinion","analysis","review","listicle","guide","interview","profile","forum","liveblog","fact-check","press_release","obituary","data_journalism"]},{"type":"null"}],"title":"Content Type"},"as_string_key":{"type":"string","title":"As String Key"}},"type":"object","required":["article_url","article_id","classification","country","source_id","page_rank","domain_url","eng_title","entities","keywords","language","pub_date","summary","title","sentiment","centroid_distance","cluster_probability","as_string_key"],"title":"SearchResponseDictItem"},"SeriesConfig":{"properties":{"name":{"type":"string","title":"Name"},"start_datetime":{"type":"string","format":"date-time","title":"Start Datetime"},"end_datetime":{"type":"string","format":"date-time","title":"End Datetime"},"sampling":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sampling","default":"1d"},"time_filter":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time Filter","default":"pub_date"},"categories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Categories"},"domains":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Domains"},"bad_domain_url":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Bad Domain Url"},"page_rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page Rank"},"string_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"String Guarantee"},"string_guarantee_op":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"String Guarantee Op","default":"OR"},"reverse_string_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Reverse String Guarantee"},"entity_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Entity Guarantee"},"entity_guarantee_op":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Guarantee Op","default":"OR"},"countries":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Countries"},"countries_blacklist":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Countries Blacklist"},"continents":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Continents"},"languages":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Languages"},"sentiment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sentiment"},"reporting_voice":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Reporting Voice"},"provocative":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provocative","default":"all"}},"type":"object","required":["name","start_datetime","end_datetime"],"title":"SeriesConfig"},"WebSearchResult":{"properties":{"title":{"type":"string","title":"Title"},"url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Url"},"source":{"type":"string","title":"Source"},"published":{"type":"string","title":"Published"},"key_points":{"items":{"type":"string"},"type":"array","title":"Key Points"},"raw_text":{"type":"string","title":"Raw Text","default":""},"as_string_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"As String Key"}},"type":"object","required":["title","url","source","published","key_points"],"title":"WebSearchResult"}},"properties":{"id":{"type":"string","title":"Id"},"created":{"type":"integer","title":"Created"},"object":{"type":"string","title":"Object","default":"chat.completion.source"},"source":{"anyOf":[{"properties":{"kind":{"type":"string","const":"news","title":"Kind","default":"news"},"data":{"properties":{"article_url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Article Url"},"article_id":{"type":"string","format":"uuid","title":"Article Id"},"classification":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"title":"Classification"},"country":{"type":"string","title":"Country"},"source_id":{"type":"string","title":"Source Id"},"page_rank":{"type":"integer","title":"Page Rank"},"domain_url":{"type":"string","title":"Domain Url"},"eng_title":{"type":"string","title":"Eng Title"},"entities":{"properties":{"Person":{"items":{"type":"string"},"type":"array","title":"Person","default":[]},"Organization":{"items":{"type":"string"},"type":"array","title":"Organization","default":[]},"Location":{"items":{"type":"string"},"type":"array","title":"Location","default":[]},"Nationality":{"items":{"type":"string"},"type":"array","title":"Nationality","default":[]},"Date":{"items":{"type":"string"},"type":"array","title":"Date","default":[]},"Event":{"items":{"type":"string"},"type":"array","title":"Event","default":[]},"Money":{"items":{"type":"string"},"type":"array","title":"Money","default":[]},"Law":{"items":{"type":"string"},"type":"array","title":"Law","default":[]},"Quantity":{"items":{"type":"string"},"type":"array","title":"Quantity","default":[]},"Time":{"items":{"type":"string"},"type":"array","title":"Time","default":[]},"Sports":{"items":{"type":"string"},"type":"array","title":"Sports","default":[]},"Politics":{"items":{"type":"string"},"type":"array","title":"Politics","default":[]},"Title":{"items":{"type":"string"},"type":"array","title":"Title","default":[]},"Number":{"items":{"type":"string"},"type":"array","title":"Number","default":[]},"Arms":{"items":{"type":"string"},"type":"array","title":"Arms","default":[]},"Product":{"items":{"type":"string"},"type":"array","title":"Product","default":[]},"Media":{"items":{"type":"string"},"type":"array","title":"Media","default":[]},"Transportation":{"items":{"type":"string"},"type":"array","title":"Transportation","default":[]},"Religion":{"items":{"type":"string"},"type":"array","title":"Religion","default":[]},"Technology":{"items":{"type":"string"},"type":"array","title":"Technology","default":[]},"Space":{"items":{"type":"string"},"type":"array","title":"Space","default":[]},"Medicine":{"items":{"type":"string"},"type":"array","title":"Medicine","default":[]},"Language":{"items":{"type":"string"},"type":"array","title":"Language","default":[]},"Science":{"items":{"type":"string"},"type":"array","title":"Science","default":[]}},"type":"object","title":"Entities"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url"},"keywords":{"items":{"type":"string"},"type":"array","title":"Keywords"},"language":{"type":"string","title":"Language"},"pub_date":{"type":"string","format":"date-time","title":"Pub Date"},"summary":{"type":"string","title":"Summary"},"key_points":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Key Points"},"title":{"type":"string","title":"Title"},"sentiment":{"type":"integer","title":"Sentiment"},"centroid_distance":{"type":"number","title":"Centroid Distance"},"cluster_probability":{"type":"number","title":"Cluster Probability"},"markdown_citation":{"type":"string","title":"Markdown Citation","default":""},"provocative":{"type":"string","enum":["unknown","low","medium","high"],"title":"Provocative","default":"unknown"},"reporting_voice":{"anyOf":[{"type":"string","enum":["Objective","Subjective","Investigative","Narrative","Analytical","Advocacy","Conversational","Satirical","Emotive","Explanatory","UnknownPersuasive","Sensational"]},{"type":"string"}],"title":"Reporting Voice","default":"Unknown"},"entity_relation_graph":{"anyOf":[{"properties":{"nodes":{"items":{"additionalProperties":{"type":"string"},"propertyNames":{"enum":["id","type","detailed_type","ner_type"]},"type":"object"},"type":"array","title":"Nodes","default":[]},"edges":{"items":{"additionalProperties":{"type":"string"},"propertyNames":{"enum":["from","to","label"]},"type":"object"},"type":"array","title":"Edges","default":[]}},"type":"object","title":"GraphRelationships"},{"type":"null"}]},"geo_coordinates":{"anyOf":[{"additionalProperties":{"properties":{"latitude":{"type":"number","title":"Latitude"},"longitude":{"type":"number","title":"Longitude"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["latitude","longitude","metadata"],"title":"GeoCoordinate"},"type":"object"},{"type":"null"}],"title":"Geo Coordinates"},"continent":{"anyOf":[{"type":"string","enum":["Africa","Asia","Europe","Middle East","North America","South America","Oceania"]},{"type":"null"}],"title":"Continent"},"assets":{"anyOf":[{"properties":{"images":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Images"},"videos":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Videos"}},"type":"object","title":"Assets"},{"type":"null"}]},"social_embeds":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Social Embeds"},"bias":{"anyOf":[{"type":"string","enum":["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"]},{"type":"null"}],"title":"Bias"},"authors":{"anyOf":[{"items":{"properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"}},"type":"object","title":"Author"},"type":"array"},{"type":"null"}],"title":"Authors"},"full_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Text"},"original_language_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Original Language Summary"},"image_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Description"},"crawl_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Crawl Date"},"content_type":{"anyOf":[{"type":"string","enum":["news","opinion","analysis","review","listicle","guide","interview","profile","forum","liveblog","fact-check","press_release","obituary","data_journalism"]},{"type":"null"}],"title":"Content Type"},"as_string_key":{"type":"string","title":"As String Key"}},"type":"object","required":["article_url","article_id","classification","country","source_id","page_rank","domain_url","eng_title","entities","keywords","language","pub_date","summary","title","sentiment","centroid_distance","cluster_probability","as_string_key"],"title":"SearchResponseDictItem"}},"type":"object","required":["data"],"title":"CreateDeepNewsResponseStreamSourcesNewsSource"},{"properties":{"kind":{"type":"string","const":"web","title":"Kind","default":"web"},"data":{"properties":{"title":{"type":"string","title":"Title"},"url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Url"},"source":{"type":"string","title":"Source"},"published":{"type":"string","title":"Published"},"key_points":{"items":{"type":"string"},"type":"array","title":"Key Points"},"raw_text":{"type":"string","title":"Raw Text","default":""},"as_string_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"As String Key"}},"type":"object","required":["title","url","source","published","key_points"],"title":"WebSearchResult"}},"type":"object","required":["data"],"title":"CreateDeepNewsResponseStreamSourcesWebSource"},{"properties":{"kind":{"type":"string","const":"graph","title":"Kind","default":"graph"},"data":{"type":"string","minLength":1,"format":"uri","title":"Data"}},"type":"object","required":["data"],"title":"CreateDeepNewsResponseStreamSourcesGraphSource"},{"properties":{"kind":{"type":"string","const":"chart","title":"Kind","default":"chart"},"data":{"properties":{"success":{"type":"boolean","title":"Success"},"chart_json":{"additionalProperties":true,"type":"object","title":"Chart Json","description":"The plotly fig.to_json() JSON representation of the chart"},"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query"},"reasoning":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reasoning"},"parameters":{"anyOf":[{"properties":{"chart_type":{"type":"string","enum":["line","bar","bar_pct"],"title":"Chart Type","description":"The type of chart to create"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"The title of the chart"},"series":{"items":{"properties":{"name":{"type":"string","title":"Name"},"start_datetime":{"type":"string","format":"date-time","title":"Start Datetime"},"end_datetime":{"type":"string","format":"date-time","title":"End Datetime"},"sampling":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sampling","default":"1d"},"time_filter":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time Filter","default":"pub_date"},"categories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Categories"},"domains":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Domains"},"bad_domain_url":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Bad Domain Url"},"page_rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page Rank"},"string_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"String Guarantee"},"string_guarantee_op":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"String Guarantee Op","default":"OR"},"reverse_string_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Reverse String Guarantee"},"entity_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Entity Guarantee"},"entity_guarantee_op":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Guarantee Op","default":"OR"},"countries":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Countries"},"countries_blacklist":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Countries Blacklist"},"continents":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Continents"},"languages":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Languages"},"sentiment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sentiment"},"reporting_voice":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Reporting Voice"},"provocative":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provocative","default":"all"}},"type":"object","required":["name","start_datetime","end_datetime"],"title":"SeriesConfig"},"type":"array","title":"Series","description":"The series configurations for the chart"}},"type":"object","required":["chart_type","series"],"title":"ChartParameters"},{"type":"null"}]},"context":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Context"},"iterations_used":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Iterations Used"},"last_reasoning":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Reasoning"},"last_parameters":{"anyOf":[{"properties":{"chart_type":{"type":"string","enum":["line","bar","bar_pct"],"title":"Chart Type","description":"The type of chart to create"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"The title of the chart"},"series":{"items":{"properties":{"name":{"type":"string","title":"Name"},"start_datetime":{"type":"string","format":"date-time","title":"Start Datetime"},"end_datetime":{"type":"string","format":"date-time","title":"End Datetime"},"sampling":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sampling","default":"1d"},"time_filter":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time Filter","default":"pub_date"},"categories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Categories"},"domains":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Domains"},"bad_domain_url":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Bad Domain Url"},"page_rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page Rank"},"string_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"String Guarantee"},"string_guarantee_op":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"String Guarantee Op","default":"OR"},"reverse_string_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Reverse String Guarantee"},"entity_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Entity Guarantee"},"entity_guarantee_op":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Guarantee Op","default":"OR"},"countries":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Countries"},"countries_blacklist":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Countries Blacklist"},"continents":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Continents"},"languages":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Languages"},"sentiment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sentiment"},"reporting_voice":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Reporting Voice"},"provocative":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provocative","default":"all"}},"type":"object","required":["name","start_datetime","end_datetime"],"title":"SeriesConfig"},"type":"array","title":"Series","description":"The series configurations for the chart"}},"type":"object","required":["chart_type","series"],"title":"ChartParameters"},{"type":"null"}]},"png_data":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Png Data","description":"Base64-encoded PNG image data of the chart"},"png_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Png Url","description":"URL to the PNG image of the chart"},"chart_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chart Url","description":"URL to the chart JSON object in S3"}},"type":"object","required":["success","chart_json"],"title":"ChartResponse"}},"type":"object","required":["data"],"title":"CreateDeepNewsResponseStreamSourcesChartSource"}],"title":"Source"}},"type":"object","required":["id","created","source"],"title":"CreateDeepNewsResponseStreamSource"}]}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__36"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__35"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__34"}}}},"405":{"description":"Method Not Allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__33"}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationErrorModel"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/asknews_api__errors__APIErrorModel"}}}}},"security":[{"APIKey":["chat"]}]}},"/v1/chat/deepnews-models":{"get":{"tags":["chat"],"summary":"List available DeepNews models","description":"List the available DeepNews models with their public type (standard/lite/advanced).","operationId":"list_deepnews_models","responses":{"200":{"description":"List of DeepNews models with type","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListDeepNewsModelResponse"}}}}}}},"/v1/byok/{provider}":{"put":{"tags":["byok"],"summary":"Store a BYOK API key for a provider","description":"Store a BYOK API key for a provider.\nBring your own key is reserved for enterprise clients.\nIf you want to use this feature, please contact us at contact@asknews.app","operationId":"upsert_byok_key","security":[{"APIKey":["chat"]}],"parameters":[{"name":"provider","in":"path","required":true,"schema":{"enum":["anthropic","google"],"type":"string","description":"The BYOK provider","title":"Provider"},"description":"The BYOK provider"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpsertApiKeyRequest"}}}},"responses":{"200":{"description":"Stored API key hint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["byok"],"summary":"Get a stored BYOK API key hint for a provider","description":"Get the stored BYOK API key hint for a provider.\nBring your own key is reserved for enterprise clients.\nIf you want to use this feature, please contact us at contact@asknews.app","operationId":"get_byok_key","security":[{"APIKey":["chat"]}],"parameters":[{"name":"provider","in":"path","required":true,"schema":{"enum":["anthropic","google"],"type":"string","description":"The BYOK provider","title":"Provider"},"description":"The BYOK provider"}],"responses":{"200":{"description":"Stored API key hint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["byok"],"summary":"Delete a stored BYOK API key for a provider","description":"Delete a stored BYOK API key for a provider.\nBring your own key is reserved for enterprise clients.\nIf you want to use this feature, please contact us at contact@asknews.app","operationId":"delete_byok_key","security":[{"APIKey":["chat"]}],"parameters":[{"name":"provider","in":"path","required":true,"schema":{"enum":["anthropic","google"],"type":"string","description":"The BYOK provider","title":"Provider"},"description":"The BYOK provider"}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/chat/forecast":{"get":{"tags":["forecast"],"summary":"Make an expert forecast for a news event.","description":"Make an expert forecast for a news event.\n\nThis endpoint reaches into the news archive, looking back `lookback` days to\nextract the most relevant news articles, building a timeline of events, and\nthen making an expert forecast.\n\nThis endpoint is more expensive than the search endpoint, it is calling\ngpt-4o or claude 3-5 on approx 15k tokens to build the forecast.\nThis endpoint counts toward \"deep\" calls in the billing system.\n\nIt returns the forecast, the reasoning, and the sources.","operationId":"get_forecast","security":[{"APIKey":["chat"]}],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","description":"The requested forecast.","title":"Query"},"description":"The requested forecast."},{"name":"lookback","in":"query","required":false,"schema":{"type":"integer","description":"The number of days to look back for the forecast.","default":14,"title":"Lookback"},"description":"The number of days to look back for the forecast."},{"name":"articles_to_use","in":"query","required":false,"schema":{"type":"integer","description":"The total number of relevant articles to be extracted from the news archive and used for the forecast.","default":15,"title":"Articles To Use"},"description":"The total number of relevant articles to be extracted from the news archive and used for the forecast."},{"name":"method","in":"query","required":false,"schema":{"const":"kw","type":"string","description":"Method to use for the context search Currently only 'kw' is supported.","default":"kw","title":"Method"},"description":"Method to use for the context search Currently only 'kw' is supported."},{"name":"model","in":"query","required":false,"schema":{"enum":["gpt-4o","gpt-4o-mini","gpt-4.1-2025-04-14","claude-3-5-sonnet-latest","claude-3-5-sonnet-20240620","claude-sonnet-4-20250514","claude-opus-4-20250514","claude-sonnet-4-5-20250929","claude-opus-4-6","claude-sonnet-4-6","claude-sonnet-5","o1-mini","o3-mini","o3"],"type":"string","description":"The model to use for the forecast.","default":"gpt-4.1-2025-04-14","title":"Model"},"description":"The model to use for the forecast."},{"name":"cutoff_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The cutoff date for the forecast. String format is 'YYYY-MM-DD-HH:MM'. This is useful  for backtesting forecasts.","title":"Cutoff Date"},"description":"The cutoff date for the forecast. String format is 'YYYY-MM-DD-HH:MM'. This is useful  for backtesting forecasts."},{"name":"use_reddit","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to use Reddit data for the forecast.enterprise customers only.","default":false,"title":"Use Reddit"},"description":"Whether to use Reddit data for the forecast.enterprise customers only."},{"name":"additional_context","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Additional context to use for the forecast.","title":"Additional Context"},"description":"Additional context to use for the forecast."},{"name":"web_search","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to run a live web search and include results in the forecast. enterprise customers only.","default":false,"title":"Web Search"},"description":"Whether to run a live web search and include results in the forecast. enterprise customers only."},{"name":"expert","in":"query","required":false,"schema":{"enum":["general","sports"],"type":"string","description":"The type of expert to use for the forecast.","default":"general","title":"Expert"},"description":"The type of expert to use for the forecast."}],"responses":{"200":{"description":"A fully structured Forecast, complete with research.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForecastResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/chat/websearch":{"get":{"tags":["websearch"],"summary":"Run a live websearch.","description":"Run a live websearch on a set of queries, get back a fully structured and\nLLM-distilled response (in addition to the raw text if you need that as well).\n\nYour response includes as_string and as_dicts, where as_string is a prompt-optimized\ndistillation of the information, done by an LLM. as_dicts contains all the details\nnecessary to feed into other parts of your application.","operationId":"live_web_search","security":[{"APIKey":["chat"]}],"parameters":[{"name":"queries","in":"query","required":true,"schema":{"type":"array","items":{"type":"string"},"description":"A list of queries to be live searched, analyzed, distilled, and structured.","title":"Queries"},"description":"A list of queries to be live searched, analyzed, distilled, and structured."},{"name":"lookback","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Number of hours back to allow the websearch to look. Defaults to All time","title":"Lookback"},"description":"Number of hours back to allow the websearch to look. Defaults to All time"},{"name":"start_datetime","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Earliest acceptable publication datetime for results. For v1, acts like the existing lookback filter.","title":"Start Datetime"},"description":"Earliest acceptable publication datetime for results. For v1, acts like the existing lookback filter."},{"name":"end_datetime","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Latest acceptable publication datetime for results. ","title":"End Datetime"},"description":"Latest acceptable publication datetime for results. "},{"name":"engine","in":"query","required":false,"schema":{"enum":["v1","v1.5"],"type":"string","description":"Search engine version to use for live websearch results.","default":"v1","title":"Engine"},"description":"Search engine version to use for live websearch results."},{"name":"domains","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"A list of domains to search.","title":"Domains"},"description":"A list of domains to search."},{"name":"strict","in":"query","required":false,"schema":{"type":"boolean","description":"If true, the websearch will only return results that have a known publication date and are within the lookback period.","default":false,"title":"Strict"},"description":"If true, the websearch will only return results that have a known publication date and are within the lookback period."},{"name":"offset","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"description":"The number of results to offset for followup queries. Numeric for regular websearch; X (Twitter) searches return an opaque cursor string in response.offset — pass it back here to paginate.","default":0,"title":"Offset"},"description":"The number of results to offset for followup queries. Numeric for regular websearch; X (Twitter) searches return an opaque cursor string in response.offset — pass it back here to paginate."}],"responses":{"200":{"description":"Structured websearch.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebSearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/chat/autofilter":{"get":{"tags":["autofilter"],"summary":"Generate filter params for AskNews endpoints","description":"This is a helper endpoint designed to intelligently populate the\n\"parameters of the /news search endpoint of AskNews. It takes a description\nof the type of news that you want to access, and then maps it to the available\nparameters automatically.\n\nThis endpoint returns the parameters, called filter_params, which can be used\nin a variety of other AskNews endpoints, for example, /news, /graph, /chat.","operationId":"autofilter","security":[{"APIKey":["chat"]}],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","description":"A description of what kind of news you want to get.","title":"Query"},"description":"A description of what kind of news you want to get."}],"responses":{"200":{"description":"Filter params ready to be used.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilterParamsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/chat/alerts":{"get":{"tags":["alerts"],"summary":"Get all created alerts","description":"Get all created alerts.","operationId":"get_alerts","security":[{"APIKey":["chat"]}],"parameters":[{"name":"user_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"The ID of the user to get alerts for","title":"User Id"},"description":"The ID of the user to get alerts for"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","description":"The page number to get","default":1,"title":"Page"},"description":"The page number to get"},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","description":"The number of items per page","default":10,"title":"Per Page"},"description":"The number of items per page"},{"name":"all","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to get all the alerts","default":false,"title":"All"},"description":"Whether to get all the alerts"},{"name":"include_deleted","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to include soft-deleted alerts","default":false,"title":"Include Deleted"},"description":"Whether to include soft-deleted alerts"}],"responses":{"200":{"description":"List of alerts.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_AlertResponse_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["alerts"],"summary":"Create an alert","description":"Create an alert.","operationId":"create_alert","security":[{"APIKey":["chat"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAlertRequest"}}}},"responses":{"201":{"description":"Created alert.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/chat/alerts/logs":{"get":{"tags":["alerts"],"summary":"Get all alert logs","description":"Get all alert logs.","operationId":"get_all_alert_logs","security":[{"APIKey":["chat"]}],"parameters":[{"name":"alert_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"The alert ID","title":"Alert Id"},"description":"The alert ID"},{"name":"user_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"The ID of the user to get logs for","title":"User Id"},"description":"The ID of the user to get logs for"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","description":"The page number to get","default":1,"title":"Page"},"description":"The page number to get"},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","description":"The number of items per page","default":10,"title":"Per Page"},"description":"The number of items per page"},{"name":"all","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to get all the alert logs","default":false,"title":"All"},"description":"Whether to get all the alert logs"},{"name":"start_timestamp","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Timestamp to start search from","title":"Start Timestamp"},"description":"Timestamp to start search from"},{"name":"end_timestamp","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Timestamp to end search at","title":"End Timestamp"},"description":"Timestamp to end search at"}],"responses":{"200":{"description":"Returns all alert logs.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_AlertLog_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/chat/alerts/{alert_id}":{"get":{"tags":["alerts"],"summary":"Get an alert","description":"Get an alert.","operationId":"get_alert","security":[{"APIKey":["chat"]}],"parameters":[{"name":"alert_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"The alert ID","title":"Alert Id"},"description":"The alert ID"},{"name":"user_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"The ID of the user to get logs for","title":"User Id"},"description":"The ID of the user to get logs for"}],"responses":{"200":{"description":"Returns alert.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["alerts"],"summary":"Update an alert","description":"Update an alert.","operationId":"put_alert","security":[{"APIKey":["chat"]}],"parameters":[{"name":"alert_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"The alert ID","title":"Alert Id"},"description":"The alert ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAlertRequest"}}}},"responses":{"200":{"description":"Returns alert.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["alerts"],"summary":"Delete an alert","description":"Delete an alert.","operationId":"delete_alert","security":[{"APIKey":["chat"]}],"parameters":[{"name":"alert_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"The alert ID","title":"Alert Id"},"description":"The alert ID"}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/chat/alerts/{alert_id}/run":{"get":{"tags":["alerts"],"summary":"Run an existing alert","description":"Get an alert.","operationId":"run_alert","security":[{"APIKey":["chat"]}],"parameters":[{"name":"alert_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"The alert ID","title":"Alert Id"},"description":"The alert ID"},{"name":"user_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"The ID of the user to get logs for","title":"User Id"},"description":"The ID of the user to get logs for"},{"name":"is_test","in":"query","required":false,"schema":{"type":"boolean","description":"Whether this is a test run","default":false,"title":"Is Test"},"description":"Whether this is a test run"}],"responses":{"200":{"description":"Returns alert.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/chat/alerts/{alert_id}/logs":{"get":{"tags":["alerts"],"summary":"Get alert logs","description":"Get alert logs.","operationId":"get_alert_logs","security":[{"APIKey":["chat"]}],"parameters":[{"name":"alert_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"The alert ID","title":"Alert Id"},"description":"The alert ID"},{"name":"user_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"The ID of the user to get logs for","title":"User Id"},"description":"The ID of the user to get logs for"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","description":"The page number to get","default":1,"title":"Page"},"description":"The page number to get"},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","description":"The number of items per page","default":10,"title":"Per Page"},"description":"The number of items per page"},{"name":"all","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to get all the alert logs","default":false,"title":"All"},"description":"Whether to get all the alert logs"},{"name":"start_timestamp","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Timestamp to start search from","title":"Start Timestamp"},"description":"Timestamp to start search from"},{"name":"end_timestamp","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Timestamp to end search at","title":"End Timestamp"},"description":"Timestamp to end search at"}],"responses":{"200":{"description":"Returns alert logs.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_AlertLog_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/chat/newsletters":{"get":{"tags":["newsletters"],"summary":"Get all created newsletters","description":"Get all created newsletters.","operationId":"get_newsletters","responses":{"200":{"description":"List of newsletters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_NewsletterResponse_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKey":["chat"]}]},"post":{"tags":["newsletters"],"summary":"Create a newsletter","description":"Create a newsletter.","operationId":"post_newsletter","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateNewsletterRequest"}}},"required":true},"responses":{"201":{"description":"Created newsletter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsletterResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKey":["chat"]}]}},"/v1/chat/newsletters/public":{"get":{"tags":["newsletters"],"summary":"Get all public newsletters","description":"Get all public newsletters.","operationId":"get_public_newsletters","security":[{"APIKey":["chat"]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","description":"The page number to get","default":1,"title":"Page"},"description":"The page number to get"},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","description":"The number of items per page","default":10,"title":"Per Page"},"description":"The number of items per page"},{"name":"all","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to get all the public newsletters","default":false,"title":"All"},"description":"Whether to get all the public newsletters"}],"responses":{"200":{"description":"List of public newsletters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_NewsletterPublicResponse_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/chat/newsletters/{newsletter_id}":{"get":{"tags":["newsletters"],"summary":"Get a newsletter","description":"Get a newsletter.","operationId":"get_newsletter","security":[{"APIKey":["chat"]}],"parameters":[{"name":"newsletter_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"The newsletter ID","title":"Newsletter Id"},"description":"The newsletter ID"}],"responses":{"200":{"description":"Returns newsletter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsletterResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["newsletters"],"summary":"Update a newsletter","description":"Update a newsletter.","operationId":"put_newsletter","security":[{"APIKey":["chat"]}],"parameters":[{"name":"newsletter_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"The newsletter ID","title":"Newsletter Id"},"description":"The newsletter ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateNewsletterRequest"}}}},"responses":{"200":{"description":"Returns newsletter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsletterResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["newsletters"],"summary":"Delete a newsletter","description":"Delete a newsletter.","operationId":"delete_newsletter","security":[{"APIKey":["chat"]}],"parameters":[{"name":"newsletter_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"The newsletter ID","title":"Newsletter Id"},"description":"The newsletter ID"}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/chat/newsletters/{newsletter_id}/unsubscribe":{"post":{"tags":["newsletters"],"summary":"Unsubscribe from a newsletter","description":"Unsubscribe from a newsletter.","operationId":"unsubscribe_newsletter","security":[{"APIKey":["chat","internal"]}],"parameters":[{"name":"newsletter_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"The newsletter ID","title":"Newsletter Id"},"description":"The newsletter ID"}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/chat/newsletters/{newsletter_id}/contacts":{"get":{"tags":["newsletters"],"summary":"Get newsletter contacts","description":"Get newsletter contacts.","operationId":"get_newsletter_contacts","security":[{"APIKey":["chat"]}],"parameters":[{"name":"newsletter_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"The newsletter ID","title":"Newsletter Id"},"description":"The newsletter ID"}],"responses":{"200":{"description":"Returns newsletter contacts.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NewsletterContactResponse"},"title":"Response 200 Get Newsletter Contacts"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["newsletters"],"summary":"Create a newsletter contact","description":"Create a newsletter contact.","operationId":"post_newsletter_contacts","security":[{"APIKey":["chat"]}],"parameters":[{"name":"newsletter_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"The newsletter ID","title":"Newsletter Id"},"description":"The newsletter ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsletterContactRequest"}}}},"responses":{"201":{"description":"Newsletter contact","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsletterContactCreateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/chat/newsletters/{newsletter_id}/contacts/{contact_id}":{"get":{"tags":["newsletters"],"summary":"Get a newsletter contact","description":"Get a newsletter contact.","operationId":"get_newsletter_contact","security":[{"APIKey":["chat"]}],"parameters":[{"name":"newsletter_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"The newsletter ID","title":"Newsletter Id"},"description":"The newsletter ID"},{"name":"contact_id","in":"path","required":true,"schema":{"type":"string","description":"The contact ID","title":"Contact Id"},"description":"The contact ID"}],"responses":{"200":{"description":"Returns newsletter contact.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsletterContactResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["newsletters"],"summary":"Update a newsletter contact","description":"Update a newsletter contact.","operationId":"patch_newsletter_contact","security":[{"APIKey":["chat"]}],"parameters":[{"name":"newsletter_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"The newsletter ID","title":"Newsletter Id"},"description":"The newsletter ID"},{"name":"contact_id","in":"path","required":true,"schema":{"type":"string","description":"The contact ID","title":"Contact Id"},"description":"The contact ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsletterContactRequest"}}}},"responses":{"200":{"description":"Returns newsletter contact.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsletterContactUpdateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["newsletters"],"summary":"Delete a newsletter contact","description":"Delete a newsletter contact.","operationId":"delete_newsletter_contact","security":[{"APIKey":["chat"]}],"parameters":[{"name":"newsletter_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"The newsletter ID","title":"Newsletter Id"},"description":"The newsletter ID"},{"name":"contact_id","in":"path","required":true,"schema":{"type":"string","description":"The contact ID","title":"Contact Id"},"description":"The contact ID"}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/chat/charts":{"post":{"tags":["charts"],"summary":"Create a chart","description":"Create charts.","operationId":"create_charts_endpoint","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateChartRequest"}}},"required":true},"responses":{"200":{"description":"Returns chart data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChartResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKey":["chat"]}]}},"/v1/stories/{story_id}":{"get":{"tags":["stories"],"summary":"Get a story containing updates","description":"Get a single news story given its UUID.","operationId":"get_story","security":[{"APIKey":["stories"]}],"parameters":[{"name":"story_id","in":"path","required":true,"schema":{"type":"string","description":"The story UUID, update UUID, or URL safe title","title":"Story Id"},"description":"The story UUID, update UUID, or URL safe title"},{"name":"expand_updates","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to expand updates","default":true,"title":"Expand Updates"},"description":"Whether to expand updates"},{"name":"max_updates","in":"query","required":false,"schema":{"type":"integer","description":"Max number of updates to include in the story object","default":10,"title":"Max Updates"},"description":"Max number of updates to include in the story object"},{"name":"max_articles","in":"query","required":false,"schema":{"type":"integer","description":"Max articles to include per update","default":25,"title":"Max Articles"},"description":"Max articles to include per update"},{"name":"reddit","in":"query","required":false,"schema":{"type":"integer","description":"Whether to include Reddit analysis","default":0,"title":"Reddit"},"description":"Whether to include Reddit analysis"},{"name":"citation_method","in":"query","required":false,"schema":{"enum":["brackets","urls","none"],"type":"string","description":"Method to use for citation filtering.","default":"brackets","title":"Citation Method"},"description":"Method to use for citation filtering."},{"name":"condense_auxillary_updates","in":"query","required":false,"schema":{"type":"boolean","description":"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'.","default":true,"title":"Condense Auxillary Updates"},"description":"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'."}],"responses":{"200":{"description":"A story object containing updates","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoryResponse"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__40"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__39"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__38"}}},"description":"Forbidden"},"405":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__37"}}},"description":"Method Not Allowed"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationErrorModel"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/asknews_api__errors__APIErrorModel"}}},"description":"Internal Server Error"}}}},"/v1/stories":{"get":{"tags":["stories"],"summary":"Filter and search for top news narratives","description":"Filter on our custom, in-house written, stories/events/narratives.\n\nThese stories are based on clusters of articles (which come through this\nendpoint as well, so you can consider this a clustering endpoint). We write\nstories and track them through time.\n\nThe enrichments include a full Reddit overview (including all the thread metadata),\nas well as descriptions of the reporting voice, the key takeaways, contradictions,\nall the entities, and much, much more.\n\nYou can see this data in action, and filter it similarly at\n`https://asknews.app/stories`","operationId":"get_stories","security":[{"APIKey":["stories"]}],"parameters":[{"name":"query","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Query to be used for the search. If method='nl', then this will beused as a natural language query. If method='kw', then this willbe used as a direct keyword query.","title":"Query"},"description":"Query to be used for the search. If method='nl', then this will beused as a natural language query. If method='kw', then this willbe used as a direct keyword query."},{"name":"categories","in":"query","required":false,"schema":{"type":"array","items":{"enum":["Politics","Economy","Finance","Science","Technology","Sports","Climate","Environment","Culture","Entertainment","Business","Health","International"],"type":"string"},"description":"Categories to use for filtering the stories search","default":[],"title":"Categories"},"description":"Categories to use for filtering the stories search"},{"name":"uuids","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","format":"uuid"},"description":"A list of UUIDs to retrieve.","default":[],"title":"Uuids"},"description":"A list of UUIDs to retrieve."},{"name":"start_timestamp","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Start timestamp to filter results on.","title":"Start Timestamp"},"description":"Start timestamp to filter results on."},{"name":"end_timestamp","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"End timestamp to filter results on.","title":"End Timestamp"},"description":"End timestamp to filter results on."},{"name":"sort_by","in":"query","required":false,"schema":{"anyOf":[{"enum":["published","coverage","sentiment","relevance","confidence"],"type":"string"},{"type":"null"}],"description":"Which type of sorting to perform.\npublished: Sort by published date.\ncoverage: Sort by coverage.\nsentiment: Sort by sentiment.\nrelevance: Sort by relevance of similarity score/ranking.","title":"Sort By"},"description":"Which type of sorting to perform.\npublished: Sort by published date.\ncoverage: Sort by coverage.\nsentiment: Sort by sentiment.\nrelevance: Sort by relevance of similarity score/ranking."},{"name":"sort_type","in":"query","required":false,"schema":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"description":"Whether to sort results in ascending or descending order.","title":"Sort Type"},"description":"Whether to sort results in ascending or descending order."},{"name":"continent","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"enum":["Africa","Asia","Europe","Middle East","North America","South America","Oceania"],"type":"string"}},{"type":"string"},{"type":"null"}],"description":"Continents to filter by.","title":"Continent"},"description":"Continents to filter by."},{"name":"offset","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"string"}],"description":"Offset to use","default":0,"title":"Offset"},"description":"Offset to use"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","description":"Limit to use","default":10,"title":"Limit"},"description":"Limit to use"},{"name":"expand_updates","in":"query","required":false,"schema":{"type":"boolean","description":"Whether to expand updates","default":false,"title":"Expand Updates"},"description":"Whether to expand updates"},{"name":"max_updates","in":"query","required":false,"schema":{"type":"integer","description":"Max updates to use","default":2,"title":"Max Updates"},"description":"Max updates to use"},{"name":"max_articles","in":"query","required":false,"schema":{"type":"integer","description":"Max articles to use per update","default":5,"title":"Max Articles"},"description":"Max articles to use per update"},{"name":"method","in":"query","required":false,"schema":{"enum":["nl","kw","both"],"type":"string","description":"Method to use for query, 'nl' means natural language, and will run a semantic search on the stories database. 'kw' means keyword, and will search by keyword on the stories database. 'both' means that both methods will be used and results will be ranked according to IRR.","default":"kw","title":"Method"},"description":"Method to use for query, 'nl' means natural language, and will run a semantic search on the stories database. 'kw' means keyword, and will search by keyword on the stories database. 'both' means that both methods will be used and results will be ranked according to IRR."},{"name":"obj_type","in":"query","required":false,"schema":{"type":"array","items":{"enum":["story","story_update"],"type":"string"},"description":"Object type to filter by, can be a list with 'story' and/or 'story_update'","default":["story"],"title":"Obj Type"},"description":"Object type to filter by, can be a list with 'story' and/or 'story_update'"},{"name":"reddit","in":"query","required":false,"schema":{"type":"integer","description":"Whether or not to include Reddit analysiswhere the integer indicates the number of threadsto include in the response. 0 is default. Requirespaid plan to access.","default":0,"title":"Reddit"},"description":"Whether or not to include Reddit analysiswhere the integer indicates the number of threadsto include in the response. 0 is default. Requirespaid plan to access."},{"name":"citation_method","in":"query","required":false,"schema":{"enum":["brackets","urls","none"],"type":"string","description":"Method to use for citation filtering.","default":"brackets","title":"Citation Method"},"description":"Method to use for citation filtering."},{"name":"similarity_score_threshold","in":"query","required":false,"schema":{"type":"number","description":"Similarity score threshold to use when using query","default":0.75,"title":"Similarity Score Threshold"},"description":"Similarity score threshold to use when using query"},{"name":"provocative","in":"query","required":false,"schema":{"enum":["unknown","low","medium","high","all"],"type":"string","description":"Filter stories based on how provocative the underlying articles are deemed based on the use of provocative language and emotional vocabulary.","default":"all","title":"Provocative"},"description":"Filter stories based on how provocative the underlying articles are deemed based on the use of provocative language and emotional vocabulary."},{"name":"strategy","in":"query","required":false,"schema":{"enum":["default","topstories","topstories_categories","topstories_continents"],"type":"string","description":"Strategy to use for automatically controlling the search. 'default' is the default strategy, which follows all filters faithfully. 'topstories' aims to give a diverse look at top news stories that are relevant to the current filter combination.'topstories_categories' aims to give the top stories for each category. 'topstories_continents' aims to give the top stories for each continent.","default":"default","title":"Strategy"},"description":"Strategy to use for automatically controlling the search. 'default' is the default strategy, which follows all filters faithfully. 'topstories' aims to give a diverse look at top news stories that are relevant to the current filter combination.'topstories_categories' aims to give the top stories for each category. 'topstories_continents' aims to give the top stories for each continent."}],"responses":{"200":{"description":"A list of stories with updates","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoriesResponse"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__44"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__43"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__42"}}},"description":"Forbidden"},"405":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__41"}}},"description":"Method Not Allowed"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationErrorModel"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/asknews_api__errors__APIErrorModel"}}},"description":"Internal Server Error"}}}},"/v1/analytics/finance/sentiment":{"get":{"tags":["analytics"],"summary":"Get a timeseries of finance news sentiment for assets","description":"Get the news sentiment for a given asset during a provided period of time.\n\nThis endpoint is good for narrow AI, like using in combination with a regressor\nto forecast prices etc.","operationId":"get_asset_sentiment","security":[{"APIKey":["analytics"]}],"parameters":[{"name":"asset","in":"query","required":true,"schema":{"enum":["bitcoin","ethereum","cardano","uniswap","ripple","solana","polkadot","polygon","chainlink","tether","dogecoin","monero","tron","binance","aave","tesla","microsoft","amazon"],"type":"string","description":"The asset name to query for sentiment.","title":"Asset"},"description":"The asset name to query for sentiment."},{"name":"metric","in":"query","required":false,"schema":{"enum":["news_positive","news_negative","news_total","news_positive_weighted","news_negative_weighted","news_total_weighted"],"type":"string","description":"The metric to obtain. Weighted metrics account for page-rank of original source. Higher page rank sources are weighted more heavily.","default":"news_positive","title":"Metric"},"description":"The metric to obtain. Weighted metrics account for page-rank of original source. Higher page rank sources are weighted more heavily."},{"name":"date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"The start date in ISO format","title":"Date From"},"description":"The start date in ISO format"},{"name":"date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"The end date in ISO format","title":"Date To"},"description":"The end date in ISO format"}],"responses":{"200":{"description":"The timeseries sentiment for an asset or cryptocurrency","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FinanceResponse"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__48"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__47"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__46"}}},"description":"Forbidden"},"405":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__45"}}},"description":"Method Not Allowed"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationErrorModel"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/asknews_api__errors__APIErrorModel"}}},"description":"Internal Server Error"}}}},"/v1/profiles/me":{"get":{"tags":["profile"],"summary":"Get the current user's profile","description":"Get the current profile","operationId":"get_user_profile","responses":{"200":{"description":"A profile object","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__52"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__51"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__50"}}}},"405":{"description":"Method Not Allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__49"}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationErrorModel"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/asknews_api__errors__APIErrorModel"}}}}},"security":[{"APIKey":["profile"]}]}},"/v1/profiles/me/limits":{"get":{"tags":["profile"],"summary":"Get the current user's rate limit status","description":"Return the caller's current rate-limit and concurrency-limit state without consuming any tokens.","operationId":"get_rate_limit_status","responses":{"200":{"description":"Current rate limit and concurrency state","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitStatusResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__56"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__55"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__54"}}}},"405":{"description":"Method Not Allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__53"}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationErrorModel"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/asknews_api__errors__APIErrorModel"}}}}},"security":[{"APIKey":[]}]}},"/v1/reddit/search":{"get":{"tags":["reddit"],"summary":"Search Reddit, summarize threads, and return analysis.","description":"Go to Reddit, search threads, summarize the threads, return analysis.\n`deep`=True is a live web scrape, AskNews searches Reddit, finds threads,\nsummarizes them, analyzes them, and returns the results. `deep`=False\nis a search in AskNews' existing database of Reddit threads.","operationId":"search_reddit","security":[{"APIKey":["news"]}],"parameters":[{"name":"keywords","in":"query","required":true,"schema":{"type":"array","items":{"type":"string"},"description":"Keywords used to search for relevant Reddit threads.","title":"Keywords"},"description":"Keywords used to search for relevant Reddit threads."},{"name":"n_threads","in":"query","required":false,"schema":{"type":"integer","description":"Number of Reddit threads to summarize and return","default":5,"title":"N Threads"},"description":"Number of Reddit threads to summarize and return"},{"name":"method","in":"query","required":false,"schema":{"enum":["nl","kw"],"type":"string","description":"The search method. Can be 'nl' or 'kw'. If 'nl', then the query will be used as a natural language query. If 'kw', then the query will be used as a direct keyword query.","default":"kw","title":"Method"},"description":"The search method. Can be 'nl' or 'kw'. If 'nl', then the query will be used as a natural language query. If 'kw', then the query will be used as a direct keyword query."},{"name":"deep","in":"query","required":false,"schema":{"type":"boolean","description":"Deep means that AskNews goes directly to Reddit, searches live, summarizes the threads live, and returns structured data for you. Deep=False means that AskNews looks in its existing database of Reddit threads and returns the most similar threads ","default":false,"title":"Deep"},"description":"Deep means that AskNews goes directly to Reddit, searches live, summarizes the threads live, and returns structured data for you. Deep=False means that AskNews looks in its existing database of Reddit threads and returns the most similar threads "},{"name":"return_type","in":"query","required":false,"schema":{"enum":["dicts","string","both"],"type":"string","description":"The return type. Can be 'dicts', 'string', or 'both'.","default":"string","title":"Return Type"},"description":"The return type. Can be 'dicts', 'string', or 'both'."},{"name":"time_filter","in":"query","required":false,"schema":{"enum":["hour","day","week","month","year","all"],"type":"string","description":"The time filter.","default":"day","title":"Time Filter"},"description":"The time filter."},{"name":"sort","in":"query","required":false,"schema":{"enum":["relevance","hot","top","new","comments"],"type":"string","description":"The sort order.","default":"relevance","title":"Sort"},"description":"The sort order."}],"responses":{"200":{"description":"The summarized Reddit threads.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RedditResponse"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__60"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__59"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__58"}}},"description":"Forbidden"},"405":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__57"}}},"description":"Method Not Allowed"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationErrorModel"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/asknews_api__errors__APIErrorModel"}}},"description":"Internal Server Error"}}}},"/v1/distribution/domains/top_n":{"get":{"tags":["distribution"],"summary":"Get the top N domains by hits","description":"Get the top N domains by hits.","operationId":"top_n_domains_by_hits","security":[{"APIKey":["distribution","internal"]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Number of top domains to return","default":10,"title":"Limit"},"description":"Number of top domains to return"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Start date to filter by (timestamp in seconds since epoch)","title":"Start Date"},"description":"Start date to filter by (timestamp in seconds since epoch)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"End date to filter by (timestamp in seconds since epoch)","title":"End Date"},"description":"End date to filter by (timestamp in seconds since epoch)"},{"name":"names","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"List of domain names to filter by","title":"Names"},"description":"List of domain names to filter by"}],"responses":{"200":{"description":"A list of top domains with their hit counts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopNDomainsByHitsResponse"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__64"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__63"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__62"}}},"description":"Forbidden"},"405":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__61"}}},"description":"Method Not Allowed"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationErrorModel"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/asknews_api__errors__APIErrorModel"}}},"description":"Internal Server Error"}}}},"/v1/distribution/domains":{"get":{"tags":["distribution"],"summary":"Find domains","description":"Find domains with optional filters.","operationId":"find_domains","security":[{"APIKey":["distribution","internal"]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number for pagination","default":1,"title":"Page"},"description":"Page number for pagination"},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Number of items per page","default":10,"title":"Per Page"},"description":"Number of items per page"},{"name":"names","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"List of domain names to filter by","title":"Names"},"description":"List of domain names to filter by"},{"name":"is_tollbit","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Filter by tollbit status","title":"Is Tollbit"},"description":"Filter by tollbit status"},{"name":"publisher","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Filter by publisher status","title":"Publisher"},"description":"Filter by publisher status"},{"name":"full_text","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Filter by full-text opt-in status","title":"Full Text"},"description":"Filter by full-text opt-in status"}],"responses":{"200":{"description":"A paginated list of domains","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_ReadDomainResponse_"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__68"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__67"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__66"}}},"description":"Forbidden"},"405":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__65"}}},"description":"Method Not Allowed"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationErrorModel"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/asknews_api__errors__APIErrorModel"}}},"description":"Internal Server Error"}}}},"/v1/distribution/domains/{name}":{"get":{"tags":["distribution"],"summary":"Get a domain by name","description":"Get a domain.","operationId":"get_domain","security":[{"APIKey":["distribution","internal"]}],"parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"responses":{"200":{"description":"Response for getting a domain","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadDomainResponse"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__72"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__71"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__70"}}},"description":"Forbidden"},"405":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__69"}}},"description":"Method Not Allowed"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationErrorModel"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/asknews_api__errors__APIErrorModel"}}},"description":"Internal Server Error"}}}},"/v1/distribution/articles/top_n_for_domains":{"get":{"tags":["distribution"],"summary":"Get the top N articles by hits for domains","description":"Get the top N domain articles by hits.","operationId":"top_n_articles_for_domains","security":[{"APIKey":["distribution"]}],"parameters":[{"name":"domain_names","in":"query","required":true,"schema":{"type":"array","items":{"type":"string"},"description":"Domain names to filter by","title":"Domain Names"},"description":"Domain names to filter by"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Number of top domain articles to return (page size)","default":10,"title":"Limit"},"description":"Number of top domain articles to return (page size)"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number (1-based; page size = limit)","default":1,"title":"Page"},"description":"Page number (1-based; page size = limit)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Start date to filter by (timestamp in seconds since epoch)","title":"Start Date"},"description":"Start date to filter by (timestamp in seconds since epoch)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"End date to filter by (timestamp in seconds since epoch)","title":"End Date"},"description":"End date to filter by (timestamp in seconds since epoch)"}],"responses":{"200":{"description":"A list of top domain articles with their hit counts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopNArticlesForDomainResponse"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__76"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__75"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__74"}}},"description":"Forbidden"},"405":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__73"}}},"description":"Method Not Allowed"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationErrorModel"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/asknews_api__errors__APIErrorModel"}}},"description":"Internal Server Error"}}}},"/v1/distribution/articles/top_n_for_domain_timeseries":{"get":{"tags":["distribution"],"summary":"Get the top N articles by hits for domain with daily breakdown","description":"Get the top N domain articles by hits with daily breakdown.","operationId":"top_n_articles_for_domain_timeseries","security":[{"APIKey":["distribution","internal"]}],"parameters":[{"name":"domain_name","in":"query","required":true,"schema":{"type":"string","description":"Domain name to filter by","title":"Domain Name"},"description":"Domain name to filter by"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"Number of top domain articles to return per day","default":10,"title":"Limit"},"description":"Number of top domain articles to return per day"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Start date to filter by (timestamp in seconds since epoch)","title":"Start Date"},"description":"Start date to filter by (timestamp in seconds since epoch)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"End date to filter by (timestamp in seconds since epoch)","title":"End Date"},"description":"End date to filter by (timestamp in seconds since epoch)"}],"responses":{"200":{"description":"A list of top domain articles with their hit counts grouped by day","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopNArticlesTimeseriesResponse"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__80"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__79"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__78"}}},"description":"Forbidden"},"405":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__77"}}},"description":"Method Not Allowed"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationErrorModel"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/asknews_api__errors__APIErrorModel"}}},"description":"Internal Server Error"}}}},"/v1/distribution/articles/top_n":{"get":{"tags":["distribution"],"summary":"Get the top N articles by hits","description":"Get the top N articles by hits.","operationId":"top_n_articles_by_hits","security":[{"APIKey":["distribution","internal"]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Number of top articles to return (page size)","default":10,"title":"Limit"},"description":"Number of top articles to return (page size)"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number (1-based; page size = limit)","default":1,"title":"Page"},"description":"Page number (1-based; page size = limit)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Start date to filter by (timestamp in seconds since epoch)","title":"Start Date"},"description":"Start date to filter by (timestamp in seconds since epoch)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"End date to filter by (timestamp in seconds since epoch)","title":"End Date"},"description":"End date to filter by (timestamp in seconds since epoch)"},{"name":"domain_names","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"List of domain names to filter by","title":"Domain Names"},"description":"List of domain names to filter by"}],"responses":{"200":{"description":"A list of top articles with their hit counts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopNArticlesByHitsResponse"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__84"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__83"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__82"}}},"description":"Forbidden"},"405":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__81"}}},"description":"Method Not Allowed"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationErrorModel"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/asknews_api__errors__APIErrorModel"}}},"description":"Internal Server Error"}}}},"/v1/distribution/articles/domain_queries":{"get":{"tags":["distribution"],"summary":"Get queries that surfaced domain articles","description":"Get article hits.","operationId":"get_domain_queries","security":[{"APIKey":["distribution","internal"]}],"parameters":[{"name":"domain_names","in":"query","required":true,"schema":{"type":"array","items":{"type":"string"},"description":"Domain names to filter by","title":"Domain Names"},"description":"Domain names to filter by"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","description":"Limit for the number of articles","default":10,"title":"Limit"},"description":"Limit for the number of articles"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Start date to filter by","title":"Start Date"},"description":"Start date to filter by"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"End date to filter by","title":"End Date"},"description":"End date to filter by"}],"responses":{"200":{"description":"The queries that surfaced domain articles","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainQueriesResponse"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__88"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__87"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__86"}}},"description":"Forbidden"},"405":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__85"}}},"description":"Method Not Allowed"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationErrorModel"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/asknews_api__errors__APIErrorModel"}}},"description":"Internal Server Error"}}}},"/v1/distribution/articles/domain_hits_surface":{"get":{"tags":["distribution"],"summary":"Get total hits and surfaced articles for domains","description":"Get total hits and surfaced articles for domains.","operationId":"get_domain_hits_surface","security":[{"APIKey":["distribution","internal"]}],"parameters":[{"name":"domain_names","in":"query","required":true,"schema":{"type":"array","items":{"type":"string"},"description":"List of domain names to filter by","title":"Domain Names"},"description":"List of domain names to filter by"},{"name":"year","in":"query","required":true,"schema":{"type":"integer","maximum":2100,"minimum":2000,"description":"Year (4 digits)","title":"Year"},"description":"Year (4 digits)"},{"name":"month","in":"query","required":true,"schema":{"type":"integer","maximum":12,"minimum":1,"description":"Month (1-12)","title":"Month"},"description":"Month (1-12)"}],"responses":{"200":{"description":"Total hits and distinct article count for the specified domains","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainHitsSurfaceResponse"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__92"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__91"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__90"}}},"description":"Forbidden"},"405":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__89"}}},"description":"Method Not Allowed"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationErrorModel"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/asknews_api__errors__APIErrorModel"}}},"description":"Internal Server Error"}}}},"/v1/distribution/articles/domain_hits_surface_timewindow":{"get":{"tags":["distribution"],"summary":"Get hits and surfaced articles per day for domains","description":"Get hits and surfaced articles per day for domains.","operationId":"get_domain_hits_surface_timewindow","security":[{"APIKey":["distribution","internal"]}],"parameters":[{"name":"domain_names","in":"query","required":true,"schema":{"type":"array","items":{"type":"string"},"description":"List of domain names to filter by","title":"Domain Names"},"description":"List of domain names to filter by"},{"name":"year","in":"query","required":true,"schema":{"type":"integer","maximum":2100,"minimum":2000,"description":"Year (4 digits)","title":"Year"},"description":"Year (4 digits)"},{"name":"month","in":"query","required":true,"schema":{"type":"integer","maximum":12,"minimum":1,"description":"Month (1-12)","title":"Month"},"description":"Month (1-12)"}],"responses":{"200":{"description":"Daily breakdown of hits and distinct article count","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainHitsSurfaceTimeWindowResponse"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__96"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__95"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__94"}}},"description":"Forbidden"},"405":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__93"}}},"description":"Method Not Allowed"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationErrorModel"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/asknews_api__errors__APIErrorModel"}}},"description":"Internal Server Error"}}}},"/v1/distribution/stats/metrics":{"get":{"tags":["distribution"],"summary":"Get raw publisher metric event counts for domains","description":"Get raw (unweighted) surface, citation, full_text and grounded publisher\nmetric event counts for a list of domains in a time period. Counts are 1 per\nreal event; revenue-share weighting stays in the distribution service.","operationId":"get_domain_metrics","security":[{"APIKey":["distribution","internal"]}],"parameters":[{"name":"domain_names","in":"query","required":true,"schema":{"type":"array","items":{"type":"string"},"description":"Domain names to filter by","title":"Domain Names"},"description":"Domain names to filter by"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Start date to filter by (timestamp in seconds since epoch)","title":"Start Date"},"description":"Start date to filter by (timestamp in seconds since epoch)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"End date to filter by (timestamp in seconds since epoch)","title":"End Date"},"description":"End date to filter by (timestamp in seconds since epoch)"}],"responses":{"200":{"description":"Raw surface, citation, full_text and grounded event counts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainMetricsResponse"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__100"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__99"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__98"}}},"description":"Forbidden"},"405":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__97"}}},"description":"Method Not Allowed"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationErrorModel"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/asknews_api__errors__APIErrorModel"}}},"description":"Internal Server Error"}}}},"/v1/distribution/stats/metrics_timeseries":{"get":{"tags":["distribution"],"summary":"Get raw publisher metric event counts per day for domains","description":"Get raw (unweighted) surface, citation, full_text and grounded publisher\nmetric event counts per day for a list of domains in a time period.","operationId":"get_domain_metrics_timeseries","security":[{"APIKey":["distribution","internal"]}],"parameters":[{"name":"domain_names","in":"query","required":true,"schema":{"type":"array","items":{"type":"string"},"description":"Domain names to filter by","title":"Domain Names"},"description":"Domain names to filter by"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Start date to filter by (timestamp in seconds since epoch)","title":"Start Date"},"description":"Start date to filter by (timestamp in seconds since epoch)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"End date to filter by (timestamp in seconds since epoch)","title":"End Date"},"description":"End date to filter by (timestamp in seconds since epoch)"}],"responses":{"200":{"description":"Daily breakdown of surface, citation, full_text and grounded event counts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainMetricsTimeWindowResponse"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__104"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__103"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__102"}}},"description":"Forbidden"},"405":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__101"}}},"description":"Method Not Allowed"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationErrorModel"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/asknews_api__errors__APIErrorModel"}}},"description":"Internal Server Error"}}}},"/v1/distribution/stats/hit_share":{"get":{"tags":["distribution"],"summary":"Get the hit share for a list of domains in a time period","description":"Get the hit share for a list of domains in a time period.","operationId":"domain_hit_share","security":[{"APIKey":["distribution"]}],"parameters":[{"name":"domain_names","in":"query","required":true,"schema":{"type":"array","items":{"type":"string"},"description":"Domain names to filter by","title":"Domain Names"},"description":"Domain names to filter by"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Start date to filter by (timestamp in seconds since epoch)","title":"Start Date"},"description":"Start date to filter by (timestamp in seconds since epoch)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"End date to filter by (timestamp in seconds since epoch)","title":"End Date"},"description":"End date to filter by (timestamp in seconds since epoch)"},{"name":"is_publisher","in":"query","required":false,"schema":{"type":"boolean","description":"Only calculate hit share for publisher domains","default":true,"title":"Is Publisher"},"description":"Only calculate hit share for publisher domains"}],"responses":{"200":{"description":"The hit share for each domain","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitShareResponse"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__108"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__107"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__106"}}},"description":"Forbidden"},"405":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__105"}}},"description":"Method Not Allowed"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationErrorModel"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/asknews_api__errors__APIErrorModel"}}},"description":"Internal Server Error"}}}},"/v1/distribution/stats/count":{"get":{"tags":["distribution"],"summary":"Get article hits","description":"Get the number of hits for articles in a specific domain.","operationId":"get_article_hits","security":[{"APIKey":["distribution","internal"]}],"parameters":[{"name":"domain_name","in":"query","required":true,"schema":{"type":"string","description":"Domain name to filter by","title":"Domain Name"},"description":"Domain name to filter by"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Start date to filter by (timestamp in seconds since epoch)","title":"Start Date"},"description":"Start date to filter by (timestamp in seconds since epoch)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"End date to filter by (timestamp in seconds since epoch)","title":"End Date"},"description":"End date to filter by (timestamp in seconds since epoch)"}],"responses":{"200":{"description":"Count of article hits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CountResponse"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__112"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__111"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__110"}}},"description":"Forbidden"},"405":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__109"}}},"description":"Method Not Allowed"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationErrorModel"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/asknews_api__errors__APIErrorModel"}}},"description":"Internal Server Error"}}}},"/v1/wiki/search":{"get":{"tags":["wiki"],"summary":"Search for Wikipedia context with natural language","description":"Search on Wikipedia content with natural language. Find exactly relevant chunks,\nwith contextual neighbor chunks, and the full articles they came from.","operationId":"search_wiki","security":[{"APIKey":["news"]}],"parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string","description":"Natural language query that can be any phrase, keyword, question, or paragraph. ","default":"","title":"Query"},"description":"Natural language query that can be any phrase, keyword, question, or paragraph. "},{"name":"neighbor_chunks","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":10,"minimum":0},{"type":"null"}],"description":"Number of neighbor chunks to attach and return. If 0, then no neighbor chunks will be returned. ","default":1,"title":"Neighbor Chunks"},"description":"Number of neighbor chunks to attach and return. If 0, then no neighbor chunks will be returned. "},{"name":"n_documents","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":20,"minimum":1},{"type":"null"}],"description":"Number of documents to return. If 0, then no documents will be returned. ","default":5,"title":"N Documents"},"description":"Number of documents to return. If 0, then no documents will be returned. "},{"name":"full_articles","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"If true, then full articles will be returned. If false, then only chunks and their neighbors will be returned. Beware that returning full articles increases data size which increases token usage downstream.","default":false,"title":"Full Articles"},"description":"If true, then full articles will be returned. If false, then only chunks and their neighbors will be returned. Beware that returning full articles increases data size which increases token usage downstream."},{"name":"hybrid_search","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"If true, then hybrid search will be used. If false, then only vector search will be used. ","default":false,"title":"Hybrid Search"},"description":"If true, then hybrid search will be used. If false, then only vector search will be used. "},{"name":"string_guarantee","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"List of strings that must be present in the results. If empty, then no string guarantee will be applied. ","title":"String Guarantee"},"description":"List of strings that must be present in the results. If empty, then no string guarantee will be applied. "},{"name":"diversify","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":1,"minimum":0},{"type":"null"}],"description":"Diversity factor for MMR re-ranking. 0.0 means no diversity (pure relevance), 1.0 means full diversity. ","default":0,"title":"Diversify"},"description":"Diversity factor for MMR re-ranking. 0.0 means no diversity (pure relevance), 1.0 means full diversity. "},{"name":"include_main_section","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"If true, then the main section of the article will be included at the start of each chunk's content. If false, then only the chunk content will be returned. Useful because the main section often contains important context. ","default":false,"title":"Include Main Section"},"description":"If true, then the main section of the article will be included at the start of each chunk's content. If false, then only the chunk content will be returned. Useful because the main section often contains important context. "}],"responses":{"200":{"description":"A string or a list of dictionaries","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WikiSearchResponse"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__116"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__115"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__114"}}},"description":"Forbidden"},"405":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/abc__APIErrorModel__113"}}},"description":"Method Not Allowed"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationErrorModel"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/asknews_api__errors__APIErrorModel"}}},"description":"Internal Server Error"}}}},"/":{"get":{"tags":["ping"],"summary":"Ping","operationId":"ping","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PingModel"}}}}}}}},"components":{"schemas":{"AlertLog":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"alert_id":{"type":"string","format":"uuid","title":"Alert Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"alert":{"type":"boolean","title":"Alert"},"reasoning":{"type":"string","title":"Reasoning"},"report":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Report"},"report_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Report Url"},"article_ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Article Ids"},"webhook":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Webhook"}},"type":"object","required":["id","created_at","alert_id","user_id","alert","reasoning","article_ids"],"title":"AlertLog"},"AlertResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query"},"cron":{"type":"string","title":"Cron"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"share_link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Share Link"},"sources":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Sources"},"report":{"anyOf":[{"additionalProperties":true,"type":"object"},{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Report"},"triggers":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Triggers"},"always_trigger":{"type":"boolean","title":"Always Trigger","default":false},"repeat":{"type":"boolean","title":"Repeat","default":true},"active":{"type":"boolean","title":"Active","default":true},"alert_type":{"anyOf":[{"type":"string","enum":["AlwaysAlertWhen","AlertOnceIf","ReportAbout"]},{"type":"null"}],"title":"Alert Type"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"seat_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Seat Id"},"api_key_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key Id"}},"type":"object","required":["id","user_id","cron","model","triggers"],"title":"AlertResponse"},"AnthropicInputJsonDelta":{"properties":{"type":{"type":"string","const":"input_json_delta","title":"Type","default":"input_json_delta"},"partial_json":{"type":"string","title":"Partial Json"}},"type":"object","required":["partial_json"],"title":"AnthropicInputJsonDelta"},"AnthropicTextBlock":{"properties":{"type":{"type":"string","const":"text","title":"Type","default":"text"},"text":{"type":"string","title":"Text","default":""}},"type":"object","title":"AnthropicTextBlock"},"AnthropicTextDelta":{"properties":{"type":{"type":"string","const":"text_delta","title":"Type","default":"text_delta"},"text":{"type":"string","title":"Text"}},"type":"object","required":["text"],"title":"AnthropicTextDelta"},"AnthropicThinkingBlock":{"properties":{"type":{"type":"string","const":"thinking","title":"Type","default":"thinking"},"thinking":{"type":"string","title":"Thinking","default":""}},"type":"object","title":"AnthropicThinkingBlock"},"AnthropicThinkingDelta":{"properties":{"type":{"type":"string","const":"thinking_delta","title":"Type","default":"thinking_delta"},"thinking":{"type":"string","title":"Thinking"}},"type":"object","required":["thinking"],"title":"AnthropicThinkingDelta"},"AnthropicToolUseBlock":{"properties":{"type":{"type":"string","const":"tool_use","title":"Type","default":"tool_use"},"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"input":{"additionalProperties":true,"type":"object","title":"Input"}},"type":"object","required":["id","name"],"title":"AnthropicToolUseBlock"},"ApiKeyResponse":{"properties":{"provider":{"type":"string","enum":["anthropic","google"],"title":"Provider"},"key_hint":{"type":"string","title":"Key Hint"}},"type":"object","required":["provider","key_hint"],"title":"ApiKeyResponse"},"Article":{"properties":{"article_url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Article Url"},"article_id":{"type":"string","format":"uuid","title":"Article Id"},"classification":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"title":"Classification"},"country":{"type":"string","title":"Country"},"source_id":{"type":"string","title":"Source Id"},"page_rank":{"type":"integer","title":"Page Rank"},"domain_url":{"type":"string","title":"Domain Url"},"eng_title":{"type":"string","title":"Eng Title"},"entities":{"$ref":"#/components/schemas/Entities"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url"},"keywords":{"items":{"type":"string"},"type":"array","title":"Keywords"},"language":{"type":"string","title":"Language"},"pub_date":{"type":"string","format":"date-time","title":"Pub Date"},"summary":{"type":"string","title":"Summary"},"key_points":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Key Points"},"title":{"type":"string","title":"Title"},"sentiment":{"type":"integer","title":"Sentiment"},"centroid_distance":{"type":"number","title":"Centroid Distance"},"cluster_probability":{"type":"number","title":"Cluster Probability"},"markdown_citation":{"type":"string","title":"Markdown Citation","default":""},"provocative":{"type":"string","enum":["unknown","low","medium","high"],"title":"Provocative","default":"unknown"},"reporting_voice":{"anyOf":[{"type":"string","enum":["Objective","Subjective","Investigative","Narrative","Analytical","Advocacy","Conversational","Satirical","Emotive","Explanatory","UnknownPersuasive","Sensational"]},{"type":"string"}],"title":"Reporting Voice","default":"Unknown"},"entity_relation_graph":{"anyOf":[{"$ref":"#/components/schemas/asknews_api__schema__v1__common__GraphRelationships"},{"type":"null"}]},"geo_coordinates":{"anyOf":[{"additionalProperties":{"$ref":"#/components/schemas/GeoCoordinate"},"type":"object"},{"type":"null"}],"title":"Geo Coordinates"},"continent":{"anyOf":[{"type":"string","enum":["Africa","Asia","Europe","Middle East","North America","South America","Oceania"]},{"type":"null"}],"title":"Continent"},"assets":{"anyOf":[{"$ref":"#/components/schemas/Assets"},{"type":"null"}]},"social_embeds":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Social Embeds"},"bias":{"anyOf":[{"type":"string","enum":["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"]},{"type":"null"}],"title":"Bias"},"authors":{"anyOf":[{"items":{"$ref":"#/components/schemas/Author"},"type":"array"},{"type":"null"}],"title":"Authors"},"full_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Text"},"original_language_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Original Language Summary"},"image_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Description"},"crawl_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Crawl Date"},"content_type":{"anyOf":[{"type":"string","enum":["news","opinion","analysis","review","listicle","guide","interview","profile","forum","liveblog","fact-check","press_release","obituary","data_journalism"]},{"type":"null"}],"title":"Content Type"}},"type":"object","required":["article_url","article_id","classification","country","source_id","page_rank","domain_url","eng_title","entities","keywords","language","pub_date","summary","title","sentiment","centroid_distance","cluster_probability"],"title":"Article"},"AskNewsSource":{"properties":{"identifier":{"type":"string","const":"asknews","title":"Identifier","default":"asknews"},"params":{"anyOf":[{"$ref":"#/components/schemas/FilterParams"},{"type":"null"}],"description":"The filter params to use"}},"type":"object","title":"AskNewsSource"},"Assets":{"properties":{"images":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Images"},"videos":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Videos"}},"type":"object","title":"Assets"},"Author":{"properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"}},"type":"object","title":"Author"},"BlueskySource":{"properties":{"identifier":{"type":"string","const":"bluesky","title":"Identifier","default":"bluesky"},"params":{"anyOf":[{"$ref":"#/components/schemas/BlueskySourceParams"},{"type":"null"}],"description":"Bluesky source parameters"}},"type":"object","title":"BlueskySource"},"BlueskySourceParams":{"properties":{"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query","description":"The search query"}},"type":"object","title":"BlueskySourceParams"},"Body_build_graph":{"properties":{"query":{"type":"string","title":"Query","description":"Query string that can be any phrase, keyword, question, or paragraph. If method='nl', then this will be used as a natural language query. If method='kw', then this will be used as a direct keyword query.","default":""},"return_articles":{"type":"boolean","title":"Return Articles","description":"Whether to return articles or not.","default":false},"min_cluster_probability":{"type":"number","title":"Min Cluster Probability","description":"Minimum cluster probability to use for disambiguation","default":0.9},"geo_disambiguation":{"type":"boolean","title":"Geo Disambiguation","description":"Whether to use geo disambiguation or not.","default":false},"filter_params":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Filter Params","description":"All parameters available on the search_news endpoint located here: https://docs.asknews.app/en/reference#get-/v1/news/search"},"constrained_disambiguations":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Constrained Disambiguations","description":"Disambiguation correction parameters."},"docs_upload":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Docs Upload","description":"Document upload parameters."},"visualize_with":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Visualize With","description":"Request a visualization graph returned in the response."}},"type":"object","title":"Body_build_graph"},"ChartParameters":{"properties":{"chart_type":{"type":"string","enum":["line","bar","bar_pct"],"title":"Chart Type","description":"The type of chart to create"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"The title of the chart"},"series":{"items":{"$ref":"#/components/schemas/SeriesConfig"},"type":"array","title":"Series","description":"The series configurations for the chart"}},"type":"object","required":["chart_type","series"],"title":"ChartParameters"},"ChartResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"chart_json":{"additionalProperties":true,"type":"object","title":"Chart Json","description":"The plotly fig.to_json() JSON representation of the chart"},"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query"},"reasoning":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reasoning"},"parameters":{"anyOf":[{"$ref":"#/components/schemas/ChartParameters"},{"type":"null"}]},"context":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Context"},"iterations_used":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Iterations Used"},"last_reasoning":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Reasoning"},"last_parameters":{"anyOf":[{"$ref":"#/components/schemas/ChartParameters"},{"type":"null"}]},"png_data":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Png Data","description":"Base64-encoded PNG image data of the chart"},"png_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Png Url","description":"URL to the PNG image of the chart"},"chart_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chart Url","description":"URL to the chart JSON object in S3"}},"type":"object","required":["success","chart_json"],"title":"ChartResponse"},"CirrusMetadata":{"properties":{"create_timestamp":{"type":"string","format":"date-time","title":"Create Timestamp"},"wikibase_item":{"type":"string","title":"Wikibase Item"},"version":{"type":"integer","title":"Version"},"popularity_score":{"type":"number","title":"Popularity Score"},"text_bytes":{"type":"integer","title":"Text Bytes"}},"type":"object","required":["create_timestamp","wikibase_item","version","popularity_score","text_bytes"],"title":"CirrusMetadata"},"ContentBlockDeltaEvent":{"properties":{"type":{"type":"string","const":"content_block_delta","title":"Type","default":"content_block_delta"},"index":{"type":"integer","title":"Index"},"delta":{"oneOf":[{"$ref":"#/components/schemas/AnthropicTextDelta"},{"$ref":"#/components/schemas/AnthropicThinkingDelta"},{"$ref":"#/components/schemas/AnthropicInputJsonDelta"}],"title":"Delta"}},"type":"object","required":["index","delta"],"title":"ContentBlockDeltaEvent"},"ContentBlockStartEvent":{"properties":{"type":{"type":"string","const":"content_block_start","title":"Type","default":"content_block_start"},"index":{"type":"integer","title":"Index"},"content_block":{"oneOf":[{"$ref":"#/components/schemas/AnthropicTextBlock"},{"$ref":"#/components/schemas/AnthropicThinkingBlock"},{"$ref":"#/components/schemas/AnthropicToolUseBlock"}],"title":"Content Block"}},"type":"object","required":["index","content_block"],"title":"ContentBlockStartEvent"},"ContentBlockStopEvent":{"properties":{"type":{"type":"string","const":"content_block_stop","title":"Type","default":"content_block_stop"},"index":{"type":"integer","title":"Index"}},"type":"object","required":["index"],"title":"ContentBlockStopEvent"},"CountResponse":{"properties":{"count":{"type":"integer","title":"Count"}},"type":"object","required":["count"],"title":"CountResponse"},"CreateAlertRequest":{"properties":{"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query","description":"The query to run for retrieving information from sources, and for checking the alert. If you have defined one or more reports, specify each report's individual query in the report prompt.","example":"I want to be alerted if the president of the US says something about the economy"},"sources":{"anyOf":[{"$ref":"#/components/schemas/Sources"},{"type":"null"}],"description":"The sources to use for retrieving information related to the alert query. Available sources are: AskNewsSource, TelegramSource, BlueskySource, WebSource, DeepNewsSource"},"alert_type":{"anyOf":[{"type":"string","enum":["AlwaysAlertWhen","AlertOnceIf","ReportAbout"]},{"type":"null"}],"title":"Alert Type","description":"The type of alert. If specified, overrides `repeat` and `always_trigger`. 'AlwaysAlertWhen': trigger alert actions any time the alert query is satisfied (`repeat=True`, `always_trigger=False`). Add Report model if you want a report when this is triggered. 'AlertOnceIf': trigger alert actions when the alert query is satisfied and then disable the alert (`repeat=False`, `always_trigger=False`). Add Report model if you want a report when this is triggered. 'ReportAbout': always trigger alert actions according to cron schedule and write a report (`repeat=True`, `always_trigger=True`). Defaults to using DeepNews for the report unless specified.","example":""},"model":{"type":"string","enum":["meta-llama/Meta-Llama-3.1-8B-Instruct","gpt-4o-mini","gpt-5-mini","gpt-5-nano","gpt-4o","o3-mini","meta-llama/Meta-Llama-3.3-70B-Instruct","gpt-4.1-2025-04-14","gpt-4.1-nano-2025-04-14","gpt-4.1-mini-2025-04-14","claude-sonnet-5"],"title":"Model","description":"The model that is used to check if the alert conditions are satisfied by sources (this is not the same as the model used to write the report.)Defaults to gpt-4o.","default":"gpt-4o","example":"gpt-4o-mini"},"cron":{"type":"string","title":"Cron","description":"How often or when to check sources for this alert, specified as a cron expression. Examples: '0 * * * *' (hourly), '0 9 * * *' (daily at 9am), '0 9 * * 1' (Mondays at 9am).  See https://crontab.run/ for more examples.","example":"'0 0 * * *' (daily at midnight UTC)"},"triggers":{"$ref":"#/components/schemas/Triggers","description":"Configuration for actions to trigger for the alert. Available actions are: WebhookAction, EmailAction, ResendBroadcastAction, GoogleDocsAction"},"always_trigger":{"type":"boolean","title":"Always Trigger","description":"Whether to always trigger the actions when sources are scanned. This skips the check for if the alert conditions are satisfied and run triggers immediately. Defaults to False.","default":false},"repeat":{"type":"boolean","title":"Repeat","description":"Whether to repeat the alert. Default is True. If False, the alert will be disabled after it triggers once.","default":true},"active":{"type":"boolean","title":"Active","description":"Whether the alert is active or not. Default is True.","default":true},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At","description":"The expiration date for the alert. Default is None. If set, the alert will be disabled after this date."},"report":{"anyOf":[{"oneOf":[{"$ref":"#/components/schemas/LegacyReportRequest"},{"$ref":"#/components/schemas/DeepNewsReportRequest"}],"discriminator":{"propertyName":"identifier","mapping":{"deepnews":"#/components/schemas/DeepNewsReportRequest","legacy":"#/components/schemas/LegacyReportRequest"}}},{"items":{"oneOf":[{"$ref":"#/components/schemas/LegacyReportRequest"},{"$ref":"#/components/schemas/DeepNewsReportRequest"}],"discriminator":{"propertyName":"identifier","mapping":{"deepnews":"#/components/schemas/DeepNewsReportRequest","legacy":"#/components/schemas/LegacyReportRequest"}}},"type":"array"},{"type":"null"}],"title":"Report","description":"Configuration for generating a written report when the alert triggers. If report is a list, the individual reports will be concatenated into one report in the order they are defined. If not specified, no report is generated. Use ReportRequest(identifier='deepnews', ...) for DeepNews reports.Use ReportRequest(...) or ReportRequest(identifier='legacy', ...) for legacy reports (DEPRECATED). Requests without identifier default to 'deepnews'. Only DeepNews reports can be used in list."},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"The title of the alert. If not provided, no title will be used.","example":"Alert for US President's statements on the economy"},"share_link":{"anyOf":[{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},{"type":"null"}],"title":"Share Link","description":"The newsplunker share link to update when the alert triggers."}},"type":"object","required":["cron","triggers"],"title":"CreateAlertRequest"},"CreateChartRequest":{"properties":{"query":{"type":"string","title":"Query","description":"The chart query to create"}},"type":"object","required":["query"],"title":"CreateChartRequest"},"CreateChatCompletionRequest":{"properties":{"model":{"type":"string","title":"Model","default":"gpt-4o-mini"},"messages":{"items":{"$ref":"#/components/schemas/CreateChatCompletionRequestMessage"},"type":"array","title":"Messages"},"temperature":{"type":"number","title":"Temperature","default":0.9},"top_p":{"type":"number","title":"Top P","default":1},"n":{"type":"integer","title":"N","default":1},"stream":{"type":"boolean","title":"Stream","default":false},"stop":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Stop"},"max_tokens":{"type":"integer","title":"Max Tokens","default":9999},"presence_penalty":{"type":"integer","title":"Presence Penalty","default":0},"frequency_penalty":{"type":"integer","title":"Frequency Penalty","default":0},"thread_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thread Id"},"user":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User"},"inline_citations":{"type":"string","enum":["numbered","markdown_link","none"],"title":"Inline Citations","default":"markdown_link"},"append_references":{"type":"boolean","title":"Append References","default":true},"journalist_mode":{"type":"boolean","title":"Journalist Mode","default":true},"asknews_watermark":{"type":"boolean","title":"Asknews Watermark","default":true},"conversational_awareness":{"type":"boolean","title":"Conversational Awareness","default":true},"filter_params":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Filter Params"}},"additionalProperties":true,"type":"object","required":["messages"],"title":"CreateChatCompletionRequest"},"CreateChatCompletionRequestMessage":{"properties":{"role":{"type":"string","title":"Role"},"content":{"type":"string","title":"Content"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"function_call":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Function Call"}},"type":"object","required":["role","content"],"title":"CreateChatCompletionRequestMessage"},"CreateChatCompletionResponse":{"properties":{"id":{"type":"string","title":"Id"},"created":{"type":"integer","title":"Created"},"object":{"type":"string","title":"Object","default":"chat.completion"},"model":{"type":"string","title":"Model","default":"gpt-4o-mini"},"usage":{"$ref":"#/components/schemas/CreateChatCompletionResponseUsage"},"choices":{"items":{"$ref":"#/components/schemas/CreateChatCompletionResponseChoice"},"type":"array","title":"Choices"}},"type":"object","required":["id","created","usage","choices"],"title":"CreateChatCompletionResponse"},"CreateChatCompletionResponseChoice":{"properties":{"index":{"type":"integer","title":"Index"},"message":{"$ref":"#/components/schemas/CreateChatCompletionRequestMessage"},"finish_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Finish Reason"}},"type":"object","required":["index","message"],"title":"CreateChatCompletionResponseChoice"},"CreateChatCompletionResponseStream":{"properties":{"id":{"type":"string","title":"Id"},"created":{"type":"integer","title":"Created"},"object":{"type":"string","title":"Object","default":"chat.completion.chunk"},"model":{"type":"string","title":"Model","default":"gpt-4o-mini"},"usage":{"$ref":"#/components/schemas/CreateChatCompletionResponseUsage"},"choices":{"items":{"$ref":"#/components/schemas/CreateChatCompletionResponseStreamChoice"},"type":"array","title":"Choices"}},"type":"object","required":["id","created","usage","choices"],"title":"CreateChatCompletionResponseStream"},"CreateChatCompletionResponseStreamChoice":{"properties":{"index":{"type":"integer","title":"Index"},"delta":{"$ref":"#/components/schemas/CreateChatCompletionRequestMessage"},"finish_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Finish Reason"}},"type":"object","required":["index","delta"],"title":"CreateChatCompletionResponseStreamChoice"},"CreateChatCompletionResponseUsage":{"properties":{"prompt_tokens":{"type":"integer","title":"Prompt Tokens"},"completion_tokens":{"type":"integer","title":"Completion Tokens"},"total_tokens":{"type":"integer","title":"Total Tokens"}},"type":"object","required":["prompt_tokens","completion_tokens","total_tokens"],"title":"CreateChatCompletionResponseUsage"},"CreateDeepNewsRequest":{"properties":{"messages":{"items":{"$ref":"#/components/schemas/CreateDeepNewsRequestMessage"},"type":"array","title":"Messages","description":"The messages to send to DeepNews. Each message should have 'role' and 'content' keys. Use this to specify what research/monitoring task DeepNews should perform. The 'content' for the final 'user' message should be your Alert query.","example":[{"content":"What are the latest developments in AI regulation?","role":"user"}]},"model":{"anyOf":[{"$ref":"#/components/schemas/DeepNewsModel"},{"type":"null"}],"description":"The model to use for DeepNews research. Defaults to claude-sonnet-5.","default":"claude-sonnet-5","example":"claude-sonnet-5"},"filter_params":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Filter Params","description":"Filter parameters to apply to the AskNews search within DeepNews."},"search_depth":{"type":"integer","maximum":190,"minimum":1,"title":"Search Depth","description":"The search depth for deep research. Higher values mean more thorough research.","default":2},"max_depth":{"type":"integer","maximum":200,"minimum":1,"title":"Max Depth","description":"The maximum research depth allowed.","default":6},"sources":{"anyOf":[{"type":"string","enum":["asknews","google","graph","wiki","x","reddit","charts","email","full_text_discovery","podcasts"]},{"items":{"type":"string","enum":["asknews","google","graph","wiki","x","reddit","charts","email","full_text_discovery","podcasts"]},"type":"array"}],"title":"Sources","description":"Which data sources DeepNews should use. Can be a single source or a list. Available sources are: asknews, google, graph, wiki, x, reddit, charts, email, full_text_discovery, podcasts","default":"asknews"},"inline_citations":{"type":"string","enum":["markdown_link","numbered","none"],"title":"Inline Citations","description":"How to format inline citations in the response. Defaults to: markdown_link. Available options: markdown_link, numbered, none","default":"markdown_link"},"start_citation_number":{"type":"integer","title":"Start Citation Number","description":"Starting number for inline citations. Offsets fetched source citation keys. Useful if you are providing the agent outside sources with numbered citation keys.","default":1},"return_sources":{"type":"boolean","title":"Return Sources","description":"Whether return a list of sources used by the agent.","default":true},"only_cited_sources":{"type":"boolean","title":"Only Cited Sources","description":"Whether to return only of sources that are cited/referenced in the generated response content.","default":true},"append_references":{"type":"boolean","title":"Append References","description":"Whether to append a 'Cited Articles' section at the end of the response.","default":true},"journalist_mode":{"type":"boolean","title":"Journalist Mode","description":"Whether to use journalist mode for more factual reporting.","default":true},"conversational_awareness":{"type":"boolean","title":"Conversational Awareness","description":"Whether to use conversational awareness.","default":true},"include_entities":{"type":"boolean","title":"Include Entities","description":"Whether to provide extracted entities to the agent.","default":true},"include_graphs":{"type":"boolean","title":"Include Graphs","description":"Whether to provide knowledge graphs to the agent","default":false},"include_coordinates":{"type":"boolean","title":"Include Coordinates","description":"Whether to provide geo coordinates to the agent.","default":false},"asknews_watermark":{"type":"boolean","title":"Asknews Watermark","description":"Append 'Generated by AskNews AI' watermark","default":true},"stream":{"type":"boolean","title":"Stream","description":"Whether to stream the response as server-sent events.","default":false},"stop":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Stop","description":"Sequence(s) where the model will stop generating further tokens."},"temperature":{"type":"number","title":"Temperature","description":"The temperature of the DeepNews agent model. Controls randomness in the output. Higher values (e.g., 1.0) make output more random, lower values (e.g., 0.1) make it more deterministic.","default":0.9},"top_p":{"type":"number","title":"Top P","description":"Nucleus sampling parameter. Only tokens with cumulative probability up to top_p are considered.","default":1},"n":{"type":"integer","title":"N","description":"Number of completions to generate.","default":1},"max_tokens":{"type":"integer","title":"Max Tokens","description":"Maximum number of tokens to generate in the response.","default":9999},"presence_penalty":{"type":"integer","title":"Presence Penalty","description":"Penalizes new tokens based on whether they appear in the text so far, encouraging new topics.","default":0},"frequency_penalty":{"type":"integer","title":"Frequency Penalty","description":"Penalizes new tokens based on their frequency in the text so far, reducing repetition.","default":0},"user":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User","description":"A unique identifier for the end-user, useful for tracking and abuse detection."},"thread_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Thread Id","description":"ID of an existing thread to continue the conversation."},"max_parallel_tool_calls":{"type":"integer","maximum":4,"minimum":1,"title":"Max Parallel Tool Calls","description":"Maximum number of parallel tool calls (e.g., searches) the agent can make during generation. Higher values may speed up responses, but may reduce on-the-fly adaptivity.","default":1},"engine":{"type":"string","enum":["v1","v1.5","v2.0"],"title":"Engine","description":"The engine to use for the DeepNews agent. 'v1' is deprecated while 'v1.5' is our next-generation research agent with access to more tools, better contextual understanding, and improved reasoning capabilities.'v1.5' streams thinking and tool use using tags <think> </think>, <tool_a> </tool_a> Meanwhile, 'v2.0' is the same underlying agent as 'v1.5', but the thinking and tool use chunks are typed content_block_delta's streamed between content_block_start and content_block_stop events, mimicking Anthropic's approach to streaming tool use/thinking events.","default":"v1.5"},"enable_source_pruning":{"type":"boolean","title":"Enable Source Pruning","description":"Whether to enable source pruning, which removes sources that are deemed irrelevant to the final response. This can help reduce noise in the sources and improve the quality of the response, but may also remove some relevant sources if not used carefully.","default":false},"cutoff_datetime":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Cutoff Datetime","description":"The knowledge cutoff datetime for the agent prompt and all tool calls."}},"additionalProperties":true,"type":"object","required":["messages"],"title":"CreateDeepNewsRequest"},"CreateDeepNewsRequestMessage":{"properties":{"role":{"type":"string","title":"Role"},"content":{"type":"string","title":"Content"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"function_call":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Function Call"}},"type":"object","required":["role","content"],"title":"CreateDeepNewsRequestMessage"},"CreateDeepNewsResponse":{"properties":{"id":{"type":"string","title":"Id"},"created":{"type":"integer","title":"Created"},"object":{"type":"string","title":"Object","default":"chat.completion"},"model":{"type":"string","title":"Model","default":"claude-sonnet-5"},"usage":{"$ref":"#/components/schemas/CreateDeepNewsResponseUsage"},"choices":{"items":{"$ref":"#/components/schemas/CreateDeepNewsResponseChoice"},"type":"array","title":"Choices"},"sources":{"$ref":"#/components/schemas/DeepNewsResponseSources"}},"type":"object","required":["id","created","usage","choices","sources"],"title":"CreateDeepNewsResponse"},"CreateDeepNewsResponseChoice":{"properties":{"index":{"type":"integer","title":"Index"},"message":{"$ref":"#/components/schemas/CreateDeepNewsRequestMessage"},"finish_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Finish Reason"}},"type":"object","required":["index","message"],"title":"CreateDeepNewsResponseChoice"},"CreateDeepNewsResponseStreamChunk":{"properties":{"id":{"type":"string","title":"Id"},"created":{"type":"integer","title":"Created"},"object":{"type":"string","title":"Object","default":"chat.completion.chunk"},"model":{"type":"string","title":"Model","default":"claude-sonnet-5"},"usage":{"$ref":"#/components/schemas/CreateDeepNewsResponseUsage"},"choices":{"items":{"$ref":"#/components/schemas/CreateDeepNewsResponseStreamChunkChoice"},"type":"array","title":"Choices"}},"type":"object","required":["id","created","usage","choices"],"title":"CreateDeepNewsResponseStreamChunk"},"CreateDeepNewsResponseStreamChunkChoice":{"properties":{"index":{"type":"integer","title":"Index"},"delta":{"$ref":"#/components/schemas/CreateDeepNewsRequestMessage"},"finish_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Finish Reason"}},"type":"object","required":["index","delta"],"title":"CreateDeepNewsResponseStreamChunkChoice"},"CreateDeepNewsResponseStreamChunkChoiceV2":{"properties":{"index":{"type":"integer","title":"Index"},"delta":{"oneOf":[{"$ref":"#/components/schemas/MessageStartEvent"},{"$ref":"#/components/schemas/ContentBlockStartEvent"},{"$ref":"#/components/schemas/ContentBlockDeltaEvent"},{"$ref":"#/components/schemas/ContentBlockStopEvent"},{"$ref":"#/components/schemas/MessageStopEvent"}],"title":"Delta"},"finish_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Finish Reason"}},"type":"object","required":["index","delta"],"title":"CreateDeepNewsResponseStreamChunkChoiceV2"},"CreateDeepNewsResponseStreamChunkV2":{"properties":{"id":{"type":"string","title":"Id"},"created":{"type":"integer","title":"Created"},"object":{"type":"string","title":"Object","default":"chat.completion.chunk"},"model":{"type":"string","title":"Model","default":"claude-sonnet-5"},"usage":{"$ref":"#/components/schemas/CreateDeepNewsResponseUsage"},"choices":{"items":{"$ref":"#/components/schemas/CreateDeepNewsResponseStreamChunkChoiceV2"},"type":"array","title":"Choices"}},"type":"object","required":["id","created","usage","choices"],"title":"CreateDeepNewsResponseStreamChunkV2"},"CreateDeepNewsResponseStreamSource":{"properties":{"id":{"type":"string","title":"Id"},"created":{"type":"integer","title":"Created"},"object":{"type":"string","title":"Object","default":"chat.completion.source"},"source":{"anyOf":[{"$ref":"#/components/schemas/CreateDeepNewsResponseStreamSourcesNewsSource"},{"$ref":"#/components/schemas/CreateDeepNewsResponseStreamSourcesWebSource"},{"$ref":"#/components/schemas/CreateDeepNewsResponseStreamSourcesGraphSource"},{"$ref":"#/components/schemas/CreateDeepNewsResponseStreamSourcesChartSource"}],"title":"Source"}},"type":"object","required":["id","created","source"],"title":"CreateDeepNewsResponseStreamSource"},"CreateDeepNewsResponseStreamSourcesChartSource":{"properties":{"kind":{"type":"string","const":"chart","title":"Kind","default":"chart"},"data":{"$ref":"#/components/schemas/ChartResponse"}},"type":"object","required":["data"],"title":"CreateDeepNewsResponseStreamSourcesChartSource"},"CreateDeepNewsResponseStreamSourcesGraphSource":{"properties":{"kind":{"type":"string","const":"graph","title":"Kind","default":"graph"},"data":{"type":"string","minLength":1,"format":"uri","title":"Data"}},"type":"object","required":["data"],"title":"CreateDeepNewsResponseStreamSourcesGraphSource"},"CreateDeepNewsResponseStreamSourcesNewsSource":{"properties":{"kind":{"type":"string","const":"news","title":"Kind","default":"news"},"data":{"$ref":"#/components/schemas/SearchResponseDictItem"}},"type":"object","required":["data"],"title":"CreateDeepNewsResponseStreamSourcesNewsSource"},"CreateDeepNewsResponseStreamSourcesWebSource":{"properties":{"kind":{"type":"string","const":"web","title":"Kind","default":"web"},"data":{"$ref":"#/components/schemas/WebSearchResult"}},"type":"object","required":["data"],"title":"CreateDeepNewsResponseStreamSourcesWebSource"},"CreateDeepNewsResponseUsage":{"properties":{"prompt_tokens":{"type":"integer","title":"Prompt Tokens"},"completion_tokens":{"type":"integer","title":"Completion Tokens"},"total_tokens":{"type":"integer","title":"Total Tokens"},"tool_usage":{"anyOf":[{"additionalProperties":{"type":"integer"},"type":"object"},{"type":"null"}],"title":"Tool Usage"}},"type":"object","required":["prompt_tokens","completion_tokens","total_tokens"],"title":"CreateDeepNewsResponseUsage"},"CreateNewsletterRequest":{"properties":{"name":{"type":"string","title":"Name","description":"The name of the newsletter.","example":"Daily Economy News"},"query":{"type":"string","title":"Query","description":"The natural language query to run for the newsletter.","example":"Send me the latest news on the economy."},"cron":{"type":"string","title":"Cron","description":"The cron schedule for the newsletter. For example daily at 00:00 UTC is '0 0 * * *'. See https://crontab.run/ for more examples","example":"0 0 * * *"},"model":{"type":"string","enum":["gpt-4o","gpt-4o-mini","claude-3-5-sonnet-latest","meta-llama/Meta-Llama-3.1-405B-Instruct","meta-llama/Meta-Llama-3.3-70B-Instruct"],"title":"Model","description":"The model to use for the newsletter.","example":"gpt-4o-mini"},"subject":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subject","description":"The subject of the newsletter. If not provided it will be auto generated.","example":"Your Daily Economy News"},"sender":{"type":"string","title":"Sender","description":"The sender of the newsletter.","example":"Your Name <sender@domain.com>"},"logo_url":{"anyOf":[{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},{"type":"null"}],"title":"Logo Url","description":"The logo URL for the newsletter.","example":"https://example.com/logo.png"},"reply_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reply To","description":"The reply-to address for the newsletter. If not provided, the sender will be used.","example":"Your Name <sender@domain.com>"},"audience_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Audience Id","description":"The audience ID to use for the newsletter. If not provided a new audience will be created.","example":"123e4567-e89b-12d3-a456-426614174000"},"resend_api_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resend Api Key","description":"The resend API key to use for the newsletter. If not provided, the newsletter will not be sent.","example":"re_123456789"},"public":{"type":"boolean","title":"Public","description":"Whether the newsletter is public or not. If not provided, the newsletter will be public. If you make the newsletter public only title and query will be shown.","default":true},"active":{"type":"boolean","title":"Active","description":"Whether the newsletter is active or not. If not provided, the newsletter will be active. If you make the newsletter inactive, it will not be sent.","default":true},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At","description":"The expiration date for the alert. Default is None. If set, the alert will be disabled after this date."}},"type":"object","required":["name","query","cron","model","sender"],"title":"CreateNewsletterRequest"},"DeepNewsModel":{"type":"string","enum":["o1-mini","o1","o3-mini","o3","gpt-4o-mini","gpt-4o","gpt-4.1-2025-04-14","gpt-5-mini","gpt-5","command-nightly","claude-3-5-sonnet-20240620","claude-3-5-sonnet-latest","claude-3-7-sonnet-latest","claude-3-7-sonnet-20250219","claude-3-7-sonnet-nothinking","claude-sonnet-4-20250514","claude-opus-4-20250514","claude-sonnet-4-5-20250929","claude-opus-4-5-20251101","claude-sonnet-4-6","claude-sonnet-5","claude-opus-4-8","claude-opus-5","claude-opus-4-6","claude-fable-5","gpt-5.6-terra","gpt-5.6-sol","deepseek","deepseek-basic","deepseek-r1-0528","meta-llama/Meta-Llama-3-8B-Instruct","meta-llama/Meta-Llama-3.1-405B-Instruct","meta-llama/Meta-Llama-3.3-70B-Instruct","meta-llama/Llama-4-Maverick-17B-128E-Instruct","gemini-2.5-flash","gemini-2.5-pro","gemini-2.5-pro-preview-03-25","gemini-3-pro","gemini-3.1-pro","gemini-3-flash","gemini-3.5-flash","gemini-3.6-flash","open-source-best","kimi-k2p5"],"title":"DeepNewsModel"},"DeepNewsModelItem":{"properties":{"model":{"$ref":"#/components/schemas/DeepNewsModel"},"type":{"type":"string","enum":["standard","lite","advanced"],"title":"Type"}},"type":"object","required":["model","type"],"title":"DeepNewsModelItem"},"DeepNewsReportParams":{"properties":{"sources":{"anyOf":[{"type":"string","enum":["asknews","google","graph","wiki","x","reddit","charts","email","full_text_discovery","podcasts"]},{"items":{"type":"string","enum":["asknews","google","graph","wiki","x","reddit","charts","email","full_text_discovery","podcasts"]},"type":"array"}],"title":"Sources","description":"Which data sources DeepNews should use. Can be a single source or a list. Available sources are: asknews, google, graph, wiki, x, reddit, charts, email, full_text_discovery, podcasts. Defaults to ['asknews', 'google', 'wiki', 'x'].","default":["asknews","google","wiki","x"]},"filter_params":{"anyOf":[{"$ref":"#/components/schemas/MCPFilterParams"},{"type":"null"}],"description":"Filter parameters to apply to the AskNews search within DeepNews."},"include_entities":{"type":"boolean","title":"Include Entities","description":"Whether to provide extracted entities to the agent. Defaults to True.","default":true},"include_graphs":{"type":"boolean","title":"Include Graphs","description":"Whether to provide knowledge graphs to the agent. Defaults to False.","default":false},"include_coordinates":{"type":"boolean","title":"Include Coordinates","description":"Whether to provide geo coordinates to the agent. Defaults to False.","default":false},"engine":{"type":"string","enum":["v1","v1.5"],"title":"Engine","description":"Legacy vs new DeepNews engine","default":"v1.5"},"max_parallel_tool_calls":{"type":"integer","maximum":4,"minimum":1,"title":"Max Parallel Tool Calls","description":"The number of tool calls the agent can run in parallel.","default":1},"enable_source_pruning":{"type":"boolean","title":"Enable Source Pruning","description":"Whether to enable source pruning, which removes sources that are deemed irrelevant to the final report. This can help reduce noise in the sources and improve the quality of the report, but may also remove some relevant sources if not used carefully.","default":false},"cutoff_datetime":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Cutoff Datetime","description":"The knowledge cutoff datetime for the agent prompt and all tool calls."},"model":{"anyOf":[{"$ref":"#/components/schemas/DeepNewsModel"},{"type":"null"}],"description":"The model to use for DeepNews research. Defaults to claude-sonnet-5","default":"claude-sonnet-5","example":"claude-sonnet-5"},"search_depth":{"type":"integer","maximum":190,"minimum":1,"title":"Search Depth","description":"The search depth for deep research. Higher values mean more thorough research. Defaults to 2.","default":2},"max_depth":{"type":"integer","maximum":200,"minimum":1,"title":"Max Depth","description":"The maximum research depth allowed. Defaults to 4.","default":4},"start_citation_number":{"type":"integer","title":"Start Citation Number","description":"Starting number for inline citations. Offsets fetched source citation keys. Useful if you are providing the agent outside sources with numbered citation keys. Defaults to 1.","default":1},"journalist_mode":{"type":"boolean","title":"Journalist Mode","description":"Whether to use journalist mode for more factual reporting. Defaults to True.","default":true}},"type":"object","title":"DeepNewsReportParams","description":"Parameters for DeepNews alert report.\n\nDeepNews performs deep research using multiple tools."},"DeepNewsReportRequest":{"properties":{"logo_url":{"anyOf":[{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},{"type":"null"}],"title":"Logo Url","description":"The logo URL to use for the report"},"include_appendix":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Include Appendix","description":"Whether to append thinking and search traces as an appendix to the report.","default":false},"asknews_watermark":{"type":"boolean","title":"Asknews Watermark","description":"Append 'Generated by AskNews AI' watermark","default":true},"identifier":{"type":"string","const":"deepnews","title":"Identifier","default":"deepnews"},"params":{"$ref":"#/components/schemas/DeepNewsReportParams"},"prompt":{"type":"string","title":"Prompt","description":"The prompt to use for report generation instructions. This is similar to the alert query but can contain additional instructions on how to format the report.","example":["Monitor Tesla stock and summarize any major price movements with percentage changes","Track the current situation in the Middle East and give me a bullet point list of recent events"]}},"type":"object","required":["prompt"],"title":"DeepNewsReportRequest","description":"DeepNews report configuration.\n\nUses DeepNews deep research capabilities for information retrieval and report generation."},"DeepNewsResponseSources":{"properties":{"news":{"anyOf":[{"items":{"$ref":"#/components/schemas/SearchResponseDictItem"},"type":"array"},{"type":"null"}],"title":"News"},"web":{"anyOf":[{"items":{"$ref":"#/components/schemas/WebSearchResult"},"type":"array"},{"type":"null"}],"title":"Web"}},"type":"object","title":"DeepNewsResponseSources"},"DeepNewsSource":{"properties":{"identifier":{"type":"string","const":"deepnews","title":"Identifier","default":"deepnews"},"params":{"$ref":"#/components/schemas/DeepNewsSourceParams"}},"type":"object","title":"DeepNewsSource"},"DeepNewsSourceParams":{"properties":{"sources":{"anyOf":[{"type":"string","enum":["asknews","google","graph","wiki","x","reddit","charts","email","full_text_discovery","podcasts"]},{"items":{"type":"string","enum":["asknews","google","graph","wiki","x","reddit","charts","email","full_text_discovery","podcasts"]},"type":"array"}],"title":"Sources","description":"Which data sources DeepNews should use. Can be a single source or a list. Available sources are: asknews, google, graph, wiki, x, reddit, charts, email, full_text_discovery, podcasts. Defaults to ['asknews', 'google', 'wiki', 'x'].","default":["asknews","google","wiki","x"]},"filter_params":{"anyOf":[{"$ref":"#/components/schemas/MCPFilterParams"},{"type":"null"}],"description":"Filter parameters to apply to the AskNews search within DeepNews."},"include_entities":{"type":"boolean","title":"Include Entities","description":"Whether to provide extracted entities to the agent. Defaults to True.","default":true},"include_graphs":{"type":"boolean","title":"Include Graphs","description":"Whether to provide knowledge graphs to the agent. Defaults to False.","default":false},"include_coordinates":{"type":"boolean","title":"Include Coordinates","description":"Whether to provide geo coordinates to the agent. Defaults to False.","default":false},"engine":{"type":"string","enum":["v1","v1.5"],"title":"Engine","description":"Legacy vs new DeepNews engine","default":"v1.5"},"max_parallel_tool_calls":{"type":"integer","maximum":4,"minimum":1,"title":"Max Parallel Tool Calls","description":"The number of tool calls the agent can run in parallel.","default":1},"enable_source_pruning":{"type":"boolean","title":"Enable Source Pruning","description":"Whether to enable source pruning, which removes sources that are deemed irrelevant to the final report. This can help reduce noise in the sources and improve the quality of the report, but may also remove some relevant sources if not used carefully.","default":false},"cutoff_datetime":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Cutoff Datetime","description":"The knowledge cutoff datetime for the agent prompt and all tool calls."},"model":{"anyOf":[{"$ref":"#/components/schemas/DeepNewsModel"},{"type":"null"}],"description":"The model to use for DeepNews research. Defaults to gemini-3-flash","default":"gemini-3-flash","example":"claude-sonnet-4-5-20250929"},"search_depth":{"type":"integer","maximum":20,"minimum":1,"title":"Search Depth","description":"The search depth for deep research. Higher values mean more thorough research. Defaults to 1.","default":1},"max_depth":{"type":"integer","maximum":40,"minimum":1,"title":"Max Depth","description":"The maximum research depth allowed. Defaults to 4.","default":4}},"type":"object","title":"DeepNewsSourceParams","description":"Parameters for DeepNews alert source.\n\nDeepNews performs deep research using multiple tools."},"DisplayImageUrl":{"properties":{"source_id":{"type":"string","title":"Source Id"},"image_url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Image Url"}},"type":"object","required":["source_id","image_url"],"title":"DisplayImageUrl"},"DomainHitsSurfaceDayItem":{"properties":{"day":{"type":"string","title":"Day"},"hits":{"type":"integer","title":"Hits"},"surfaced":{"type":"integer","title":"Surfaced"}},"type":"object","required":["day","hits","surfaced"],"title":"DomainHitsSurfaceDayItem"},"DomainHitsSurfaceResponse":{"properties":{"hits":{"type":"integer","title":"Hits"},"surfaced":{"type":"integer","title":"Surfaced"}},"type":"object","required":["hits","surfaced"],"title":"DomainHitsSurfaceResponse"},"DomainHitsSurfaceTimeWindowResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/DomainHitsSurfaceDayItem"},"type":"array","title":"Data"},"total_hits":{"type":"integer","title":"Total Hits"},"total_surfaced":{"type":"integer","title":"Total Surfaced"}},"type":"object","required":["data","total_hits","total_surfaced"],"title":"DomainHitsSurfaceTimeWindowResponse"},"DomainMetricsDayItem":{"properties":{"day":{"type":"string","title":"Day"},"surfaces":{"type":"integer","title":"Surfaces"},"citations":{"type":"integer","title":"Citations"},"full_text":{"type":"integer","title":"Full Text"},"grounded":{"type":"integer","title":"Grounded","default":0}},"type":"object","required":["day","surfaces","citations","full_text"],"title":"DomainMetricsDayItem"},"DomainMetricsResponse":{"properties":{"surfaces":{"type":"integer","title":"Surfaces"},"citations":{"type":"integer","title":"Citations"},"full_text":{"type":"integer","title":"Full Text"},"grounded":{"type":"integer","title":"Grounded","default":0}},"type":"object","required":["surfaces","citations","full_text"],"title":"DomainMetricsResponse","description":"Raw (unweighted) publisher metric event counts — 1 per real event."},"DomainMetricsTimeWindowResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/DomainMetricsDayItem"},"type":"array","title":"Data"},"total_surfaces":{"type":"integer","title":"Total Surfaces"},"total_citations":{"type":"integer","title":"Total Citations"},"total_full_text":{"type":"integer","title":"Total Full Text"},"total_grounded":{"type":"integer","title":"Total Grounded","default":0}},"type":"object","required":["data","total_surfaces","total_citations","total_full_text"],"title":"DomainMetricsTimeWindowResponse"},"DomainQueriesResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/DomainQueryClusterItem"},"type":"array","title":"Data"}},"type":"object","required":["data"],"title":"DomainQueriesResponse"},"DomainQueryArticleItem":{"properties":{"article_id":{"type":"string","title":"Article Id"},"hit_date":{"type":"string","title":"Hit Date"}},"type":"object","required":["article_id","hit_date"],"title":"DomainQueryArticleItem"},"DomainQueryClusterItem":{"properties":{"cluster_label":{"type":"string","title":"Cluster Label"},"cluster_description":{"type":"string","title":"Cluster Description"},"cluster_classification":{"type":"string","title":"Cluster Classification"},"centroid_coords":{"prefixItems":[{"type":"number"},{"type":"number"}],"type":"array","maxItems":2,"minItems":2,"title":"Centroid Coords"},"cluster_queries":{"items":{"$ref":"#/components/schemas/DomainQueryItem"},"type":"array","title":"Cluster Queries"}},"type":"object","required":["cluster_label","cluster_description","cluster_classification","centroid_coords","cluster_queries"],"title":"DomainQueryClusterItem"},"DomainQueryItem":{"properties":{"query":{"type":"string","title":"Query"},"coords":{"prefixItems":[{"type":"number"},{"type":"number"}],"type":"array","maxItems":2,"minItems":2,"title":"Coords"},"n_hits":{"type":"integer","title":"N Hits"},"articles":{"items":{"$ref":"#/components/schemas/DomainQueryArticleItem"},"type":"array","title":"Articles"}},"type":"object","required":["query","coords","n_hits","articles"],"title":"DomainQueryItem"},"EmailAction":{"properties":{"action":{"type":"string","const":"email","title":"Action","default":"email"},"params":{"$ref":"#/components/schemas/EmailParams"}},"type":"object","required":["params"],"title":"EmailAction"},"EmailParams":{"properties":{"to":{"type":"string","format":"email","title":"To","description":"The email to send the alert to when it triggers"},"subject":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subject","description":"The subject of the email. If not provided, the default subject will be used."},"asknews_watermark":{"type":"boolean","title":"Asknews Watermark","description":"Append 'Generated by AskNews AI' watermark","default":true}},"type":"object","required":["to"],"title":"EmailParams"},"Entities":{"properties":{"Person":{"items":{"type":"string"},"type":"array","title":"Person","default":[]},"Organization":{"items":{"type":"string"},"type":"array","title":"Organization","default":[]},"Location":{"items":{"type":"string"},"type":"array","title":"Location","default":[]},"Nationality":{"items":{"type":"string"},"type":"array","title":"Nationality","default":[]},"Date":{"items":{"type":"string"},"type":"array","title":"Date","default":[]},"Event":{"items":{"type":"string"},"type":"array","title":"Event","default":[]},"Money":{"items":{"type":"string"},"type":"array","title":"Money","default":[]},"Law":{"items":{"type":"string"},"type":"array","title":"Law","default":[]},"Quantity":{"items":{"type":"string"},"type":"array","title":"Quantity","default":[]},"Time":{"items":{"type":"string"},"type":"array","title":"Time","default":[]},"Sports":{"items":{"type":"string"},"type":"array","title":"Sports","default":[]},"Politics":{"items":{"type":"string"},"type":"array","title":"Politics","default":[]},"Title":{"items":{"type":"string"},"type":"array","title":"Title","default":[]},"Number":{"items":{"type":"string"},"type":"array","title":"Number","default":[]},"Arms":{"items":{"type":"string"},"type":"array","title":"Arms","default":[]},"Product":{"items":{"type":"string"},"type":"array","title":"Product","default":[]},"Media":{"items":{"type":"string"},"type":"array","title":"Media","default":[]},"Transportation":{"items":{"type":"string"},"type":"array","title":"Transportation","default":[]},"Religion":{"items":{"type":"string"},"type":"array","title":"Religion","default":[]},"Technology":{"items":{"type":"string"},"type":"array","title":"Technology","default":[]},"Space":{"items":{"type":"string"},"type":"array","title":"Space","default":[]},"Medicine":{"items":{"type":"string"},"type":"array","title":"Medicine","default":[]},"Language":{"items":{"type":"string"},"type":"array","title":"Language","default":[]},"Science":{"items":{"type":"string"},"type":"array","title":"Science","default":[]}},"type":"object","title":"Entities"},"FilterParams":{"properties":{"query":{"type":"string","title":"Query","description":"Query string that can be any phrase, keyword, question, or paragraph. If method='nl', then this will be used as a natural language query. If method='kw', then this will be used as a direct keyword query. This is not required, if it is not passed, then the search is based on the remaining filters only.","default":""},"n_articles":{"type":"integer","title":"N Articles","description":"Number of articles to return","default":10},"start_timestamp":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Start Timestamp","description":"Timestamp to start search from"},"end_timestamp":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"End Timestamp","description":"Timestamp to end search at"},"time_filter":{"type":"string","enum":["crawl_date","pub_date"],"title":"Time Filter","description":"Control which date type to filter on. 'crawl_date' is the date the article was crawled, 'pub_date' is the date the article was published.","default":"crawl_date"},"return_type":{"type":"string","enum":["string","dicts","both"],"title":"Return Type","description":"Type of return value. 'string' means that the return is prompt-optimized and ready to be immediately injected into any prompt. 'dicts' means that the return is a structured dictionary, containing additional metadata (like a classic news api). Can be 'string' or 'dicts', or 'both'. 'string' guarantees the lowest-latency response 'dicts' requires more I/O, therefore increases latency (very slightly, depending on your network connection).","default":"dicts"},"historical":{"type":"boolean","title":"Historical","description":"Search on archive of historical news. Defaults to False, meaning that the search will only look through the most recent news (48 hours)","default":false},"method":{"type":"string","enum":["nl","kw","both"],"title":"Method","description":"Method to use for searching. 'nl' means Natural Language, which is a string that can be any phrase, keyword, question, or paragraph that will be used for semantic search on the news. 'kw' means Keyword, which can also be any keyword(s), phrase, or paragraph, however the search is a direct keyword search on the database. 'both' means both methods will be used and results will be ranked according to IRR. 'both' may reduce latency by 10 pct in exchange  for improved accuracy.","default":"kw"},"similarity_score_threshold":{"type":"number","title":"Similarity Score Threshold","description":"Similarity score threshold to determine which articles to return. Lower means less similar results  are allowed.","default":0.5},"offset":{"anyOf":[{"type":"integer"},{"type":"string"}],"title":"Offset","description":"Offset for pagination. The n_articles is your page size, while your offset is the number of articles to skip to get to your page of interest. For example, if you want to get page 3 for n_article page size of 10, you would set offset to 20.","default":0},"categories":{"items":{"type":"string","enum":["All","Business","Crime","Politics","Science","Sports","Technology","Military","Health","Entertainment","Finance","Culture","Climate","Environment","World"]},"type":"array","title":"Categories","description":"Categories of news to filter on","default":["All"]},"doc_start_delimiter":{"type":"string","title":"Doc Start Delimiter","description":"Document start delimiter for string return.","default":"<doc>"},"doc_end_delimiter":{"type":"string","title":"Doc End Delimiter","description":"Document end delimiter for string return.","default":"</doc>"},"provocative":{"type":"string","enum":["unknown","low","medium","high","all"],"title":"Provocative","description":"Filter articles based on how provocative they are deemed based on the use of provocative language and emotional vocabulary.","default":"all"},"reporting_voice":{"anyOf":[{"items":{"type":"string","enum":["Objective","Subjective","Investigative","Narrative","Analytical","Advocacy","Conversational","Satirical","Emotive","Explanatory","Persuasive","Sensational","Unknown","all"]},"type":"array"},{"type":"string","enum":["Objective","Subjective","Investigative","Narrative","Analytical","Advocacy","Conversational","Satirical","Emotive","Explanatory","Persuasive","Sensational","Unknown","all"]}],"title":"Reporting Voice","description":"Type of reporting voice to filer by.","default":["all"]},"domain_url":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"},{"type":"null"}],"title":"Domain Url","description":"filter by domain url of interest. This can be a single domain or a list of domains. For example, 'npr.org' or ['nature.com', 'npr.org']"},"bad_domain_url":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"},{"type":"null"}],"title":"Bad Domain Url","description":"Domain blacklist.This can be a single domain or a list of domains. For example, 'npr.org' or ['nature.com', 'npr.org']"},"page_rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page Rank","description":"Maximum allowed page rank for returned articles."},"diversify_sources":{"type":"boolean","title":"Diversify Sources","description":"Ensure that the return set of articles are selected from diverse sources. This adds latency to the search, but attempts to balance the representation of sources by country and source origins. In summary, a net is cast around your search, then the diversity of sources is analyzed, and your final result matches the large net diversity distribution. This means that your search accuracy is reduced, but you gain more diverse perspectives.","default":false},"strategy":{"type":"string","enum":["latest news","news knowledge","default"],"title":"Strategy","description":"Strategy to use for searching. 'latest news' automatically setsmethod='nl', historical=False, and looks within the past 24 hours. 'news knowledge' automatically sets method='kw', historical=True, and looks within the past 60 days. 'news knowledge' will increase latency due to the  larger search space in the archive. Use 'default' if you want to control  start_timestamp, end_timestamp, historical, and method.","default":"default"},"hours_back":{"type":"integer","title":"Hours Back","description":"Can be set to easily control the look back on the search. This is the same as controlling the 'start_timestamp' parameter. The difference is that this is not a timestamp, it is the number of hours back to look from the current time. Defaults to 24 hours.","default":24},"string_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"String Guarantee","description":"If defined, the search will only occur on articles that contain strings in this list."},"string_guarantee_op":{"type":"string","enum":["AND","OR"],"title":"String Guarantee Op","description":"Operator to use for string guarantee list.","default":"AND"},"reverse_string_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Reverse String Guarantee","description":"If defined, the search will only occur on articles that do not contain strings in this list."},"entity_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Entity Guarantee","description":"Entity guarantee to filter by. This is a list of strings, where each string includes entity type and entity value separated by a colon. The first element is the entity type and the second element is the entity value. For example ['Location:Paris', 'Person:John']"},"reverse_entity_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Reverse Entity Guarantee","description":"Reverse entity guarantee to filter by. This is a list of strings, where each string includes entity type and entity value separated by a colon. The first element is the entity type and the second element is the entity value. For example ['Location:Paris', 'Person:John']"},"entity_guarantee_op":{"type":"string","enum":["AND","OR"],"title":"Entity Guarantee Op","description":"Operator to use for entity guarantee list.","default":"OR"},"return_graphs":{"type":"boolean","title":"Return Graphs","description":"Return graphs for the articles. Only available to Analyst tier and above.","default":false},"return_geo":{"type":"boolean","title":"Return Geo","description":"Return GeoCoordinates associated with locations discussed  inside the articles. Only available to Analyst tier and above.","default":false},"languages":{"anyOf":[{"items":{"type":"string","enum":["sq","ar","az","ca","zh","hr","cs","da","nl","en","eo","fi","fr","gl","de","el","he","hi","hu","is","id","ia","it","ja","kk","km","ko","ky","ms","mt","mhr","mn","no","or","pl","pt","pa","ro","ru","sr","sk","sl","es","sv","ta","te","th","tr","uk","vi","unknown"]},"type":"array"},{"type":"null"}],"title":"Languages","description":"Languages to filter by. This is the two-letter 'set 1' of the ISO 639-1 standard. For example: English is 'en'."},"countries":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Countries","description":"Countries to filter by, this is the two-letter ISO country codeFor example: United States is 'US', France is 'FR', Sweden is 'SE'."},"countries_blacklist":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Countries Blacklist","description":"Countries to blacklist, this is the two-letter ISO country code. For example: United States is 'US', France is 'FR', Sweden is 'SE'."},"continents":{"anyOf":[{"items":{"type":"string","enum":["Africa","Asia","Oceania","Europe","Middle East","North America","South America"]},"type":"array"},{"type":"null"}],"title":"Continents","description":"Continents to filter by."},"sentiment":{"anyOf":[{"type":"string","enum":["negative","neutral","positive"]},{"type":"null"}],"title":"Sentiment","description":"Sentiment to filter articles by."},"premium":{"type":"boolean","title":"Premium","description":"Include premium sources.","default":false}},"additionalProperties":false,"type":"object","title":"FilterParams"},"FilterParamsMetadata":{"properties":{"title":{"type":"string","title":"Title","default":""}},"type":"object","title":"FilterParamsMetadata"},"FilterParamsResponse":{"properties":{"filter_params":{"$ref":"#/components/schemas/FilterParams"},"metadata":{"$ref":"#/components/schemas/FilterParamsMetadata"}},"type":"object","required":["filter_params","metadata"],"title":"FilterParamsResponse"},"FinanceResponse":{"properties":{"data":{"$ref":"#/components/schemas/FinanceResponseTimeSeries"}},"type":"object","required":["data"],"title":"FinanceResponse"},"FinanceResponseTimeSeries":{"properties":{"timeseries":{"items":{"$ref":"#/components/schemas/FinanceResponseTimeSeriesData"},"type":"array","title":"Timeseries"}},"type":"object","required":["timeseries"],"title":"FinanceResponseTimeSeries"},"FinanceResponseTimeSeriesData":{"properties":{"datetime":{"type":"string","format":"date-time","title":"Datetime"},"value":{"anyOf":[{"type":"integer"},{"type":"number"}],"title":"Value"}},"type":"object","required":["datetime","value"],"title":"FinanceResponseTimeSeriesData"},"ForecastResponse":{"properties":{"forecast":{"type":"string","title":"Forecast"},"resolution_criteria":{"type":"string","title":"Resolution Criteria"},"date":{"type":"string","format":"date-time","title":"Date"},"reasoning":{"type":"string","title":"Reasoning"},"sources":{"items":{"$ref":"#/components/schemas/SearchResponseDictItem"},"type":"array","title":"Sources"},"timeline":{"items":{"type":"string"},"type":"array","title":"Timeline"},"opposite_request":{"type":"string","title":"Opposite Request"},"confidence":{"type":"number","title":"Confidence"},"choice":{"anyOf":[{"type":"boolean"},{"type":"string"}],"title":"Choice"},"llm_confidence":{"type":"integer","title":"Llm Confidence"},"model_used":{"type":"string","title":"Model Used"},"likelihood":{"type":"string","title":"Likelihood"},"probability":{"type":"integer","title":"Probability"},"web_search_results":{"items":{"$ref":"#/components/schemas/WebSearchResult"},"type":"array","title":"Web Search Results"},"summary":{"type":"string","title":"Summary"},"key_people":{"items":{"$ref":"#/components/schemas/KeyPerson"},"type":"array","title":"Key People"},"key_facets":{"items":{"type":"string"},"type":"array","title":"Key Facets"},"reconciled_information":{"type":"string","title":"Reconciled Information"},"candidate_models":{"items":{"type":"string"},"type":"array","title":"Candidate Models"},"unique_information":{"type":"string","title":"Unique Information"},"expert_information":{"additionalProperties":true,"type":"object","title":"Expert Information","default":{}}},"type":"object","required":["forecast","resolution_criteria","date","reasoning","sources","timeline","opposite_request","confidence","choice","llm_confidence","model_used","likelihood","probability","web_search_results","summary","key_people","key_facets","reconciled_information","candidate_models","unique_information"],"title":"ForecastResponse"},"GeoCoordinate":{"properties":{"latitude":{"type":"number","title":"Latitude"},"longitude":{"type":"number","title":"Longitude"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["latitude","longitude","metadata"],"title":"GeoCoordinate"},"GoogleDocsAction":{"properties":{"action":{"type":"string","const":"google_docs","title":"Action","default":"google_docs"},"params":{"$ref":"#/components/schemas/GoogleDocsParams"}},"type":"object","required":["params"],"title":"GoogleDocsAction"},"GoogleDocsParams":{"properties":{"client_json":{"additionalProperties":true,"type":"object","title":"Client Json","description":"The google service account json. This should be a dict. You can get this from the google cloud console. The document will be created in the service account's google drive and shared with the user."},"emails":{"anyOf":[{"items":{"type":"string","format":"email"},"type":"array"},{"type":"null"}],"title":"Emails","description":"The emails to share the doc with"},"asknews_watermark":{"type":"boolean","title":"Asknews Watermark","description":"Append 'Generated by AskNews AI' watermark","default":true}},"type":"object","required":["client_json"],"title":"GoogleDocsParams"},"GraphResponse":{"properties":{"full_graph":{"additionalProperties":true,"type":"object","title":"Full Graph"},"disambiguations":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Disambiguations"},"articles":{"anyOf":[{"items":{"$ref":"#/components/schemas/SearchResponseDictItem"},"type":"array"},{"type":"null"}],"title":"Articles"},"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query"},"docs_enhanced":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Docs Enhanced"},"triples_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Triples Url"},"visualize_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Visualize Url"}},"type":"object","required":["full_graph","disambiguations"],"title":"GraphResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HitShareItem":{"properties":{"domain":{"type":"string","title":"Domain"},"hit_share":{"type":"number","title":"Hit Share"}},"type":"object","required":["domain","hit_share"],"title":"HitShareItem"},"HitShareResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/HitShareItem"},"type":"array","title":"Data"},"total_share":{"type":"number","title":"Total Share"}},"type":"object","required":["data","total_share"],"title":"HitShareResponse"},"IndexCountItem":{"properties":{"start":{"type":"string","format":"date-time","title":"Start"},"end":{"type":"string","format":"date-time","title":"End"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["start","end","count"],"title":"IndexCountItem"},"IndexUrlsResponse":{"properties":{"status":{"type":"string","title":"Status"},"job_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Id"}},"type":"object","required":["status"],"title":"IndexUrlsResponse"},"IntraClusterStatistics":{"properties":{"cluster_articles_pct":{"type":"number","title":"Cluster Articles Pct","default":0},"cluster_countries_pct":{"type":"number","title":"Cluster Countries Pct","default":0},"cluster_domains_pct":{"type":"number","title":"Cluster Domains Pct","default":0},"cluster_languages_pct":{"type":"number","title":"Cluster Languages Pct","default":0},"cluster_probabilities":{"additionalProperties":{"anyOf":[{"type":"integer"},{"type":"number"}]},"type":"object","title":"Cluster Probabilities","default":{}}},"type":"object","title":"IntraClusterStatistics"},"KeyPerson":{"properties":{"name":{"type":"string","title":"Name"},"role":{"type":"string","title":"Role"}},"type":"object","required":["name","role"],"title":"KeyPerson"},"LegacyReportRequest":{"properties":{"logo_url":{"anyOf":[{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},{"type":"null"}],"title":"Logo Url","description":"The logo URL to use for the report"},"include_appendix":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Include Appendix","description":"Whether to append thinking and search traces as an appendix to the report.","default":false},"asknews_watermark":{"type":"boolean","title":"Asknews Watermark","description":"Append 'Generated by AskNews AI' watermark","default":true},"identifier":{"type":"string","const":"legacy","title":"Identifier","default":"legacy"},"model":{"type":"string","enum":["gpt-5","gpt-4o","gpt-4.1-2025-04-14","gpt-4.1-mini-2025-04-14","gpt-4o-mini","o3-mini","claude-3-5-sonnet-latest","claude-sonnet-4-20250514","claude-sonnet-4-5-20250929","claude-opus-4-5-20251101","claude-opus-4-6","claude-fable-5","claude-sonnet-4-6","claude-sonnet-5","claude-opus-4-8","claude-opus-5","gpt-5.6-terra","gpt-5.6-sol","meta-llama/Meta-Llama-3.1-405B-Instruct","meta-llama/Meta-Llama-3.3-70B-Instruct"],"title":"Model","description":"The model to use for the report. Defaults to claude-sonnet-5.","default":"claude-sonnet-5","example":"gpt-4o"}},"type":"object","title":"LegacyReportRequest","description":"DEPRECATED - Use DeepNewsReportRequest instead.\nLegacy report configuration (original format).\n\nThis is the original ReportRequest format that uses a simple model field\nfor report generation without DeepNews capabilities."},"ListDeepNewsModelResponse":{"properties":{"models":{"items":{"$ref":"#/components/schemas/DeepNewsModelItem"},"type":"array","title":"Models"}},"type":"object","required":["models"],"title":"ListDeepNewsModelResponse"},"MCPFilterParams":{"properties":{"query":{"type":"string","title":"Query","description":"Query string that can be any phrase, keyword, question, or paragraph. If method='nl', then this will be used as a natural language query. If method='kw', then this will be used as a direct keyword query. This is not required, if it is not passed, then the search is based on the remaining filters only.","default":""},"n_articles":{"type":"integer","title":"N Articles","description":"Number of articles to return","default":10},"start_timestamp":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Start Timestamp","description":"Timestamp to start search from"},"end_timestamp":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"End Timestamp","description":"Timestamp to end search at"},"time_filter":{"type":"string","enum":["crawl_date","pub_date"],"title":"Time Filter","description":"Control which date type to filter on. 'crawl_date' is the date the article was crawled, 'pub_date' is the date the article was published.","default":"crawl_date"},"offset":{"anyOf":[{"type":"integer"},{"type":"string"}],"title":"Offset","description":"The number of results to offset for followup queries. Use for pagination. The value to put here is returned in the response.offset from previous searches.","default":0},"categories":{"items":{"type":"string","enum":["All","Business","Crime","Politics","Science","Sports","Technology","Military","Health","Entertainment","Finance","Culture","Climate","Environment","World"]},"type":"array","title":"Categories","description":"Categories of news to filter on","default":["All"]},"provocative":{"type":"string","enum":["unknown","low","medium","high","all"],"title":"Provocative","description":"Filter articles based on how provocative they are deemed based on the use of provocative language and emotional vocabulary.","default":"all"},"authors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Authors","description":"Authors to filter articles by."},"reporting_voice":{"anyOf":[{"items":{"type":"string","enum":["Objective","Subjective","Investigative","Narrative","Analytical","Advocacy","Conversational","Satirical","Emotive","Explanatory","Persuasive","Sensational","Unknown","all"]},"type":"array"},{"type":"string","enum":["Objective","Subjective","Investigative","Narrative","Analytical","Advocacy","Conversational","Satirical","Emotive","Explanatory","Persuasive","Sensational","Unknown","all"]}],"title":"Reporting Voice","description":"Type of reporting voice to filer by.","default":["all"]},"domain_url":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"},{"type":"null"}],"title":"Domain Url","description":"filter by domain url of interest. This can be a single domain or a list of domains. For example, 'npr.org' or ['nature.com', 'npr.org']"},"bad_domain_url":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"},{"type":"null"}],"title":"Bad Domain Url","description":"Domain blacklist.This can be a single domain or a list of domains. For example, 'npr.org' or ['nature.com', 'npr.org']"},"page_rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page Rank","description":"Maximum allowed page rank for returned articles."},"hours_back":{"type":"integer","title":"Hours Back","description":"Can be set to easily control the look back on the search. This is the same as controlling the 'start_timestamp' parameter. The difference is that this is not a timestamp, it is the number of hours back to look from the current time. Defaults to 24 hours.","default":24},"string_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"String Guarantee","description":"If defined, the search will only occur on articles that contain strings in this list."},"string_guarantee_op":{"type":"string","enum":["AND","OR"],"title":"String Guarantee Op","description":"Operator to use for string guarantee list.","default":"AND"},"reverse_string_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Reverse String Guarantee","description":"If defined, the search will only occur on articles that do not contain strings in this list."},"entity_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Entity Guarantee","description":"Entity guarantee to filter by. This is a list of strings, where each string includes entity type and entity value separated by a colon. The first element is the entity type and the second element is the entity value. For example ['Location:Paris', 'Person:John']"},"reverse_entity_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Reverse Entity Guarantee","description":"Reverse entity guarantee to filter by. This is a list of strings, where each string includes entity type and entity value separated by a colon. The first element is the entity type and the second element is the entity value. For example ['Location:Paris', 'Person:John']"},"entity_guarantee_op":{"type":"string","enum":["AND","OR"],"title":"Entity Guarantee Op","description":"Operator to use for entity guarantee list.","default":"OR"},"languages":{"anyOf":[{"items":{"type":"string","enum":["sq","ar","az","ca","zh","hr","cs","da","nl","en","eo","fi","fr","gl","de","el","he","hi","hu","is","id","ia","it","ja","kk","km","ko","ky","ms","mt","mhr","mn","no","or","pl","pt","pa","ro","ru","sr","sk","sl","es","sv","ta","te","th","tr","uk","vi","unknown"]},"type":"array"},{"type":"null"}],"title":"Languages","description":"Languages to filter by. This is the two-letter 'set 1' of the ISO 639-1 standard. For example: English is 'en'."},"countries":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Countries","description":"Countries to filter by, this is the two-letter ISO country codeFor example: United States is 'US', France is 'FR', Sweden is 'SE'."},"countries_blacklist":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Countries Blacklist","description":"Countries to blacklist, this is the two-letter ISO country code. For example: United States is 'US', France is 'FR', Sweden is 'SE'."},"continents":{"anyOf":[{"items":{"type":"string","enum":["Africa","Asia","Oceania","Europe","Middle East","North America","South America"]},"type":"array"},{"type":"null"}],"title":"Continents","description":"Continents to filter by."},"sentiment":{"anyOf":[{"type":"string","enum":["negative","neutral","positive"]},{"type":"null"}],"title":"Sentiment","description":"Sentiment to filter articles by."}},"type":"object","title":"MCPFilterParams"},"MessageStartEvent":{"properties":{"type":{"type":"string","const":"message_start","title":"Type","default":"message_start"},"role":{"type":"string","const":"assistant","title":"Role","default":"assistant"}},"type":"object","title":"MessageStartEvent"},"MessageStopEvent":{"properties":{"type":{"type":"string","const":"message_stop","title":"Type","default":"message_stop"}},"type":"object","title":"MessageStopEvent"},"NewsletterContactCreateResponse":{"properties":{"id":{"type":"string","title":"Id"}},"type":"object","required":["id"],"title":"NewsletterContactCreateResponse"},"NewsletterContactRequest":{"properties":{"email":{"type":"string","title":"Email"},"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Name"},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Name"},"unsubscribed":{"type":"boolean","title":"Unsubscribed","default":false}},"type":"object","required":["email"],"title":"NewsletterContactRequest"},"NewsletterContactResponse":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","title":"Email"},"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Name"},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Name"},"created_at":{"type":"string","title":"Created At"},"unsubscribed":{"type":"boolean","title":"Unsubscribed"}},"type":"object","required":["id","email","created_at","unsubscribed"],"title":"NewsletterContactResponse"},"NewsletterContactUpdateResponse":{"properties":{"id":{"type":"string","title":"Id"}},"type":"object","required":["id"],"title":"NewsletterContactUpdateResponse"},"NewsletterPublicResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"query":{"type":"string","title":"Query"}},"type":"object","required":["id","name","query"],"title":"NewsletterPublicResponse"},"NewsletterResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"alert_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Alert Id"},"name":{"type":"string","title":"Name"},"query":{"type":"string","title":"Query"},"cron":{"type":"string","title":"Cron"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"subject":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subject"},"sender":{"type":"string","title":"Sender"},"logo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Url"},"reply_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reply To"},"audience_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Audience Id"},"resend_api_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resend Api Key"},"public":{"type":"boolean","title":"Public","default":true},"active":{"type":"boolean","title":"Active","default":true},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"}},"type":"object","required":["id","user_id","name","query","cron","model","subject","sender","logo_url","reply_to","audience_id","resend_api_key"],"title":"NewsletterResponse"},"OrganizationProfile":{"properties":{"identity_type":{"type":"string","const":"organization","title":"Identity Type","default":"organization"},"id":{"type":"string","title":"Id"},"subscription":{"$ref":"#/components/schemas/OrganizationProfileSubscription"}},"type":"object","required":["id","subscription"],"title":"OrganizationProfile"},"OrganizationProfileSubscription":{"properties":{"status":{"type":"string","title":"Status"},"plan":{"type":"string","title":"Plan"},"period_start":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Period Start"},"period_end":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Period End"}},"type":"object","required":["status","plan"],"title":"OrganizationProfileSubscription"},"PaginatedResponse_AlertLog_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/AlertLog"},"type":"array","title":"Items"},"count":{"type":"integer","title":"Count"},"next_page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Next Page"},"previous_page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Previous Page"}},"type":"object","required":["items","count","next_page","previous_page"],"title":"PaginatedResponse[AlertLog]"},"PaginatedResponse_AlertResponse_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/AlertResponse"},"type":"array","title":"Items"},"count":{"type":"integer","title":"Count"},"next_page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Next Page"},"previous_page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Previous Page"}},"type":"object","required":["items","count","next_page","previous_page"],"title":"PaginatedResponse[AlertResponse]"},"PaginatedResponse_NewsletterPublicResponse_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/NewsletterPublicResponse"},"type":"array","title":"Items"},"count":{"type":"integer","title":"Count"},"next_page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Next Page"},"previous_page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Previous Page"}},"type":"object","required":["items","count","next_page","previous_page"],"title":"PaginatedResponse[NewsletterPublicResponse]"},"PaginatedResponse_NewsletterResponse_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/NewsletterResponse"},"type":"array","title":"Items"},"count":{"type":"integer","title":"Count"},"next_page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Next Page"},"previous_page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Previous Page"}},"type":"object","required":["items","count","next_page","previous_page"],"title":"PaginatedResponse[NewsletterResponse]"},"PaginatedResponse_ReadDomainResponse_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ReadDomainResponse"},"type":"array","title":"Items"},"count":{"type":"integer","title":"Count"},"next_page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Next Page"},"previous_page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Previous Page"}},"type":"object","required":["items","count","next_page","previous_page"],"title":"PaginatedResponse[ReadDomainResponse]"},"PingModel":{"properties":{"app":{"type":"string","title":"App"},"version":{"type":"string","title":"Version"}},"type":"object","required":["app","version"],"title":"PingModel"},"ProfileResponse":{"properties":{"profile":{"oneOf":[{"$ref":"#/components/schemas/UserProfile"},{"$ref":"#/components/schemas/OrganizationProfile"}],"title":"Profile","discriminator":{"propertyName":"identity_type","mapping":{"organization":"#/components/schemas/OrganizationProfile","user":"#/components/schemas/UserProfile"}}}},"type":"object","required":["profile"],"title":"ProfileResponse"},"RateLimitStatusResponse":{"properties":{"request_rate":{"type":"number","title":"Request Rate","description":"Configured requests replenished per second"},"request_rate_capacity":{"type":"number","title":"Request Rate Capacity","description":"Maximum burst token capacity"},"request_rate_remaining":{"type":"number","title":"Request Rate Remaining","description":"Effective available requests right now (accounts for time elapsed since last request)"},"retry_after":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Retry After","description":"Seconds until the next request will be allowed; null if not currently rate-limited"},"concurrency_limit":{"type":"integer","title":"Concurrency Limit","description":"Maximum allowed concurrent requests"},"concurrency_remaining":{"type":"integer","title":"Concurrency Remaining","description":"Available concurrent request slots right now"},"deepnews_request_rate":{"type":"number","title":"Deepnews Request Rate","description":"Configured deepnews requests replenished per second"},"deepnews_request_rate_capacity":{"type":"number","title":"Deepnews Request Rate Capacity","description":"Maximum deepnews burst token capacity"},"deepnews_request_rate_remaining":{"type":"number","title":"Deepnews Request Rate Remaining","description":"Effective available deepnews requests right now (accounts for time elapsed since last request)"},"deepnews_retry_after":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Deepnews Retry After","description":"Seconds until the next deepnews request will be allowed; null if not currently rate-limited"},"deepnews_concurrency_limit":{"type":"integer","title":"Deepnews Concurrency Limit","description":"Maximum allowed concurrent deepnews requests"},"deepnews_concurrency_remaining":{"type":"integer","title":"Deepnews Concurrency Remaining","description":"Available concurrent deepnews request slots right now"}},"type":"object","required":["request_rate","request_rate_capacity","request_rate_remaining","concurrency_limit","concurrency_remaining","deepnews_request_rate","deepnews_request_rate_capacity","deepnews_request_rate_remaining","deepnews_concurrency_limit","deepnews_concurrency_remaining"],"title":"RateLimitStatusResponse"},"ReadDomainResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"owner":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Owner"},"is_tollbit":{"type":"boolean","title":"Is Tollbit","default":false},"publisher":{"type":"boolean","title":"Publisher","default":false},"full_text":{"type":"boolean","title":"Full Text","default":true},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","name","created_at"],"title":"ReadDomainResponse"},"RedditComment":{"properties":{"author":{"type":"string","title":"Author"},"body":{"type":"string","title":"Body"},"date":{"type":"string","format":"date-time","title":"Date"},"upvotes":{"type":"integer","title":"Upvotes"}},"type":"object","required":["author","body","date","upvotes"],"title":"RedditComment"},"RedditEntities":{"properties":{"DATE":{"items":{"type":"string"},"type":"array","title":"Date","default":[]},"EVENT":{"items":{"type":"string"},"type":"array","title":"Event","default":[]},"GPE":{"items":{"type":"string"},"type":"array","title":"Gpe","default":[]},"ORG":{"items":{"type":"string"},"type":"array","title":"Org","default":[]},"PERSON":{"items":{"type":"string"},"type":"array","title":"Person","default":[]},"NORP":{"items":{"type":"string"},"type":"array","title":"Norp","default":[]},"CARDINAL":{"items":{"type":"string"},"type":"array","title":"Cardinal","default":[]}},"type":"object","title":"RedditEntities"},"RedditPerspective":{"properties":{"sentiment":{"anyOf":[{"type":"integer"},{"type":"number"}],"title":"Sentiment"},"relevant":{"type":"boolean","title":"Relevant"},"summary":{"type":"string","title":"Summary"}},"type":"object","required":["sentiment","relevant","summary"],"title":"RedditPerspective"},"RedditResponse":{"properties":{"as_dicts":{"anyOf":[{"items":{"$ref":"#/components/schemas/RedditThread"},"type":"array"},{"type":"null"}],"title":"As Dicts"},"as_string":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"As String"}},"type":"object","title":"RedditResponse"},"RedditThread":{"properties":{"author":{"type":"string","title":"Author"},"author_comment_karma":{"type":"integer","title":"Author Comment Karma"},"author_link_karma":{"type":"integer","title":"Author Link Karma"},"body":{"type":"string","title":"Body"},"classification":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"title":"Classification"},"comments":{"items":{"$ref":"#/components/schemas/RedditComment"},"type":"array","title":"Comments"},"comments_count":{"type":"integer","title":"Comments Count"},"date":{"type":"string","format":"date-time","title":"Date"},"entities":{"$ref":"#/components/schemas/RedditEntities"},"id":{"type":"string","format":"uuid","title":"Id"},"key_takeaways":{"items":{"type":"string"},"type":"array","title":"Key Takeaways","default":[]},"keywords":{"items":{"type":"string"},"type":"array","title":"Keywords"},"sentiment":{"anyOf":[{"type":"integer"},{"type":"number"}],"title":"Sentiment"},"subreddit_name":{"type":"string","title":"Subreddit Name"},"subreddit_url":{"type":"string","title":"Subreddit Url"},"summary":{"type":"string","title":"Summary"},"title":{"type":"string","title":"Title"},"topic":{"type":"string","title":"Topic"},"upvotes":{"type":"integer","title":"Upvotes"},"url":{"type":"string","title":"Url"},"main_speculation":{"type":"string","title":"Main Speculation","default":""}},"type":"object","required":["author","author_comment_karma","author_link_karma","body","classification","comments","comments_count","date","entities","id","keywords","sentiment","subreddit_name","subreddit_url","summary","title","topic","upvotes","url"],"title":"RedditThread"},"ReferralItem":{"properties":{"site":{"type":"string","title":"Site"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["site","count"],"title":"ReferralItem"},"ResendBroadcastAction":{"properties":{"action":{"type":"string","const":"resend_broadcast","title":"Action","default":"resend_broadcast"},"params":{"$ref":"#/components/schemas/ResendBroadcastParams"}},"type":"object","required":["params"],"title":"ResendBroadcastAction"},"ResendBroadcastParams":{"properties":{"sender":{"type":"string","title":"Sender","description":"The sender email address, use the format: Your Name <sender@domain.com>"},"reply_to":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Reply To","description":"The reply to email address. For multiple addresses, send as a list of strings"},"subject":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subject","description":"The subject of the email. If not provided, the default subject will be used."},"audience_id":{"type":"string","title":"Audience Id","description":"The audience id that the broadcast will be sent to"},"resend_api_key":{"type":"string","title":"Resend Api Key","description":"Resend API key to use"},"asknews_watermark":{"type":"boolean","title":"Asknews Watermark","description":"Append 'Generated by AskNews AI' watermark","default":true}},"type":"object","required":["sender","audience_id","resend_api_key"],"title":"ResendBroadcastParams"},"ScrapeDataItem":{"properties":{"scrapes":{"items":{"$ref":"#/components/schemas/ScrapeItem"},"type":"array","title":"Scrapes"},"referrals":{"items":{"$ref":"#/components/schemas/ReferralItem"},"type":"array","title":"Referrals"}},"type":"object","required":["scrapes","referrals"],"title":"ScrapeDataItem"},"ScrapeItem":{"properties":{"user_agent":{"type":"string","title":"User Agent"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["user_agent","count"],"title":"ScrapeItem"},"ScrapedURLItem":{"properties":{"url":{"type":"string","title":"Url"},"data":{"anyOf":[{"$ref":"#/components/schemas/ScrapeDataItem"},{"type":"null"}]},"skip_dedupe":{"type":"boolean","title":"Skip Dedupe","default":false},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"},"enrichments":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Enrichments"}},"type":"object","required":["url"],"title":"ScrapedURLItem"},"SearchResponse":{"properties":{"as_dicts":{"anyOf":[{"items":{"$ref":"#/components/schemas/SearchResponseDictItem"},"type":"array"},{"type":"null"}],"title":"As Dicts"},"as_string":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"As String"},"offset":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Offset"},"usage":{"anyOf":[{"$ref":"#/components/schemas/Usage"},{"type":"null"}]}},"type":"object","title":"SearchResponse"},"SearchResponseDictItem":{"properties":{"article_url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Article Url"},"article_id":{"type":"string","format":"uuid","title":"Article Id"},"classification":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"title":"Classification"},"country":{"type":"string","title":"Country"},"source_id":{"type":"string","title":"Source Id"},"page_rank":{"type":"integer","title":"Page Rank"},"domain_url":{"type":"string","title":"Domain Url"},"eng_title":{"type":"string","title":"Eng Title"},"entities":{"$ref":"#/components/schemas/Entities"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url"},"keywords":{"items":{"type":"string"},"type":"array","title":"Keywords"},"language":{"type":"string","title":"Language"},"pub_date":{"type":"string","format":"date-time","title":"Pub Date"},"summary":{"type":"string","title":"Summary"},"key_points":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Key Points"},"title":{"type":"string","title":"Title"},"sentiment":{"type":"integer","title":"Sentiment"},"centroid_distance":{"type":"number","title":"Centroid Distance"},"cluster_probability":{"type":"number","title":"Cluster Probability"},"markdown_citation":{"type":"string","title":"Markdown Citation","default":""},"provocative":{"type":"string","enum":["unknown","low","medium","high"],"title":"Provocative","default":"unknown"},"reporting_voice":{"anyOf":[{"type":"string","enum":["Objective","Subjective","Investigative","Narrative","Analytical","Advocacy","Conversational","Satirical","Emotive","Explanatory","UnknownPersuasive","Sensational"]},{"type":"string"}],"title":"Reporting Voice","default":"Unknown"},"entity_relation_graph":{"anyOf":[{"$ref":"#/components/schemas/asknews_api__schema__v1__common__GraphRelationships"},{"type":"null"}]},"geo_coordinates":{"anyOf":[{"additionalProperties":{"$ref":"#/components/schemas/GeoCoordinate"},"type":"object"},{"type":"null"}],"title":"Geo Coordinates"},"continent":{"anyOf":[{"type":"string","enum":["Africa","Asia","Europe","Middle East","North America","South America","Oceania"]},{"type":"null"}],"title":"Continent"},"assets":{"anyOf":[{"$ref":"#/components/schemas/Assets"},{"type":"null"}]},"social_embeds":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Social Embeds"},"bias":{"anyOf":[{"type":"string","enum":["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"]},{"type":"null"}],"title":"Bias"},"authors":{"anyOf":[{"items":{"$ref":"#/components/schemas/Author"},"type":"array"},{"type":"null"}],"title":"Authors"},"full_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Full Text"},"original_language_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Original Language Summary"},"image_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Description"},"crawl_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Crawl Date"},"content_type":{"anyOf":[{"type":"string","enum":["news","opinion","analysis","review","listicle","guide","interview","profile","forum","liveblog","fact-check","press_release","obituary","data_journalism"]},{"type":"null"}],"title":"Content Type"},"as_string_key":{"type":"string","title":"As String Key"}},"type":"object","required":["article_url","article_id","classification","country","source_id","page_rank","domain_url","eng_title","entities","keywords","language","pub_date","summary","title","sentiment","centroid_distance","cluster_probability","as_string_key"],"title":"SearchResponseDictItem"},"SeriesConfig":{"properties":{"name":{"type":"string","title":"Name"},"start_datetime":{"type":"string","format":"date-time","title":"Start Datetime"},"end_datetime":{"type":"string","format":"date-time","title":"End Datetime"},"sampling":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sampling","default":"1d"},"time_filter":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time Filter","default":"pub_date"},"categories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Categories"},"domains":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Domains"},"bad_domain_url":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Bad Domain Url"},"page_rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page Rank"},"string_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"String Guarantee"},"string_guarantee_op":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"String Guarantee Op","default":"OR"},"reverse_string_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Reverse String Guarantee"},"entity_guarantee":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Entity Guarantee"},"entity_guarantee_op":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Guarantee Op","default":"OR"},"countries":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Countries"},"countries_blacklist":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Countries Blacklist"},"continents":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Continents"},"languages":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Languages"},"sentiment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sentiment"},"reporting_voice":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Reporting Voice"},"provocative":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provocative","default":"all"}},"type":"object","required":["name","start_datetime","end_datetime"],"title":"SeriesConfig"},"SourceReportItem":{"properties":{"bson_date":{"type":"string","format":"date-time","title":"Bson Date"},"n_bucket":{"type":"integer","title":"N Bucket"},"n_selected":{"type":"integer","title":"N Selected"},"bucket_counts":{"additionalProperties":{"type":"integer"},"type":"object","title":"Bucket Counts"},"selected_counts":{"additionalProperties":{"type":"integer"},"type":"object","title":"Selected Counts"},"bucket_pct":{"additionalProperties":{"type":"number"},"type":"object","title":"Bucket Pct"},"selected_pct":{"additionalProperties":{"type":"number"},"type":"object","title":"Selected Pct"}},"type":"object","required":["bson_date","n_bucket","n_selected","bucket_counts","selected_counts","bucket_pct","selected_pct"],"title":"SourceReportItem"},"SourceReportResponse":{"items":{"$ref":"#/components/schemas/SourceReportItem"},"type":"array","title":"SourceReportResponse"},"Sources":{"items":{"oneOf":[{"$ref":"#/components/schemas/AskNewsSource"},{"$ref":"#/components/schemas/TelegramSource"},{"$ref":"#/components/schemas/BlueskySource"},{"$ref":"#/components/schemas/WebSource"},{"$ref":"#/components/schemas/DeepNewsSource"}],"discriminator":{"propertyName":"identifier","mapping":{"asknews":"#/components/schemas/AskNewsSource","bluesky":"#/components/schemas/BlueskySource","deepnews":"#/components/schemas/DeepNewsSource","telegram":"#/components/schemas/TelegramSource","web":"#/components/schemas/WebSource"}}},"type":"array","title":"Sources"},"StoriesResponse":{"properties":{"stories":{"items":{"$ref":"#/components/schemas/StoryResponse"},"type":"array","title":"Stories"},"offset":{"anyOf":[{"type":"integer"},{"type":"string"}],"title":"Offset"}},"type":"object","required":["stories","offset"],"title":"StoriesResponse"},"StoryResponse":{"properties":{"uuid":{"type":"string","format":"uuid","title":"Uuid"},"categories":{"items":{"type":"string"},"type":"array","title":"Categories"},"countries":{"additionalProperties":{"type":"integer"},"type":"object","title":"Countries"},"countries_pct":{"additionalProperties":{"type":"number"},"type":"object","title":"Countries Pct"},"current_update_uuid":{"type":"string","title":"Current Update Uuid"},"requested_update_uuid":{"type":"string","title":"Requested Update Uuid"},"generate_image":{"type":"boolean","title":"Generate Image"},"keywords":{"items":{"type":"string"},"type":"array","title":"Keywords"},"languages":{"additionalProperties":{"type":"integer"},"type":"object","title":"Languages"},"languages_pct":{"additionalProperties":{"type":"number"},"type":"object","title":"Languages Pct"},"locations":{"items":{"type":"string"},"type":"array","title":"Locations"},"meta_type":{"type":"string","title":"Meta Type"},"n_articles":{"items":{"type":"integer"},"type":"array","title":"N Articles"},"n_updates":{"type":"integer","title":"N Updates"},"people":{"items":{"type":"string"},"type":"array","title":"People"},"reddit_sentiment":{"items":{"anyOf":[{"type":"integer"},{"type":"number"}]},"type":"array","title":"Reddit Sentiment"},"reddit_sentiment_timestamps":{"items":{"type":"integer"},"type":"array","title":"Reddit Sentiment Timestamps"},"rolling_sentiment":{"items":{"type":"number"},"type":"array","title":"Rolling Sentiment"},"sentiment":{"items":{"type":"integer"},"type":"array","title":"Sentiment"},"sentiment_timestamps":{"items":{"type":"integer"},"type":"array","title":"Sentiment Timestamps"},"sources":{"additionalProperties":{"type":"integer"},"type":"object","title":"Sources"},"sources_urls":{"additionalProperties":{"type":"integer"},"type":"object","title":"Sources Urls"},"topic":{"type":"string","title":"Topic"},"topics":{"items":{"type":"string"},"type":"array","title":"Topics"},"updates":{"items":{"$ref":"#/components/schemas/StoryUpdate"},"type":"array","title":"Updates"},"updated_ts":{"type":"integer","title":"Updated Ts"},"update_uuids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Update Uuids"}},"type":"object","required":["uuid","categories","countries","countries_pct","current_update_uuid","requested_update_uuid","generate_image","keywords","languages","languages_pct","locations","meta_type","n_articles","n_updates","people","reddit_sentiment","reddit_sentiment_timestamps","rolling_sentiment","sentiment","sentiment_timestamps","sources","sources_urls","topic","topics","updates","updated_ts","update_uuids"],"title":"StoryResponse"},"StoryUpdate":{"properties":{"uuid":{"type":"string","format":"uuid","title":"Uuid"},"cluster_articles":{"items":{"$ref":"#/components/schemas/Article"},"type":"array","title":"Cluster Articles"},"prompt_articles":{"items":{"$ref":"#/components/schemas/Article"},"type":"array","title":"Prompt Articles"},"n_articles":{"type":"integer","title":"N Articles"},"entities":{"$ref":"#/components/schemas/Entities"},"headline":{"type":"string","title":"Headline"},"story":{"type":"string","title":"Story"},"story_update_ts":{"type":"integer","title":"Story Update Ts"},"sources_urls":{"additionalProperties":{"type":"integer"},"type":"object","title":"Sources Urls"},"languages_pct":{"additionalProperties":{"type":"number"},"type":"object","title":"Languages Pct"},"countries_pct":{"additionalProperties":{"type":"number"},"type":"object","title":"Countries Pct"},"key_takeaways":{"items":{"type":"string"},"type":"array","title":"Key Takeaways"},"contradictions":{"items":{"type":"string"},"type":"array","title":"Contradictions"},"continent":{"type":"string","title":"Continent"},"people":{"items":{"type":"string"},"type":"array","title":"People"},"locations":{"items":{"type":"string"},"type":"array","title":"Locations"},"new_information":{"type":"string","title":"New Information"},"image_url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Image Url"},"url_safe_title":{"type":"string","title":"Url Safe Title"},"story_uuid":{"type":"string","format":"uuid","title":"Story Uuid"},"categories":{"items":{"type":"string"},"type":"array","title":"Categories"},"image_prompt":{"type":"string","title":"Image Prompt"},"reddit_perspective":{"$ref":"#/components/schemas/RedditPerspective"},"reddit_threads":{"items":{"$ref":"#/components/schemas/RedditThread"},"type":"array","title":"Reddit Threads"},"languages":{"additionalProperties":{"type":"integer"},"type":"object","title":"Languages"},"keywords":{"items":{"type":"string"},"type":"array","title":"Keywords"},"intra_cluster_statistics":{"$ref":"#/components/schemas/IntraClusterStatistics"},"silhouette_score":{"additionalProperties":true,"type":"object","title":"Silhouette Score"},"article_ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Article Ids"},"countries":{"additionalProperties":{"type":"integer"},"type":"object","title":"Countries"},"markdown_citations":{"items":{"type":"string"},"type":"array","title":"Markdown Citations"},"confidence":{"type":"number","title":"Confidence","default":0},"provocative":{"type":"string","enum":["unknown","low","medium","high"],"title":"Provocative","default":"unknown"},"reporting_voice":{"type":"string","title":"Reporting Voice","default":"Reporting voice unknown."},"relationships":{"$ref":"#/components/schemas/asknews_api__schema__v1__stories__GraphRelationships"},"mermaid":{"type":"string","title":"Mermaid"},"cc_image_url":{"type":"string","title":"Cc Image Url"},"display_image_urls":{"items":{"anyOf":[{"$ref":"#/components/schemas/DisplayImageUrl"},{"type":"string"}]},"type":"array","title":"Display Image Urls"},"alignment":{"type":"integer","title":"Alignment","default":0}},"type":"object","required":["uuid","cluster_articles","prompt_articles","n_articles","entities","headline","story","story_update_ts","sources_urls","languages_pct","countries_pct","key_takeaways","contradictions","continent","people","locations","new_information","image_url","url_safe_title","story_uuid","categories","image_prompt","reddit_perspective","reddit_threads","languages","keywords","intra_cluster_statistics","silhouette_score","article_ids","countries","markdown_citations","relationships","mermaid","cc_image_url","display_image_urls"],"title":"StoryUpdate"},"TelegramSource":{"properties":{"identifier":{"type":"string","const":"telegram","title":"Identifier","default":"telegram"},"params":{"$ref":"#/components/schemas/TelegramSourceParams"}},"type":"object","required":["params"],"title":"TelegramSource"},"TelegramSourceParams":{"properties":{"channel_name":{"type":"string","title":"Channel Name","description":"The channel name to use as a source"}},"type":"object","required":["channel_name"],"title":"TelegramSourceParams"},"TopNArticlesByHitsItem":{"properties":{"article_url":{"type":"string","title":"Article Url"},"hit_count":{"type":"integer","title":"Hit Count"}},"type":"object","required":["article_url","hit_count"],"title":"TopNArticlesByHitsItem"},"TopNArticlesByHitsResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/TopNArticlesByHitsItem"},"type":"array","title":"Data"},"total_count":{"type":"integer","title":"Total Count"},"page":{"type":"integer","title":"Page","default":1},"next_page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Next Page"}},"type":"object","required":["data","total_count"],"title":"TopNArticlesByHitsResponse"},"TopNArticlesForDomainItem":{"properties":{"article_url":{"type":"string","title":"Article Url"},"article_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Article Id"},"hit_count":{"type":"integer","title":"Hit Count"}},"type":"object","required":["article_url","hit_count"],"title":"TopNArticlesForDomainItem"},"TopNArticlesForDomainResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/TopNArticlesForDomainItem"},"type":"array","title":"Data"},"total_count":{"type":"integer","title":"Total Count"},"page":{"type":"integer","title":"Page","default":1},"next_page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Next Page"}},"type":"object","required":["data","total_count"],"title":"TopNArticlesForDomainResponse"},"TopNArticlesTimeseriesDayItem":{"properties":{"day":{"type":"string","title":"Day"},"articles":{"items":{"$ref":"#/components/schemas/TopNArticlesTimeseriesItem"},"type":"array","title":"Articles"},"total_count":{"type":"integer","title":"Total Count"}},"type":"object","required":["day","articles","total_count"],"title":"TopNArticlesTimeseriesDayItem"},"TopNArticlesTimeseriesItem":{"properties":{"article_url":{"type":"string","title":"Article Url"},"article_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Article Id"},"hit_count":{"type":"integer","title":"Hit Count"}},"type":"object","required":["article_url","hit_count"],"title":"TopNArticlesTimeseriesItem"},"TopNArticlesTimeseriesResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/TopNArticlesTimeseriesDayItem"},"type":"array","title":"Data"},"total_count":{"type":"integer","title":"Total Count"}},"type":"object","required":["data","total_count"],"title":"TopNArticlesTimeseriesResponse"},"TopNDomainsByHitsItem":{"properties":{"domain":{"type":"string","title":"Domain"},"hit_count":{"type":"integer","title":"Hit Count"}},"type":"object","required":["domain","hit_count"],"title":"TopNDomainsByHitsItem"},"TopNDomainsByHitsResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/TopNDomainsByHitsItem"},"type":"array","title":"Data"},"total_count":{"type":"integer","title":"Total Count"}},"type":"object","required":["data","total_count"],"title":"TopNDomainsByHitsResponse"},"Triggers":{"items":{"oneOf":[{"$ref":"#/components/schemas/WebhookAction"},{"$ref":"#/components/schemas/EmailAction"},{"$ref":"#/components/schemas/ResendBroadcastAction"},{"$ref":"#/components/schemas/GoogleDocsAction"}],"discriminator":{"propertyName":"action","mapping":{"email":"#/components/schemas/EmailAction","google_docs":"#/components/schemas/GoogleDocsAction","resend_broadcast":"#/components/schemas/ResendBroadcastAction","webhook":"#/components/schemas/WebhookAction"}}},"type":"array","title":"Triggers"},"URLIndexingRequest":{"properties":{"start_time":{"type":"string","format":"date-time","title":"Start Time"},"end_time":{"type":"string","format":"date-time","title":"End Time"},"urls":{"items":{"$ref":"#/components/schemas/ScrapedURLItem"},"type":"array","title":"Urls"}},"type":"object","required":["start_time","end_time","urls"],"title":"URLIndexingRequest"},"UpdateAlertRequest":{"properties":{"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query","description":"The query to run for retrieving information from sources, and for checking the alert. If you have defined one or more reports, specify each report's individual query in the report prompt.","example":"I want to be alerted if the president of the US says something about the economy"},"sources":{"anyOf":[{"$ref":"#/components/schemas/Sources"},{"type":"null"}],"description":"The sources to use for retrieving information related to the alert query. Available sources are: AskNewsSource, TelegramSource, BlueskySource, WebSource, DeepNewsSource"},"alert_type":{"anyOf":[{"type":"string","enum":["AlwaysAlertWhen","AlertOnceIf","ReportAbout"]},{"type":"null"}],"title":"Alert Type","description":"The type of alert. If specified, overrides `repeat` and `always_trigger`. 'AlwaysAlertWhen': trigger alert actions any time the alert query is satisfied (`repeat=True`, `always_trigger=False`). Add Report model if you want a report when this is triggered. 'AlertOnceIf': trigger alert actions when the alert query is satisfied and then disable the alert (`repeat=False`, `always_trigger=False`). Add Report model if you want a report when this is triggered. 'ReportAbout': always trigger alert actions according to cron schedule and write a report (`repeat=True`, `always_trigger=True`). Defaults to using DeepNews for the report unless specified.","example":""},"model":{"anyOf":[{"type":"string","enum":["meta-llama/Meta-Llama-3.1-8B-Instruct","gpt-4o-mini","gpt-5-mini","gpt-5-nano","gpt-4o","o3-mini","meta-llama/Meta-Llama-3.3-70B-Instruct","gpt-4.1-2025-04-14","gpt-4.1-nano-2025-04-14","gpt-4.1-mini-2025-04-14","claude-sonnet-5"]},{"type":"null"}],"title":"Model","description":"The model that is used to check if the alert conditions are satisfied by sources (this is not the same as the model used to write the report.)","example":"gpt-4o-mini"},"cron":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cron","description":"How often or when to check sources for this alert, specified as a cron expression. Examples: '0 * * * *' (hourly), '0 9 * * *' (daily at 9am), '0 9 * * 1' (Mondays at 9am).  See https://crontab.run/ for more examples.","example":"'0 0 * * *' (daily at midnight UTC)"},"triggers":{"anyOf":[{"$ref":"#/components/schemas/Triggers"},{"type":"null"}],"description":"Configuration for actions to trigger for the alert. Available actions are: WebhookAction, EmailAction, ResendBroadcastAction, GoogleDocsAction"},"always_trigger":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Always Trigger","description":"Whether to always trigger the actions when sources are scanned. This skips the check for if the alert conditions are satisfied and run triggers immediately. Defaults to False."},"repeat":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Repeat","description":"Whether to repeat the alert. Default is True. If False, the alert will be disabled after it triggers once."},"active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Active","description":"Whether the alert is active or not. Default is True."},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At","description":"The expiration date for the alert. Default is None. If set, the alert will be disabled after this date."},"report":{"anyOf":[{"$ref":"#/components/schemas/LegacyReportRequest"},{"$ref":"#/components/schemas/DeepNewsReportRequest"},{"items":{"anyOf":[{"$ref":"#/components/schemas/LegacyReportRequest"},{"$ref":"#/components/schemas/DeepNewsReportRequest"}]},"type":"array"},{"type":"null"}],"title":"Report","description":"Configuration for generating a written report when the alert triggers. If report is a list, the individual reports will be concatenated into one report in the order they are defined. If not specified, no report is generated. Use ReportRequest(identifier='deepnews', ...) for DeepNews reports.Use ReportRequest(...) or ReportRequest(identifier='legacy', ...) for legacy reports (DEPRECATED). Requests without identifier default to 'deepnews'. Only DeepNews reports can be used in list."},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"The title of the alert. If not provided, no title will be used.","example":"Alert for US President's statements on the economy"},"share_link":{"anyOf":[{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},{"type":"null"}],"title":"Share Link","description":"The newsplunker share link to update when the alert triggers."}},"type":"object","title":"UpdateAlertRequest"},"UpdateNewsletterRequest":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"The name of the newsletter.","example":"Daily Economy News"},"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query","description":"The natural language query to run for the newsletter.","example":"Send me the latest news on the economy."},"cron":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cron","description":"The cron schedule for the newsletter. For example daily at 00:00 UTC is '0 0 * * *'. See https://crontab.run/ for more examples","example":"0 0 * * *"},"model":{"anyOf":[{"type":"string","enum":["gpt-4o","gpt-4o-mini","claude-3-5-sonnet-latest","meta-llama/Meta-Llama-3.1-405B-Instruct","meta-llama/Meta-Llama-3.3-70B-Instruct"]},{"type":"null"}],"title":"Model","description":"The model to use for the newsletter.","example":"gpt-4o-mini"},"subject":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subject","description":"The subject of the newsletter. If not provided it will be auto generated.","example":"Your Daily Economy News"},"sender":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sender","description":"The sender of the newsletter.","example":"Your Name <sender@domain.com>"},"logo_url":{"anyOf":[{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},{"type":"null"}],"title":"Logo Url","description":"The logo URL for the newsletter.","example":"https://example.com/logo.png"},"reply_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reply To","description":"The reply-to address for the newsletter. If not provided, the sender will be used.","example":"Your Name <sender@domain.com>"},"audience_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Audience Id","description":"The audience ID to use for the newsletter. If not provided a new audience will be created.","example":"123e4567-e89b-12d3-a456-426614174000"},"resend_api_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resend Api Key","description":"The resend API key to use for the newsletter. If not provided, the newsletter will not be sent.","example":"re_123456789"},"public":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Public","description":"Whether the newsletter is public or not. If not provided, the newsletter will be public. If you make the newsletter public only title and query will be shown."},"active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Active","description":"Whether the newsletter is active or not. If not provided, the newsletter will be active. If you make the newsletter inactive, it will not be sent."},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At","description":"The expiration date for the alert. Default is None. If set, the alert will be disabled after this date."}},"type":"object","title":"UpdateNewsletterRequest"},"UpsertApiKeyRequest":{"properties":{"api_key":{"type":"string","minLength":10,"title":"Api Key"}},"type":"object","required":["api_key"],"title":"UpsertApiKeyRequest"},"Usage":{"properties":{"credits":{"type":"integer","title":"Credits"}},"type":"object","required":["credits"],"title":"Usage"},"UserProfile":{"properties":{"identity_type":{"type":"string","const":"user","title":"Identity Type","default":"user"},"id":{"type":"string","title":"Id"},"subscription":{"$ref":"#/components/schemas/UserProfileSubscription"},"organization":{"anyOf":[{"$ref":"#/components/schemas/UserProfileOrganization"},{"type":"null"}]},"suspended":{"type":"boolean","title":"Suspended","default":false}},"type":"object","required":["id","subscription"],"title":"UserProfile"},"UserProfileOrganization":{"properties":{"id":{"type":"string","title":"Id"},"role":{"type":"string","title":"Role"}},"type":"object","required":["id","role"],"title":"UserProfileOrganization"},"UserProfileSubscription":{"properties":{"status":{"type":"string","title":"Status"},"plan":{"type":"string","title":"Plan"},"period_start":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Period Start"},"period_end":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Period End"}},"type":"object","required":["status","plan"],"title":"UserProfileSubscription"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"ValidationErrorItem":{"properties":{"loc":{"items":{"type":"string"},"type":"array","title":"Loc"},"msg":{"type":"string","title":"Msg"},"type":{"type":"string","title":"Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationErrorItem"},"ValidationErrorModel":{"properties":{"code":{"type":"integer","title":"Code","default":422000},"detail":{"items":{"$ref":"#/components/schemas/ValidationErrorItem"},"type":"array","title":"Detail"}},"type":"object","required":["detail"],"title":"ValidationErrorModel","examples":[{"code":422000,"detail":[{"loc":["query","page"],"msg":"field required","type":"value_error.missing"}]}]},"WebSearchResponse":{"properties":{"as_string":{"type":"string","title":"As String"},"as_dicts":{"items":{"$ref":"#/components/schemas/WebSearchResult"},"type":"array","title":"As Dicts"},"offset":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Offset"}},"type":"object","required":["as_string","as_dicts"],"title":"WebSearchResponse"},"WebSearchResult":{"properties":{"title":{"type":"string","title":"Title"},"url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Url"},"source":{"type":"string","title":"Source"},"published":{"type":"string","title":"Published"},"key_points":{"items":{"type":"string"},"type":"array","title":"Key Points"},"raw_text":{"type":"string","title":"Raw Text","default":""},"as_string_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"As String Key"}},"type":"object","required":["title","url","source","published","key_points"],"title":"WebSearchResult"},"WebSource":{"properties":{"identifier":{"type":"string","const":"web","title":"Identifier","default":"web"},"params":{"$ref":"#/components/schemas/WebSourceParams"}},"type":"object","required":["params"],"title":"WebSource"},"WebSourceParams":{"properties":{"queries":{"items":{"type":"string"},"type":"array","title":"Queries","description":"The queries to use for the web search. This is a list of strings."},"domains":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Domains","description":"The domains to restrict the web search to."},"strict":{"type":"boolean","title":"Strict","description":"If true, the web search will only return results that have a known publication date and are within the lookback period.","default":true},"lookback":{"type":"integer","title":"Lookback","description":"The number of hours back to accept for the web search. If not provided, no lookback will be applied.","default":24}},"type":"object","required":["queries"],"title":"WebSourceParams"},"WebhookAction":{"properties":{"action":{"type":"string","const":"webhook","title":"Action","default":"webhook"},"params":{"$ref":"#/components/schemas/WebhookParams"}},"type":"object","required":["params"],"title":"WebhookAction"},"WebhookParams":{"properties":{"url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Url","description":"The URL to send the webhook when the alert triggers"},"headers":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Headers","description":"The headers to send with the webhook."},"payload":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Payload","description":"The payload to send with the webhook."}},"type":"object","required":["url"],"title":"WebhookParams"},"WikiResponseDictItem":{"properties":{"content":{"type":"string","title":"Content"},"title":{"type":"string","title":"Title"},"url":{"type":"string","title":"Url"},"categories":{"items":{"type":"string"},"type":"array","title":"Categories"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"},"cirrus_metadata":{"anyOf":[{"$ref":"#/components/schemas/CirrusMetadata"},{"type":"null"}]},"point_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Point Id"}},"type":"object","required":["content","title","url","categories","timestamp"],"title":"WikiResponseDictItem"},"WikiSearchResponse":{"properties":{"documents":{"items":{"$ref":"#/components/schemas/WikiResponseDictItem"},"type":"array","title":"Documents"}},"type":"object","required":["documents"],"title":"WikiSearchResponse"},"abc__APIErrorModel__1":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":405000,"detail":"Method Not Allowed"}]},"abc__APIErrorModel__10":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":403000,"detail":"Forbidden"}]},"abc__APIErrorModel__100":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":400000,"detail":"Bad Request"}]},"abc__APIErrorModel__101":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":405000,"detail":"Method Not Allowed"}]},"abc__APIErrorModel__102":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":403000,"detail":"Forbidden"}]},"abc__APIErrorModel__103":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":401000,"detail":"Unauthorized"}]},"abc__APIErrorModel__104":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":400000,"detail":"Bad Request"}]},"abc__APIErrorModel__105":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":405000,"detail":"Method Not Allowed"}]},"abc__APIErrorModel__106":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":403000,"detail":"Forbidden"}]},"abc__APIErrorModel__107":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":401000,"detail":"Unauthorized"}]},"abc__APIErrorModel__108":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":400000,"detail":"Bad Request"}]},"abc__APIErrorModel__109":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":405000,"detail":"Method Not Allowed"}]},"abc__APIErrorModel__11":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":401000,"detail":"Unauthorized"}]},"abc__APIErrorModel__110":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":403000,"detail":"Forbidden"}]},"abc__APIErrorModel__111":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":401000,"detail":"Unauthorized"}]},"abc__APIErrorModel__112":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":400000,"detail":"Bad Request"}]},"abc__APIErrorModel__113":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":405000,"detail":"Method Not Allowed"}]},"abc__APIErrorModel__114":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":403000,"detail":"Forbidden"}]},"abc__APIErrorModel__115":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":401000,"detail":"Unauthorized"}]},"abc__APIErrorModel__116":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":400000,"detail":"Bad Request"}]},"abc__APIErrorModel__12":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":400000,"detail":"Bad Request"}]},"abc__APIErrorModel__13":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":405000,"detail":"Method Not Allowed"}]},"abc__APIErrorModel__14":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":403000,"detail":"Forbidden"}]},"abc__APIErrorModel__15":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":401000,"detail":"Unauthorized"}]},"abc__APIErrorModel__16":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":400000,"detail":"Bad Request"}]},"abc__APIErrorModel__17":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":405000,"detail":"Method Not Allowed"}]},"abc__APIErrorModel__18":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":403000,"detail":"Forbidden"}]},"abc__APIErrorModel__19":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":401000,"detail":"Unauthorized"}]},"abc__APIErrorModel__2":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":403000,"detail":"Forbidden"}]},"abc__APIErrorModel__20":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":400000,"detail":"Bad Request"}]},"abc__APIErrorModel__21":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":405000,"detail":"Method Not Allowed"}]},"abc__APIErrorModel__22":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":403000,"detail":"Forbidden"}]},"abc__APIErrorModel__23":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":401000,"detail":"Unauthorized"}]},"abc__APIErrorModel__24":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":400000,"detail":"Bad Request"}]},"abc__APIErrorModel__25":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":405000,"detail":"Method Not Allowed"}]},"abc__APIErrorModel__26":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":403000,"detail":"Forbidden"}]},"abc__APIErrorModel__27":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":401000,"detail":"Unauthorized"}]},"abc__APIErrorModel__28":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":400000,"detail":"Bad Request"}]},"abc__APIErrorModel__29":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":405000,"detail":"Method Not Allowed"}]},"abc__APIErrorModel__3":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":401000,"detail":"Unauthorized"}]},"abc__APIErrorModel__30":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":403000,"detail":"Forbidden"}]},"abc__APIErrorModel__31":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":401000,"detail":"Unauthorized"}]},"abc__APIErrorModel__32":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":400000,"detail":"Bad Request"}]},"abc__APIErrorModel__33":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":405000,"detail":"Method Not Allowed"}]},"abc__APIErrorModel__34":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":403000,"detail":"Forbidden"}]},"abc__APIErrorModel__35":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":401000,"detail":"Unauthorized"}]},"abc__APIErrorModel__36":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":400000,"detail":"Bad Request"}]},"abc__APIErrorModel__37":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":405000,"detail":"Method Not Allowed"}]},"abc__APIErrorModel__38":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":403000,"detail":"Forbidden"}]},"abc__APIErrorModel__39":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":401000,"detail":"Unauthorized"}]},"abc__APIErrorModel__4":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":400000,"detail":"Bad Request"}]},"abc__APIErrorModel__40":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":400000,"detail":"Bad Request"}]},"abc__APIErrorModel__41":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":405000,"detail":"Method Not Allowed"}]},"abc__APIErrorModel__42":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":403000,"detail":"Forbidden"}]},"abc__APIErrorModel__43":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":401000,"detail":"Unauthorized"}]},"abc__APIErrorModel__44":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":400000,"detail":"Bad Request"}]},"abc__APIErrorModel__45":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":405000,"detail":"Method Not Allowed"}]},"abc__APIErrorModel__46":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":403000,"detail":"Forbidden"}]},"abc__APIErrorModel__47":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":401000,"detail":"Unauthorized"}]},"abc__APIErrorModel__48":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":400000,"detail":"Bad Request"}]},"abc__APIErrorModel__49":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":405000,"detail":"Method Not Allowed"}]},"abc__APIErrorModel__5":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":405000,"detail":"Method Not Allowed"}]},"abc__APIErrorModel__50":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":403000,"detail":"Forbidden"}]},"abc__APIErrorModel__51":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":401000,"detail":"Unauthorized"}]},"abc__APIErrorModel__52":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":400000,"detail":"Bad Request"}]},"abc__APIErrorModel__53":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":405000,"detail":"Method Not Allowed"}]},"abc__APIErrorModel__54":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":403000,"detail":"Forbidden"}]},"abc__APIErrorModel__55":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":401000,"detail":"Unauthorized"}]},"abc__APIErrorModel__56":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":400000,"detail":"Bad Request"}]},"abc__APIErrorModel__57":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":405000,"detail":"Method Not Allowed"}]},"abc__APIErrorModel__58":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":403000,"detail":"Forbidden"}]},"abc__APIErrorModel__59":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":401000,"detail":"Unauthorized"}]},"abc__APIErrorModel__6":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":403000,"detail":"Forbidden"}]},"abc__APIErrorModel__60":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":400000,"detail":"Bad Request"}]},"abc__APIErrorModel__61":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":405000,"detail":"Method Not Allowed"}]},"abc__APIErrorModel__62":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":403000,"detail":"Forbidden"}]},"abc__APIErrorModel__63":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":401000,"detail":"Unauthorized"}]},"abc__APIErrorModel__64":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":400000,"detail":"Bad Request"}]},"abc__APIErrorModel__65":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":405000,"detail":"Method Not Allowed"}]},"abc__APIErrorModel__66":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":403000,"detail":"Forbidden"}]},"abc__APIErrorModel__67":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":401000,"detail":"Unauthorized"}]},"abc__APIErrorModel__68":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":400000,"detail":"Bad Request"}]},"abc__APIErrorModel__69":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":405000,"detail":"Method Not Allowed"}]},"abc__APIErrorModel__7":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":401000,"detail":"Unauthorized"}]},"abc__APIErrorModel__70":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":403000,"detail":"Forbidden"}]},"abc__APIErrorModel__71":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":401000,"detail":"Unauthorized"}]},"abc__APIErrorModel__72":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":400000,"detail":"Bad Request"}]},"abc__APIErrorModel__73":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":405000,"detail":"Method Not Allowed"}]},"abc__APIErrorModel__74":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":403000,"detail":"Forbidden"}]},"abc__APIErrorModel__75":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":401000,"detail":"Unauthorized"}]},"abc__APIErrorModel__76":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":400000,"detail":"Bad Request"}]},"abc__APIErrorModel__77":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":405000,"detail":"Method Not Allowed"}]},"abc__APIErrorModel__78":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":403000,"detail":"Forbidden"}]},"abc__APIErrorModel__79":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":401000,"detail":"Unauthorized"}]},"abc__APIErrorModel__8":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":400000,"detail":"Bad Request"}]},"abc__APIErrorModel__80":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":400000,"detail":"Bad Request"}]},"abc__APIErrorModel__81":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":405000,"detail":"Method Not Allowed"}]},"abc__APIErrorModel__82":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":403000,"detail":"Forbidden"}]},"abc__APIErrorModel__83":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":401000,"detail":"Unauthorized"}]},"abc__APIErrorModel__84":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":400000,"detail":"Bad Request"}]},"abc__APIErrorModel__85":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":405000,"detail":"Method Not Allowed"}]},"abc__APIErrorModel__86":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":403000,"detail":"Forbidden"}]},"abc__APIErrorModel__87":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":401000,"detail":"Unauthorized"}]},"abc__APIErrorModel__88":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":400000,"detail":"Bad Request"}]},"abc__APIErrorModel__89":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":405000,"detail":"Method Not Allowed"}]},"abc__APIErrorModel__9":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":405000,"detail":"Method Not Allowed"}]},"abc__APIErrorModel__90":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":403000,"detail":"Forbidden"}]},"abc__APIErrorModel__91":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":401000,"detail":"Unauthorized"}]},"abc__APIErrorModel__92":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":400000,"detail":"Bad Request"}]},"abc__APIErrorModel__93":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":405000,"detail":"Method Not Allowed"}]},"abc__APIErrorModel__94":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":403000,"detail":"Forbidden"}]},"abc__APIErrorModel__95":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":401000,"detail":"Unauthorized"}]},"abc__APIErrorModel__96":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":400000,"detail":"Bad Request"}]},"abc__APIErrorModel__97":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":405000,"detail":"Method Not Allowed"}]},"abc__APIErrorModel__98":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":403000,"detail":"Forbidden"}]},"abc__APIErrorModel__99":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":401000,"detail":"Unauthorized"}]},"asknews_api__errors__APIErrorModel":{"properties":{"code":{"type":"integer","title":"Code"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["code","detail"],"title":"APIErrorModel","examples":[{"code":500000,"detail":"Internal Server Error"}]},"asknews_api__schema__v1__common__GraphRelationships":{"properties":{"nodes":{"items":{"additionalProperties":{"type":"string"},"propertyNames":{"enum":["id","type","detailed_type","ner_type"]},"type":"object"},"type":"array","title":"Nodes","default":[]},"edges":{"items":{"additionalProperties":{"type":"string"},"propertyNames":{"enum":["from","to","label"]},"type":"object"},"type":"array","title":"Edges","default":[]}},"type":"object","title":"GraphRelationships"},"asknews_api__schema__v1__stories__GraphRelationships":{"properties":{"nodes":{"items":{"additionalProperties":{"type":"string"},"propertyNames":{"enum":["id","type","detailed_type"]},"type":"object"},"type":"array","title":"Nodes"},"edges":{"items":{"additionalProperties":{"type":"string"},"propertyNames":{"enum":["from","to","label"]},"type":"object"},"type":"array","title":"Edges"}},"type":"object","required":["nodes","edges"],"title":"GraphRelationships"}},"securitySchemes":{"APIKey":{"type":"apiKey","in":"header","name":"Authorization"}}}}