Source: https://eventregistry.org/documentation?tab=feedOfEvents

# Stream of events

The stream of events that were added or updated in the last few minutes.

The API endpoint allows the user to obtain the full list of events that were added or updated in Event Registry in the last few minutes. The endpoint can be used without any additional filters, which will return all added or updated events. Alternatively, you can specify filters to return only events in a certain language, from specific locations, mentioning specific keywords, concepts, etc. This is the only API call that also allows returning more than 50 events per call. If more than 50 events are returned, then correspondingly higher number of tokens are used per call.

**Endpoint:** GET | POST `https://eventregistry.org/api/v1/minuteStreamEvents`

**Headers:** Content-Type: application/json

#### `Parameters`

#### `apiKey`

string (required)

Your API key

#### `recentActivityEventsMaxEventCount`

integer

The maximum number of events to return. Maximum value specified can be 2.000. The number of used tokens will correspond to the number of returned events. For 200 returned events, for example, 4*5 tokens will be used - 5 tokens for each 50 events.

Default value: `50`

#### `recentActivityEventsUpdatesAfterMinsAgo`

integer

The parameter can be used to retrieve not only the last minute of events, but more minutes. When using some filtering parameters below you use can use this parameter to call `minuteStreamEvents` endpoint only every few minutes and still retrieve all added content matching your filters. The value should be at most 240 (4 hours).

#### `recentActivityEventsUpdatesAfterTm`

string

The parameter can be used to retrieve events that were updated after the specified time. The value should be in format `YYYY-MM-DDTHH:MM:SS` and should represent datetime in UTC timezone. The value should be at most 4 hours in the past.

#### `Additional Parameters`

Click to see additional parameters.

#### `keyword`

string | string[]

Find events in which news articles mention the specified keyword or a phrase. If you specify multiple `keyword` parameters, then only events with 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.

Default value: `Barack Obama`

#### `conceptUri`

string | string[]

Find events for which the concept with concept uri is important. You can specify up to 50 concepts in a single search. If multiple `conceptUri` parameters are provided, then only events 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.

Default value: `http://en.wikipedia.org/wiki/World_Health_Organization`

#### `categoryUri`

string | string[]

Find events that are about a particular category. You can specify up to 20 categories in a single search. If multiple `categoryUri` parameters are provided, then events 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.

Default value: `dmoz/Business/Accounting`

#### `sourceUri`

string | string[]

Find events that contain one or more articles that have been written by a specific news source. Check [autosuggest methods](/documentation?tab=suggSources) to get value for a source name.

Default value: `bbc.co.uk`

#### `sourceLocationUri`

string | string[]

Find events that contain one or more articles by news sources located at the given geographic location (city or a country). Check [autosuggest methods](/documentation?tab=suggLocations) to get value for a location name.

Default value: `http://en.wikipedia.org/wiki/Germany`

#### `sourceGroupUri`

string | string[]

Find events that contain one or more articles by news sources that are assigned to the predefined group of news sources.

Default value: `general/ERtop10`

#### `authorUri`

string | string[]

Find events that contain 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).

Default value: `mark_mazzetti@nytimes.com`

#### `locationUri`

string | string[]

Find events that occurred at a particular geographic location. Check [autosuggest methods](/documentation?tab=suggLocations) to get URI value for a given location name.

Example value: `http://en.wikipedia.org/wiki/United_States`

#### `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 about an event; if `or` then an event will be returned if it's articles 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 event; if `or` then an event 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 event; if `or` then an event will be returned if it mentions any of the provided categories.

Available values: `and`, `or`

Default value: `or`

#### `lang`

string | string[]

Find events that contain articles in the specified language(s). You can specify at most 5 languages in a single search. Specify languages using their ISO3 language codes. The full list of languages and their ISO3 codes can be found on [this page](https://github.com/EventRegistry/event-registry-python/wiki/Supported-languages).

Example value: `eng`

#### `minArticlesInEvent`

integer

Find events that have been reported in at least `minArticlesInEvent` articles (regardless of language).

#### `maxArticlesInEvent`

integer

Find events that have not been reported in more than `maxArticlesInEvent` articles (regardless of 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 the stream of events that were added/updated in the last minute.

Request body:

```json
{
  "apiKey": "YOUR_API_KEY"
}
```

```python
from eventregistry import *
er = EventRegistry(apiKey = YOUR_API_KEY)

recentQ = GetRecentEvents(er)

starttime = time.time()
while True:
    eventList = recentQ.getUpdates()
    print("=======
%d events were added since the last call" % len(eventList))

    for event in eventList:
        print(event)

    print("sleeping for 60 seconds...")
    time.sleep(60.0 - ((time.time() - starttime) % 60.0))
```

```javascript
var er = new erBase.EventRegistry();
                    var recentQ = new erBase.GetRecentEvents(er);

                    function fetchUpdates() {
                        return recentQ.getUpdates().then((eventList) => {
                            for (var i = 0; i < eventList.length; i++) {
                                console.info(`Added event ${eventList[i]["uri"]}: ${eventList[i]["title"]}`);
                            }
                            return sleep(60 * 1000);
                        }).then(() => {
                            return fetchUpdates();
                        });
                    }

                    fetchUpdates();
```

```typescript
const er = new EventRegistry();
                    const recentQ = new GetRecentEvents(er);

                    async function fetchUpdates() {
                        const eventList = await recentQ.getUpdates();
                        for (let i = 0; i < eventList.length; i++) {
                            console.info(`Added event ${eventList[i]["uri"]}: ${eventList[i]["title"]}`);
                        }
                        await sleep(60 * 1000);
                        fetchUpdates();
                    }

                    fetchUpdates();
```

### Example 2

Get the stream of events that were added/updated in the last 10 minutes which are about Tesla Inc. and associated with category Business. Since there are filters specified, the list of matching events per minute will be relatively low so we can extend and return not only events from the last minute but from last 10 minutes. We also increased the maximum number of events that can be retrieved (note that the number of used tokens will increase for each 50 returned events).

Request body:

```json
{
  "conceptUri": "http://en.wikipedia.org/wiki/Tesla,_Inc.",
  "categoryUri": "news/Business",
  "recentActivityEventsUpdatesAfterMinsAgo": 10,
  "recentActivityEventsMaxEventCount": 2000,
  "apiKey": "YOUR_API_KEY"
}
```

```python
from eventregistry import *
er = EventRegistry(apiKey = YOUR_API_KEY)

query = QueryEvents(
    conceptUri = "http://en.wikipedia.org/wiki/Tesla,_Inc.",
    categoryUri = "news/Business"
);
query.setRequestedResult(
    RequestEventsRecentActivity(
        maxEventCount = 2000,
        updatesAfterMinsAgo = 10
    )
);

while True:
    starttime = time.time()
    eventList = er.execQuery(query)
    print("=======
%d events were added since the last call" % len(eventList))

    for event in eventList:
        print("Added event %s: %s" % (event["uri"], event["title"].encode("ascii", "ignore")))

    print("sleeping for 600 seconds...")
    time.sleep(600.0 - (time.time() - starttime))
```

```javascript
var er = new erBase.EventRegistry();
                    var query = new erBase.QueryEvents({
                        conceptUri: "http://en.wikipedia.org/wiki/Tesla,_Inc.",
                        categoryUri: "news/Business",
                    });
                    query.setRequestedResult(
                        new erBase.RequestEventsRecentActivity({
                            maxEventCount: 2000,
                            updatesAfterMinsAgo: 10,
                        })
                    );

                    function fetchUpdates() {
                        return er.execQuery(query).then((eventList) => {
                            for (var i = 0; i < eventList.length; i++) {
                                console.info(`Added event ${eventList[i]["uri"]}: ${eventList[i]["title"]}`);
                            }
                            return sleep(60 * 1000);
                        }).then(() => {
                            return fetchUpdates();
                        });
                    }

                    fetchUpdates();
```

```typescript
const er = new EventRegistry();
                    const query = new QueryEvents({
                        conceptUri: "http://en.wikipedia.org/wiki/Tesla,_Inc.",
                        categoryUri: "news/Business",
                    });
                    query.setRequestedResult(
                        new RequestEventsRecentActivity({
                            maxEventCount: 2000,
                            updatesAfterMinsAgo: 10,
                        })
                    );

                    async function fetchUpdates() {
                        const eventList = await er.execQuery(query);
                        for (let i = 0; i < eventList.length; i++) {
                            console.info(`Added event ${eventList[i]["uri"]}: ${eventList[i]["title"]}`);
                        }
                        await sleep(60 * 1000);
                        fetchUpdates();
                    }

                    fetchUpdates();
```

## Example output

```json
{
  "recentActivityEvents": {
    "newestUpdate": "2023-05-16T11:07:58.342",
    "oldestUpdate": "2023-05-16T11:07:12.266",
    "activity": [
      "eng-8624106",
      "deu-1635754",
      "pol-152777",
      "ind-741983",
      "eng-8624002",
      "sqi-83687",
      "fas-642953",
      "fas-642178",
      "fas-642943",
      "zho-1414545",
      "ind-741365",
      "ron-248653",
      "spa-3115666",
      "fas-642894",
      "eng-8621864",
      "hin-287124",
      "hin-287045",
      "deu-1635749",
      "zho-1415012",
      "ind-741022",
      "ind-741907",
      "ind-741373",
      "ell-751393",
      "rus-1457454",
      "spa-3117873",
      "eng-8624267",
      "eng-8625328",
      "eng-8624640",
      "eng-8624485",
      "ita-559618",
      "eng-8623918",
      "eng-8622094",
      "eng-8618712",
      "tur-953964",
      "deu-1635670",
      "fas-642526",
      "ell-751387",
      "bul-218336",
      "eng-8624532",
      "eng-8622354",
      "eng-8622578",
      "eng-8624240",
      "eng-8621026",
      "eng-8624195",
      "eng-8622227",
      "eng-8623655",
      "eng-8620751",
      "eng-8622227",
      "eng-8622833",
      "eng-8625399"
    ],
    "eventInfo": {
      "eng-8624106": {
        "uri": "eng-8624106",
        "concepts": [
          {
            "uri": "http://en.wikipedia.org/wiki/Cannes_Film_Festival",
            "type": "wiki",
            "score": 100,
            "label": {
              "eng": "Cannes Film Festival"
            }
          },
          {
            "uri": "http://en.wikipedia.org/wiki/Cannes",
            "type": "loc",
            "score": 86,
            "label": {
              "eng": "Cannes"
            },
            "location": {
              "type": "place",
              "label": {
                "eng": "Cannes"
              },
              "country": {
                "type": "country",
                "label": {
                  "eng": "France"
                }
              }
            }
          },
          {
            "uri": "http://en.wikipedia.org/wiki/Johnny_Depp",
            "type": "person",
            "score": 84,
            "label": {
              "eng": "Johnny Depp"
            }
          }
        ],
        "eventDate": "2023-05-15",
        "totalArticleCount": 293,
        "title": {
          "eng": "Cannes director defends festival after Adèle Haenel slams French...",
          "spa": "PREVIA-El Festival de Cannes 2023 arranca con un cartel \"sin relleno\"",
          "ita": "Festival Cannes 2023 programma: date, calendario film e divi attesi |Style",
          "fra": "Le Festival de Cannes ouvre et réhabilite Johnny Depp",
          "por": "Estrelas e destaques do festival de Cannes 2023",
          "deu": "Wim Wenders, \"Indiana Jones\" und Scorsese in Cannes",
          "hrv": "Filmski festival u Cannesu otvara povratnička drama Johnnyja Deppa"
        },
        "summary": {
          "eng": "CANNES, France (AP) - After one of France's top actors, Adèle Haenel, announced she was quitting a French film industry that she denounced for \"complacency toward sexual aggressors,\" Cannes Film Festival chief Thierry Fremaux rejected her criticisms while addressing members of the media Monday.\n\nHaenel, star of the 2019 Cannes entry \"Portrait of a Lady on Fire,\" last week published an open letter in the Telerama magazine in which the 34-year-old said Cannes and other pillars of the French film i",
          "spa": "CANNES (Reuters) - Cannes, la ciudad de la Costa Azul francesa, se convierte esta semana en el epicentro de la industria cinematográfica con el arranque de la 76ª edición del glamuroso festival, que promete grandes éxitos de taquilla, nuevos talentos y un toque de polémica.\n\n\"Tenemos 'Indiana Jones', tenemos la nueva película de Martin Scorsese con Leonardo DiCaprio. Tenemos una película de Wes Anderson repleta de todas las estrellas que se puedan nombrar y una especie de 'quién es quién",
          "ita": "Il calendario del festival, con le date dei film in concorso per la Palma d'Oro e quelle dei kolossal fuori concorso, con gli arrivi dei divi protagonisti. Soprattutto: ecco quando scendono in gara i tre italiani...\n\nTutto è pronto per la serata d'apertura del Festival di Cannes 2023: dal 16 al 27 maggio, il cinema mondiale si dà appuntamento sulla Croisette. Ecco il calendario dei film in concorso e di quelli fuori concorso. Per sapere quando tifare per i nostri Bellocchio, Moretti e Rohrwache",
          "fra": "Cannes: avec \"Jeanne du Barry\", Maïwenn et Johnny Depp s'essayent au \"classique\"\n\nAFP, publié le mardi 16 mai 2023 à 05h54\n\nLe Festival de Cannes ouvre mardi en offrant un retour en forme de réhabilitation à l'acteur Johnny Depp, très contesté depuis les procès qui l'ont opposé à son ex-épouse sur fond d'accusations de violences conjugales.\n\nAvant une cérémonie d'ouverture pilotée par l'actrice Chiara Mastroianni, et que les opposants à la réforme des retraites pourraient être te",
          "por": "Com sua localização pitoresca na Riviera Francesa e um histórico de longa data, Cannes continua sendo o festival de cinema de maior prestígio da Europa. Este ano marca sua 76ª edição, que acontece de 16 a 27 de maio e, como sempre, terá a participação de diversos nomes de peso.\n\nO festival abre com o filme Jeanne du Barry, estrelado por Johnny Depp como o rei Luís 15. No filme, o monarca se apaixona por uma jovem de origem proletária e faz dela sua última amante.\n\nA protagonista femi",
          "deu": "Cannes - Wim Wenders im Rennen um die Goldene Palme, eine neue, deutsche Präsidentin - und eine Schauspielerin aus Deutschland, die in gleich zwei Wettbewerbs-Filmen mitspielt. Das erwartet hiesige Filmfans dieses Jahr in Cannes - neben erwarteten Auftritten von Stars wie Leonardo DiCaprio, Scarlett Johansson, Natalie Portman oder Tom Hanks. Wenn die 76. Filmfestspiele kommenden Dienstag (16. Mai) starten, ist Regisseur Wenders unter den 21 Filmschaffenden, die um die Goldene Palme konkurrieren.",
          "hrv": "Filmski festival u Cannesu spreman je za buran početak u utorak, a Johnny Depp se vratio u uvodnom filmu, pokazujući svoje francuske vještine kao kralj Louis XV.\n\nKarijera tog 59-godišnjaka u Hollywoodu je u padu uprkos njegovoj pobjedi na prošlogodišnjem suđenju za klevetu protiv bivše supruge Amber Heard koje je uključivalo ogorčene optužbe za nasilje u porodici.\n\nDepp se, međutim, postepeno vraća na posao i na crvenom će tepihu premijerne večeri u Cannesu predstaviti francusku d"
        },
        "location": {
          "type": "place",
          "label": {
            "eng": "Cannes"
          },
          "country": {
            "type": "country",
            "label": {
              "eng": "France"
            }
          }
        },
        "categories": [
          {
            "uri": "dmoz/Arts/Movies/Cultures_and_Groups",
            "label": "dmoz/Arts/Movies/Cultures and Groups",
            "wgt": 98
          },
          {
            "uri": "dmoz/Arts/Movies/Organizations",
            "label": "dmoz/Arts/Movies/Organizations",
            "wgt": 100
          },
          {
            "uri": "dmoz/Arts/Movies/Film_Festivals",
            "label": "dmoz/Arts/Movies/Film Festivals",
            "wgt": 99
          },
          {
            "uri": "news/Arts_and_Entertainment",
            "label": "news/Arts and Entertainment",
            "wgt": 98
          }
        ],
        "articleCounts": {
          "eng": 67,
          "spa": 57,
          "ita": 41,
          "fra": 68,
          "por": 27,
          "deu": 24,
          "hrv": 9
        },
        "sentiment": 0.09019607843137245
      }
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "properties": {
    "recentActivityEvents": {
      "type": "object",
      "properties": {
        "activity": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "eventInfo": {
          "type": "object",
          "properties": {
            "eventUri": {
              "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"
                }
              }
            }
          }
        }
      }
    }
  }
}
```
