Source: https://eventregistry.org/documentation?tab=eventDetails # Get event details Obtain details about a single event. The endpoint can be used to retrieve detailed information about a single event of interest. The event of interest should be provided with the `eventUri` parameter. For each event you can retrieve multiple properties. The most common is retrieving the list of articles that report about the event. Alternatively, you can also generate various summaries, by using some other `returnType` value. The return type `keywordAggr` will, for example, return the top keywords that are mentioned in the articles about the event. If you would like to retrieve only a subset of articles assigned to the event, you can do so by specifying one of the available filters (`keyword`, `conceptUri`, etc.). **Endpoint:** GET | POST `https://eventregistry.org/api/v1/event/getEvent` **Headers:** Content-Type: application/json #### `Parameters` #### `apiKey` string (required) Your API key #### `eventUri` string (required) Specify the URI of the event you would like to see returned. #### `resultType` string | string[] Define what kind of results you would like to get. Each result type corresponds to the prefix that'll be used for other parameters. Available values: `info`, `articles`, `articleUris`, `keywordAggr`, `sourceExAggr`, `dateMentionAggr`, `articleTrend`, `similarEvents` Default value: `info` #### `articlesLang` string | string[] If resultType is `articles` then use this parameter if you wish to obtain only articles about the event in specific language(s). #### `articlesIncludeDuplicates` boolean If resultType is `articles` then set this value to `true` in order to return also articles that are copies of other articles (possibly from other news sources). Default value: `false` #### `Filters` Click to see possible parameters that you can specify to filter event's articles to a subset based on your criteria #### `keyword` string | string[] Find articles that mention the specified keyword or a phrase. You can specify at most 60 keywords in a single search. If you specify multiple `keyword` parameters, then only articles that mention all of them will be returned, unless you specify `keywordOper` parameter and set it to `or`. Use the `keywordSearchMode` parameter to control how the keyword is matched; see the [keyword search modes](/documentation?tab=keyword_search_options) section. Example value: `Barack Obama` #### `conceptUri` string | string[] Find articles that mention the concept with a concept uri. You can specify at most 50 concepts in a single search. If multiple `conceptUri` parameters are provided, then only articles that are about all specified concepts will be returned, unless you specify `conceptOper` parameter and set it to `or`. Check [autosuggest methods](/documentation?tab=suggConcepts) to get concept URI value for a specified concept label. Example value: `http://en.wikipedia.org/wiki/World_Health_Organization` #### `categoryUri` string | string[] Find articles that are assigned to a particular category. You can specify at most 20 categories in a single search. If multiple `categoryUri` parameters are provided, then articles that are about any of the specified categories will be returned, unless you specify `categoryOper` parameter and set it to `and`. Check [autosuggest methods](/documentation?tab=suggCategories) to get value for a specified category name. Example value: `dmoz/Business/Accounting` #### `sourceUri` string | string[] Find articles that have been published by a news source. If you specify multiple `sourceUri` parameters, then articles from any of the specified sources will be returned. Check [autosuggest methods](/documentation?tab=suggSources) to get value for a source name. Example value: `bbc.co.uk` #### `sourceLocationUri` string | string[] Find articles that were published by news sources located at the given geographic location (city or country). If you specify multiple `sourceLocationUri` parameters, then articles from sources from any of the specified sources will be returned. Check [autosuggest methods](/documentation?tab=suggLocations) to get value for a location name. Example value: `http://en.wikipedia.org/wiki/Germany` #### `sourceGroupUri` string | string[] Find articles that were published by news sources that are assigned to some predefined group of news sources. Example value: `general/ERtop10` #### `authorUri` string | string[] Find articles that were written by a particular author. Check [autosuggest methods](/documentation?tab=suggAuthors) to get value for author uri based on the author name (and potentially source url). Example value: `mark_mazzetti@nytimes.com` #### `locationUri` string | string[] Find articles that describe something that occured at a particular location (based on the location mentioned in the dateline). Check [autosuggest methods](/documentation?tab=suggLocations) to get value for a location name. NOTE: If a location will not be specified in the dateline (immediate start of the article), the article will not be returned. Consider also using `conceptUri` to find articles that mention a particular location. Example value: `http://en.wikipedia.org/wiki/United_States` #### `dateStart` string The starting date on or after the articles of interest were published. The date should be in the YYYY-MM-DD format. Example value: `2018-01-03` #### `dateEnd` string The last date on which the articles of interest were published. The date should be in the YYYY-MM-DD format. Example value: `2018-01-10` #### `dateMentionStart` string Ignore events that contain one or more articles that explicitly mention a date that is equal or greater than `dateMentionStart`. The date should be in the YYYY-MM-DD format. Example value: `2018-01-10` #### `dateMentionEnd` string Ignore events that contain one or more articles that explicitly mention a date that is lower or equal to `dateMentionEnd`. The date should be in the YYYY-MM-DD format. Example value: `2018-01-10` #### `keywordLoc` string What data should be used when searching using the keywords provided by `keywords` parameter. Available values: `body`, `title`, `title,body` Default value: `body` #### `keywordOper` string If more keywords are provided with the `keyword` parameter, what should be the Boolean operator used. If `and` (default) then all of the specified keywords have to be present in the article; if `or` then an article will be returned if it mentions any of the provided keywords. Available values: `and`, `or` Default value: `and` #### `keywordSearchMode` string Determines how the keywords provided with the `keyword` parameter are matched against the content. Use `phrase` (default) to match the keyword as an exact phrase, `exact` to use the Boolean query language (with `AND`, `OR`, `NOT`, `NEAR` and `NEXT` operators), or `simple` for a relevance-based search that does not require all terms to be present. See the [keyword search modes](/documentation?tab=keyword_search_options) section for details and examples. Available values: `phrase`, `exact`, `simple` Default value: `phrase` #### `conceptOper` string If more concepts are provided with the `conceptUri` parameter, what should be the Boolean operator used. If `and` (default) then all of the specified concepts have to be present in the article; if `or` then an article will be returned if it mentions any of the provided concepts. Available values: `and`, `or` Default value: `and` #### `categoryOper` string If more categories are provided with the `categoryUri` parameter, what should be the Boolean operator used. If `and` then all of the specified categories have to be present in the article; if `or` then an article will be returned if it mentions any of the provided categories. Available values: `and`, `or` Default value: `or` #### `startSourceRankPercentile` integer Starting [ranking percentile of the sources](https://github.com/EventRegistry/event-registry-python/wiki/Source-filtering#filtering-of-sources-based-on-their-ranking) to consider in the results (default: 0). Value should be in range 0-90 and divisible by 10. Default value: `0` #### `endSourceRankPercentile` integer Ending [ranking percentile of the sources](https://github.com/EventRegistry/event-registry-python/wiki/Source-filtering#filtering-of-sources-based-on-their-ranking) to consider in the results (default: 100). Value should be in range 10-100 and divisible by 10. Default value: `100` #### `minSentiment` integer The minimum value of the sentiment, the article should have. Valid value is any floating number between -1 (very negative) to 1 (very positive). 0 represents neutral sentiment. Note that setting the value will automatically reduce results to just English articles, since the sentiment can only be computed for English language. #### `maxSentiment` integer The maximum value of the sentiment, the article should have. Valid value is any floating number between -1 (very negative) to 1 (very positive). 0 represents neutral sentiment. Note that setting the value will automatically reduce results to just English articles, since the sentiment can only be computed for English language. #### `Returned Details` The API call can return more or less meta-data information about the events, articles, concepts, categories, sources and locations. Click to see the available properties that can be specified to determine the amount of returned information. #### `includeEventTitle` boolean Set this parameter to true to include the event title in the response. Default value: `true` #### `includeEventSummary` boolean Set this parameter to true to include the event title in the response. Default value: `false` #### `includeEventSocialScore` boolean Set this parameter to true to include the event social score in the response. Default value: `false` #### `includeEventSentiment` boolean Set this parameter to true to include the event sentiment in the response. Default value: `true` #### `includeEventLocation` boolean Set this parameter to true to include the event location in the response. Default value: `true` #### `includeEventDate` boolean Set this parameter to true to include the event date in the response. Default value: `true` #### `includeEventArticleCounts` boolean Set this parameter to true to include the article counts for events in the response. Default value: `true` #### `includeEventConcepts` boolean Set this parameter to true to include the event concepts in the response. Default value: `true` #### `includeEventCategories` boolean Set this parameter to true to include the event categories in the response. Default value: `true` #### `includeEventCommonDates` boolean Set this parameter to true to include the event commmon dates in the response. Default value: `false` #### `includeEventStories` boolean Set this parameter to true to include the event stories in the response. Default value: `false` #### `eventImageCount` integer Define how many images you would like to have in the response. Default value: `0` #### `includeConceptLabel` boolean Set this parameter to true to include the concept label in the response. Default value: `true` #### `includeConceptImage` boolean Set this parameter to true to include the concept image in the response. Default value: `false` #### `includeConceptSynonyms` boolean Set this parameter to true to include the concept synonyms in the response. Default value: `false` #### `conceptLang` string Define the language of the concept label. Default value: `eng` #### `includeStoryBasicStats` boolean Set this parameter to true to include story basic stats in the response. Default value: `false` #### `includeStoryTitle` boolean Set this parameter to true to include the story title in the response. Default value: `false` #### `includeStoryLocation` boolean Set this parameter to true to include the story location in the response. Default value: `false` #### `includeStoryDate` boolean Set this parameter to true to include the story date in the response. Default value: `false` #### `includeStoryConcepts` boolean Set this parameter to true to include the story concepts in the response. Default value: `false` #### `includeStoryCategories` boolean Set this parameter to true to include the story categories in the response. Default value: `false` #### `includeStoryMedoidArticle` boolean Set this parameter to true to include story medoid article in the response. Default value: `false` #### `includeStoryCommonDates` boolean Set this parameter to true to include story common dates in the response. Default value: `false` #### `storyImageCount` integer Define how many images you would like to have in the response. Default value: `0` #### `includeArticleTitle` boolean Set this parameter to true to include the article title in the response. Default value: `true` #### `includeArticleBasicInfo` boolean Set this parameter to true to include the core article information in the response. Default value: `true` #### `includeArticleBody` boolean Set this parameter to true to include the article body in the response. Default value: `true` #### `includeArticleEventUri` boolean Set this parameter to true to include the uri of the event (to which the article belongs) in the response. Default value: `true` #### `includeArticleSocialScore` boolean Set this parameter to true to include the information about how many times the article was shared on different social media. Default value: `false` #### `includeArticleSentiment` boolean Set this parameter to true to include the article sentiment in the response (value will be non-null only for English articles). Default value: `true` #### `includeArticleConcepts` boolean Set this parameter to true to include the article concepts in the response. Default value: `false` #### `includeArticleCategories` boolean Set this parameter to true to include the article categories in the response. Default value: `false` #### `includeArticleLocation` boolean Set this parameter to true to include the article location in the response. Default value: `false` #### `includeArticleImage` boolean Set this parameter to true to include the article image in the response. Default value: `true` #### `includeArticleAuthors` boolean Set this parameter to true to include the article authors in the response. Default value: `true` #### `includeArticleVideos` boolean Set this parameter to true to include the article videos in the response. Default value: `false` #### `includeArticleLinks` boolean Set this parameter to true to include the article links in the response. Default value: `false` #### `includeArticleExtractedDates` boolean Set this parameter to true to include article extracted dates in the response. Default value: `false` #### `includeArticleDuplicateList` boolean Set this parameter to true to include the list of duplicate articles in the response. Default value: `false` #### `includeArticleOriginalArticle` boolean Set this parameter to true to include the original article in the response. Default value: `false` #### `articleBodyLen` integer Set the size of the article body that'll be returned in the response. Use -1 for full article body. Default value: `-1` #### `includeSourceTitle` boolean Set this parameter to true to include the source title in the response. Default value: `true` #### `includeSourceDescription` boolean Set this parameter to true to include the source description in the response. Default value: `false` #### `includeSourceLocation` boolean Set this parameter to true to include the source location in the response. Default value: `false` #### `includeSourceRanking` boolean Set this parameter to true to include the source ranking in the response. Default value: `false` #### `includeLocationPopulation` boolean Set to true to include the population size of the location. Default value: `false` #### `includeLocationGeoNamesId` boolean Set to true to include the GeoNames id of the location. Default value: `false` #### `includeLocationCountryArea` boolean Set to true to include the are of the location in squared km. Default value: `false` #### `includeLocationCountryContinent` boolean Set to true to get the continent of the country for location objects. Default value: `false` ## Request examples ### Example 1 Get articles that belong to a particular event with a given URI. Request body: ```json { "eventUri": "eng-2940883", "resultType": "articles", "articlesPage": 1, "articlesCount": 100, "articlesLang": [ "eng", "deu", "zho", "slv", "spa" ], "articlesSortBy": "cosSim", "articlesSortByAsc": false, "articlesArticleBodyLen": -1, "apiKey": "YOUR_API_KEY" } ``` ```python from eventregistry import * er = EventRegistry(apiKey = YOUR_API_KEY) # get only the English, German, Chinese, Slovene and Spanish articles mentioning this event q = QueryEventArticlesIter("eng-2940883", lang = [ "eng", "deu", "zho", "slv", "spa" ]) # iterate over all the matching articles of the event, sorted by closeness to the center of the event for art in q.execQuery(er, sortBy = "cosSim"): print(art) ``` ```javascript var er = new erBase.EventRegistry(); var q1 = new erBase.QueryEvent("eng-2940883"); var requestEventArticles = new erBase.RequestEventArticles({ page: 1, count: 100, lang: [ "eng", "deu", "zho", "slv", "spa" ], sortBy: "cosSim", }); q1.setRequestedResult(requestEventArticles); er.execQuery(q1).then((response) => { console.info(response); }); ``` ```typescript const er = new EventRegistry(); const q1 = new QueryEvent("eng-2940883"); const requestEventArticles = new RequestEventArticles({ page: 1, count: 100, lang: [ "eng", "deu", "zho", "slv", "spa" ], sortBy: "cosSim", }); q1.setRequestedResult(requestEventArticles); er.execQuery(q1).then((response) => { console.info(response); }); ``` ### Example 2 Get information about top keywords extracted from the articles about an event with a particular URI. Request body: ```json { "action": "getEvent", "eventUri": "deu-931031", "resultType": "keywordAggr", "apiKey": "YOUR_API_KEY" } ``` ```python from eventregistry import * er = EventRegistry(apiKey = YOUR_API_KEY) q = QueryEvent("deu-931031") # set the requested result to be the list of top keywords from the articles about the event q.setRequestedResult(RequestEventKeywordAggr()) res = er.execQuery(q) ``` ```javascript var er = new erBase.EventRegistry(); var q1 = new erBase.QueryEvent("deu-931031"); var requestEventKeywordAggr = new erBase.RequestEventKeywordAggr(); q1.setRequestedResult(requestEventKeywordAggr); er.execQuery(q1).then((response) => { console.info(response); }); ``` ```typescript const er = new EventRegistry(); const q1 = new QueryEvent("deu-931031"); const requestEventKeywordAggr = new RequestEventKeywordAggr(); q1.setRequestedResult(requestEventKeywordAggr); er.execQuery(q1).then((response) => { console.info(response); }); ``` ### Example 3 Get information about how reporting reporting about the event was trending over time. Request body: ```json { "action": "getEvent", "eventUri": "deu-931031", "articleTrendLang": [ "eng", "deu", "zho", "slv", "spa" ], "articleTrendPage": 1, "articleTrendCount": 100, "resultType": "articleTrend", "apiKey": "YOUR_API_KEY" } ``` ```python from eventregistry import * er = EventRegistry(apiKey = YOUR_API_KEY) q = QueryEvent("deu-931031") requestEventArticleTrend = RequestEventArticleTrend( lang = [ "eng", "deu", "zho", "slv", "spa" ], page = 1, count = 100 ) q.setRequestedResult(requestEventArticleTrend) res = er.execQuery(q) ``` ```javascript var er = new erBase.EventRegistry(); var q1 = new erBase.QueryEvent("deu-931031"); var requestEventArticleTrend = new erBase.RequestEventArticleTrend({ lang: [ "eng", "deu", "zho", "slv", "spa" ], page: 1, count: 100, }); q1.setRequestedResult(requestEventArticleTrend); er.execQuery(q1).then((response) => { console.info(response); }); ``` ```typescript const er = new EventRegistry(); const q1 = new QueryEvent("deu-931031"); const requestEventArticleTrend = new RequestEventArticleTrend({ lang: [ "eng", "deu", "zho", "slv", "spa" ], page: 1, count: 100, }); q1.setRequestedResult(requestEventArticleTrend); er.execQuery(q1).then((response) => { console.info(response); }); ``` ## Example output ```json { "eng-8581172": { "info": { "uri": "eng-8581172", "concepts": [ { "uri": "http://en.wikipedia.org/wiki/Tesla,_Inc.", "type": "org", "score": 100, "label": { "eng": "Tesla, Inc." } }, { "uri": "http://en.wikipedia.org/wiki/Electric_vehicle", "type": "wiki", "score": 65, "label": { "eng": "Electric vehicle" } }, { "uri": "http://en.wikipedia.org/wiki/Elon_Musk", "type": "wiki", "score": 55, "label": { "eng": "Elon Musk" } }, { "#META ITEM": "other concepts..." } ], "eventDate": "2023-04-25", "totalArticleCount": 83, "title": { "eng": "Tesla's Plunge Drags Valuation Below $500 Billion on Margin Fear" }, "summary": { "eng": "Tesla Inc. shares extended their brutal selloff, pulling the company's market valuation below the key half-trillion dollar mark as investors increasingly fear its price-cutting plan will eat into profits.\n\nThe stock price fell as much as 3.5% to $155.03 in New York and is on pace to close at the lowest level since Jan. 25. If the decline holds until the end of regular session, the company will have lost more than $70 billion from its market capitalization over five trading sessions since posting " }, "location": null, "categories": [ { "uri": "news/Business", "label": "news/Business", "wgt": 78 } ], "images": [ "https://assets.bwbx.io/images/users/iqjWHBFdfxIU/i8z8BwxMOW1w/v1/1200x800.jpg" ], "articleCounts": { "eng": 83 }, "sentiment": -0.003921568627450966 } } } ``` ## Output schema ```json { "type": "object", "properties": { "uri": { "type": "object", "properties": { "info": { "type": "object", "properties": { "uri": { "type": "string" }, "concepts": { "type": "array", "items": { "type": "object", "properties": { "uri": { "type": "string" }, "type": { "type": "string" }, "score": { "type": "integer" }, "label": { "type": "object", "properties": { "eng": { "type": "string" } } }, "image": { "type": "string" }, "synonyms": { "type": "object", "properties": {} }, "trendingScore": { "type": "object", "properties": { "news": { "type": "object", "properties": { "score": { "type": "double" }, "testPopFq": { "type": "integer" }, "nullPopFq": { "type": "integer" } } } } }, "location": { "type": "object", "properties": { "type": { "type": "string" }, "label": { "type": "object", "properties": { "eng": { "type": "string" } } } } } } } }, "stories": { "type": "array", "items": { "type": "object", "properties": { "uri": { "type": "string" }, "articleCount": { "type": "integer" }, "lang": { "type": "string" }, "avgCos": { "type": "double" }, "variance": { "type": "double" }, "title": { "type": "string" }, "isUserSetTitle": { "type": "boolean" }, "concepts": { "type": "array", "items": { "type": "object", "properties": { "uri": { "type": "string" }, "type": { "type": "string" }, "score": { "type": "integer" }, "label": { "type": "object", "properties": { "eng": { "type": "string" } } }, "image": { "type": "string" }, "synonyms": { "type": "object", "properties": {} }, "trendingScore": { "type": "object", "properties": { "news": { "type": "object", "properties": { "score": { "type": "double" }, "testPopFq": { "type": "integer" }, "nullPopFq": { "type": "integer" } } } } }, "location": { "type": "object", "properties": { "type": { "type": "string" }, "label": { "type": "object", "properties": { "eng": { "type": "string" } } } } } } } }, "location": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string" }, "label": { "type": "object", "properties": { "eng": { "type": "string" } } } } } }, "isUserSetLocation": { "type": "boolean" }, "categories": { "type": "array", "items": { "type": "object", "properties": { "uri": { "type": "string" }, "label": { "type": "string" }, "wgt": { "type": "integer" } } } }, "medoidArticle": { "type": "object", "properties": { "uri": { "type": "string" }, "lang": { "type": "string" }, "isDuplicate": { "type": "boolean" }, "date": { "type": "string" }, "time": { "type": "string" }, "dateTime": { "type": "string" }, "sim": { "type": "double" }, "url": { "type": "string" }, "title": { "type": "string" }, "body": { "type": "string" }, "source": { "type": "object", "properties": { "uri": { "type": "string" }, "dataType": { "type": "string" }, "title": { "type": "string" }, "description": { "type": "string" }, "location": { "type": "object", "properties": { "type": { "type": "string" }, "label": { "type": "object", "properties": { "eng": { "type": "string" } } } } }, "locationValidated": { "type": "boolean" }, "ranking": { "type": "object", "properties": { "importanceRank": { "type": "integer" } } } } }, "concepts": { "type": "array", "items": { "type": "object", "properties": { "uri": { "type": "string" }, "type": { "type": "string" }, "score": { "type": "integer" }, "label": { "type": "object", "properties": { "eng": { "type": "string" } } }, "image": { "type": "string" }, "synonyms": { "type": "object", "properties": {} }, "trendingScore": { "type": "object", "properties": { "news": { "type": "object", "properties": { "score": { "type": "double" }, "testPopFq": { "type": "integer" }, "nullPopFq": { "type": "integer" } } } } }, "location": { "type": "object", "properties": { "type": { "type": "string" }, "label": { "type": "object", "properties": { "eng": { "type": "string" } } } } } } } }, "categories": { "type": "array", "items": { "type": "object", "properties": { "uri": { "type": "string" }, "label": { "type": "string" }, "wgt": { "type": "integer" } } } }, "links": { "type": "array", "items": { "type": "string" } }, "videos": { "type": "array", "items": { "type": "string" } }, "image": { "type": "string" }, "duplicateList": { "type": "array", "items": { "type": "string" } }, "originalArticle": { "type": "string" }, "eventUri": { "type": "string" }, "location": { "type": "object", "properties": { "type": { "type": "string" }, "label": { "type": "object", "properties": { "eng": { "type": "string" } } } } }, "extractedDates": { "type": "array", "items": { "type": "object", "properties": { "amb": { "type": "boolean" }, "imp": { "type": "boolean" }, "date": { "type": "string" }, "textStart": { "type": "integer" }, "textEnd": { "type": "integer" } } } }, "shares": { "type": "object", "properties": { "facebook": { "type": "integer" } } }, "wgt": { "type": "integer" } } }, "storyDate": { "type": "string" }, "isUserSetDate": { "type": "boolean" }, "extractedDate": { "type": "string" }, "averageDate": { "type": "string" }, "images": { "type": "array", "items": { "type": "string" } }, "commonDates": { "type": "array", "items": { "type": "object", "properties": { "amb": { "type": "boolean" }, "imp": { "type": "boolean" }, "date": { "type": "string" }, "textStart": { "type": "integer" }, "textEnd": { "type": "integer" }, "freq": { "type": "integer" } } } }, "socialScore": { "type": "double" }, "wgt": { "type": "integer" } } } }, "eventDate": { "type": "string" }, "totalArticleCount": { "type": "integer" }, "title": { "type": "object", "properties": { "eng": { "type": "string" } } }, "summary": { "type": "object", "properties": { "eng": { "type": "string" } } }, "location": { "type": "object", "properties": { "type": { "type": "string" }, "label": { "type": "object", "properties": { "eng": { "type": "string" } } } } }, "categories": { "type": "object", "properties": { "uri": { "type": "string" }, "label": { "type": "string" }, "wgt": { "type": "integer" } } }, "images": { "type": "array", "items": { "type": "string" } }, "articleCounts": { "type": "object", "properties": { "eng": { "type": "integer" } } }, "socialScore": { "type": "double" }, "commonDates": { "type": "array", "items": { "type": "object", "properties": { "amb": { "type": "boolean" }, "imp": { "type": "boolean" }, "date": { "type": "string" }, "textStart": { "type": "integer" }, "textEnd": { "type": "integer" }, "freq": { "type": "integer" } } } }, "wgt": { "type": "integer" } } }, "articles": { "type": "object", "properties": { "totalResults": { "type": "integer" }, "page": { "type": "integer" }, "count": { "type": "integer" }, "pages": { "type": "integer" }, "results": { "type": "array", "items": { "type": "object", "properties": { "uri": { "type": "string" }, "lang": { "type": "string" }, "isDuplicate": { "type": "boolean" }, "date": { "type": "string" }, "time": { "type": "string" }, "dateTime": { "type": "string" }, "sim": { "type": "double" }, "url": { "type": "string" }, "title": { "type": "string" }, "body": { "type": "string" }, "source": { "type": "object", "properties": { "uri": { "type": "string" }, "dataType": { "type": "string" }, "title": { "type": "string" }, "description": { "type": "string" }, "location": { "type": "object", "properties": { "type": { "type": "string" }, "label": { "type": "object", "properties": { "eng": { "type": "string" } } } } }, "locationValidated": { "type": "boolean" }, "ranking": { "type": "object", "properties": { "importanceRank": { "type": "integer" } } } } }, "concepts": { "type": "array", "items": { "type": "object", "properties": { "uri": { "type": "string" }, "type": { "type": "string" }, "score": { "type": "integer" }, "label": { "type": "object", "properties": { "eng": { "type": "string" } } }, "image": { "type": "string" }, "synonyms": { "type": "object", "properties": {} }, "trendingScore": { "type": "object", "properties": { "news": { "type": "object", "properties": { "score": { "type": "double" }, "testPopFq": { "type": "integer" }, "nullPopFq": { "type": "integer" } } } } }, "location": { "type": "object", "properties": { "type": { "type": "string" }, "label": { "type": "object", "properties": { "eng": { "type": "string" } } } } } } } }, "categories": { "type": "array", "items": { "type": "object", "properties": { "uri": { "type": "string" }, "label": { "type": "string" }, "wgt": { "type": "integer" } } } }, "links": { "type": "array", "items": { "type": "string" } }, "videos": { "type": "array", "items": { "type": "string" } }, "image": { "type": "string" }, "duplicateList": { "type": "array", "items": { "type": "string" } }, "originalArticle": { "type": "string" }, "eventUri": { "type": "string" }, "location": { "type": "object", "properties": { "type": { "type": "string" }, "label": { "type": "object", "properties": { "eng": { "type": "string" } } } } }, "extractedDates": { "type": "array", "items": { "type": "object", "properties": { "amb": { "type": "boolean" }, "imp": { "type": "boolean" }, "date": { "type": "string" }, "textStart": { "type": "integer" }, "textEnd": { "type": "integer" } } } }, "shares": { "type": "object", "properties": { "facebook": { "type": "integer" } } }, "wgt": { "type": "integer" } } } } } }, "articleUris": { "type": "object", "properties": { "totalResults": { "type": "integer" }, "page": { "type": "integer" }, "count": { "type": "integer" }, "pages": { "type": "integer" }, "results": { "type": "array", "items": { "type": "string" } } } }, "keywordAggr": { "type": "object", "properties": { "warning": { "type": "string" }, "usedResults": { "type": "integer" }, "totalResults": { "type": "integer" }, "results": { "type": "array", "items": { "type": "object", "properties": { "keyword": { "type": "string" }, "weight": { "type": "double" } } } } } }, "sourceExAggr": { "type": "object", "properties": { "warning": { "type": "string" }, "usedResults": { "type": "integer" }, "totalResults": { "type": "integer" }, "results": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "object", "properties": { "uri": { "type": "string" }, "dataType": { "type": "string" }, "title": { "type": "string" }, "description": { "type": "string" }, "location": { "type": "object", "properties": { "type": { "type": "string" }, "label": { "type": "object", "properties": { "eng": { "type": "string" } } } } }, "locationValidated": { "type": "boolean" }, "ranking": { "type": "object", "properties": { "importanceRank": { "type": "integer" } } } } }, "counts": { "type": "object", "properties": { "date": { "type": "string" }, "count": { "type": "integer" } } } } } } } }, "dateMentionAggr": { "type": "object", "properties": { "warning": { "type": "string" }, "usedResults": { "type": "integer" }, "totalResults": { "type": "integer" }, "results": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string" }, "count": { "type": "integer" } } } } } }, "articleTrend": { "type": "object", "properties": { "totalResults": { "type": "integer" }, "page": { "type": "integer" }, "count": { "type": "integer" }, "pages": { "type": "integer" }, "results": { "type": "array", "items": { "type": "object", "properties": { "uri": { "type": "string" }, "lang": { "type": "string" }, "isDuplicate": { "type": "boolean" }, "date": { "type": "string" }, "time": { "type": "string" }, "dateTime": { "type": "string" }, "sim": { "type": "double" }, "url": { "type": "string" }, "title": { "type": "string" }, "body": { "type": "string" }, "source": { "type": "object", "properties": { "uri": { "type": "string" }, "dataType": { "type": "string" }, "title": { "type": "string" }, "description": { "type": "string" }, "location": { "type": "object", "properties": { "type": { "type": "string" }, "label": { "type": "object", "properties": { "eng": { "type": "string" } } } } }, "locationValidated": { "type": "boolean" }, "ranking": { "type": "object", "properties": { "importanceRank": { "type": "integer" } } } } }, "concepts": { "type": "array", "items": { "type": "object", "properties": { "uri": { "type": "string" }, "type": { "type": "string" }, "score": { "type": "integer" }, "label": { "type": "object", "properties": { "eng": { "type": "string" } } }, "image": { "type": "string" }, "synonyms": { "type": "object", "properties": {} }, "trendingScore": { "type": "object", "properties": { "news": { "type": "object", "properties": { "score": { "type": "double" }, "testPopFq": { "type": "integer" }, "nullPopFq": { "type": "integer" } } } } }, "location": { "type": "object", "properties": { "type": { "type": "string" }, "label": { "type": "object", "properties": { "eng": { "type": "string" } } } } } } } }, "categories": { "type": "array", "items": { "type": "object", "properties": { "uri": { "type": "string" }, "label": { "type": "string" }, "wgt": { "type": "integer" } } } }, "links": { "type": "array", "items": { "type": "string" } }, "videos": { "type": "array", "items": { "type": "string" } }, "image": { "type": "string" }, "duplicateList": { "type": "array", "items": { "type": "string" } }, "originalArticle": { "type": "string" }, "eventUri": { "type": "string" }, "location": { "type": "object", "properties": { "type": { "type": "string" }, "label": { "type": "object", "properties": { "eng": { "type": "string" } } } } }, "extractedDates": { "type": "array", "items": { "type": "object", "properties": { "amb": { "type": "boolean" }, "imp": { "type": "boolean" }, "date": { "type": "string" }, "textStart": { "type": "integer" }, "textEnd": { "type": "integer" } } } }, "shares": { "type": "object", "properties": { "facebook": { "type": "integer" } } }, "wgt": { "type": "integer" } } } } } }, "similarEvents": { "type": "object", "properties": { "totalResults": { "type": "integer" }, "page": { "type": "integer" }, "count": { "type": "integer" }, "pages": { "type": "integer" }, "results": { "type": "array", "items": { "type": "object", "properties": { "uri": { "type": "string" }, "concepts": { "type": "array", "items": { "type": "object", "properties": { "uri": { "type": "string" }, "type": { "type": "string" }, "score": { "type": "integer" }, "label": { "type": "object", "properties": { "eng": { "type": "string" } } }, "image": { "type": "string" }, "synonyms": { "type": "object", "properties": {} }, "trendingScore": { "type": "object", "properties": { "news": { "type": "object", "properties": { "score": { "type": "double" }, "testPopFq": { "type": "integer" }, "nullPopFq": { "type": "integer" } } } } }, "location": { "type": "object", "properties": { "type": { "type": "string" }, "label": { "type": "object", "properties": { "eng": { "type": "string" } } } } } } } }, "stories": { "type": "array", "items": { "type": "object", "properties": { "uri": { "type": "string" }, "articleCount": { "type": "integer" }, "lang": { "type": "string" }, "avgCos": { "type": "double" }, "variance": { "type": "double" }, "title": { "type": "string" }, "isUserSetTitle": { "type": "boolean" }, "concepts": { "type": "array", "items": { "type": "object", "properties": { "uri": { "type": "string" }, "type": { "type": "string" }, "score": { "type": "integer" }, "label": { "type": "object", "properties": { "eng": { "type": "string" } } }, "image": { "type": "string" }, "synonyms": { "type": "object", "properties": {} }, "trendingScore": { "type": "object", "properties": { "news": { "type": "object", "properties": { "score": { "type": "double" }, "testPopFq": { "type": "integer" }, "nullPopFq": { "type": "integer" } } } } }, "location": { "type": "object", "properties": { "type": { "type": "string" }, "label": { "type": "object", "properties": { "eng": { "type": "string" } } } } } } } }, "location": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string" }, "label": { "type": "object", "properties": { "eng": { "type": "string" } } } } } }, "isUserSetLocation": { "type": "boolean" }, "categories": { "type": "array", "items": { "type": "object", "properties": { "uri": { "type": "string" }, "label": { "type": "string" }, "wgt": { "type": "integer" } } } }, "medoidArticle": { "type": "object", "properties": { "uri": { "type": "string" }, "lang": { "type": "string" }, "isDuplicate": { "type": "boolean" }, "date": { "type": "string" }, "time": { "type": "string" }, "dateTime": { "type": "string" }, "sim": { "type": "double" }, "url": { "type": "string" }, "title": { "type": "string" }, "body": { "type": "string" }, "source": { "type": "object", "properties": { "uri": { "type": "string" }, "dataType": { "type": "string" }, "title": { "type": "string" }, "description": { "type": "string" }, "location": { "type": "object", "properties": { "type": { "type": "string" }, "label": { "type": "object", "properties": { "eng": { "type": "string" } } } } }, "locationValidated": { "type": "boolean" }, "ranking": { "type": "object", "properties": { "importanceRank": { "type": "integer" } } } } }, "concepts": { "type": "array", "items": { "type": "object", "properties": { "uri": { "type": "string" }, "type": { "type": "string" }, "score": { "type": "integer" }, "label": { "type": "object", "properties": { "eng": { "type": "string" } } }, "image": { "type": "string" }, "synonyms": { "type": "object", "properties": {} }, "trendingScore": { "type": "object", "properties": { "news": { "type": "object", "properties": { "score": { "type": "double" }, "testPopFq": { "type": "integer" }, "nullPopFq": { "type": "integer" } } } } }, "location": { "type": "object", "properties": { "type": { "type": "string" }, "label": { "type": "object", "properties": { "eng": { "type": "string" } } } } } } } }, "categories": { "type": "array", "items": { "type": "object", "properties": { "uri": { "type": "string" }, "label": { "type": "string" }, "wgt": { "type": "integer" } } } }, "links": { "type": "array", "items": { "type": "string" } }, "videos": { "type": "array", "items": { "type": "string" } }, "image": { "type": "string" }, "duplicateList": { "type": "array", "items": { "type": "string" } }, "originalArticle": { "type": "string" }, "eventUri": { "type": "string" }, "location": { "type": "object", "properties": { "type": { "type": "string" }, "label": { "type": "object", "properties": { "eng": { "type": "string" } } } } }, "extractedDates": { "type": "array", "items": { "type": "object", "properties": { "amb": { "type": "boolean" }, "imp": { "type": "boolean" }, "date": { "type": "string" }, "textStart": { "type": "integer" }, "textEnd": { "type": "integer" } } } }, "shares": { "type": "object", "properties": { "facebook": { "type": "integer" } } }, "wgt": { "type": "integer" } } }, "storyDate": { "type": "string" }, "isUserSetDate": { "type": "boolean" }, "extractedDate": { "type": "string" }, "averageDate": { "type": "string" }, "images": { "type": "array", "items": { "type": "string" } }, "commonDates": { "type": "array", "items": { "type": "object", "properties": { "amb": { "type": "boolean" }, "imp": { "type": "boolean" }, "date": { "type": "string" }, "textStart": { "type": "integer" }, "textEnd": { "type": "integer" }, "freq": { "type": "integer" } } } }, "socialScore": { "type": "double" }, "wgt": { "type": "integer" } } } }, "eventDate": { "type": "string" }, "totalArticleCount": { "type": "integer" }, "title": { "type": "object", "properties": { "eng": { "type": "string" } } }, "summary": { "type": "object", "properties": { "eng": { "type": "string" } } }, "location": { "type": "object", "properties": { "type": { "type": "string" }, "label": { "type": "object", "properties": { "eng": { "type": "string" } } } } }, "categories": { "type": "object", "properties": { "uri": { "type": "string" }, "label": { "type": "string" }, "wgt": { "type": "integer" } } }, "images": { "type": "array", "items": { "type": "string" } }, "articleCounts": { "type": "object", "properties": { "eng": { "type": "integer" } } }, "socialScore": { "type": "double" }, "commonDates": { "type": "array", "items": { "type": "object", "properties": { "amb": { "type": "boolean" }, "imp": { "type": "boolean" }, "date": { "type": "string" }, "textStart": { "type": "integer" }, "textEnd": { "type": "integer" }, "freq": { "type": "integer" } } } }, "wgt": { "type": "integer" } } } } } } } } } } ```