Source: https://shakti.eventregistry.org/documentation?tab=terminology

# Terminology

Event Registry imports news articles with an extensive set of meta-data and extracts additional information, such as events and stories. All this information is available to be returned as the result of the various API requests. The information about the different types of objects that can be returned is described below.

## Article

An article is a news article that we collect and import into the Event Registry. Articles are collected using RSS feeds and contain properties such as title, body, date, time, source (news publisher), image, a list of concepts (see below), a list of categories (see below), a list of extracted dates (dates mentioned in the article) and others. Available information that Event Registry can provide for an article is described in the [Article data model page](/documentation?tab=data_models).

## Event

In short, an event is a collection of news articles (potentially in different languages) that discuss the same thing that happened. Each event can provide various properties, such as title and summary (in all available languages), date, location, list of stories, article count, a list of concepts, a list of categories, a list of frequently mentioned dates and others. Available information that can be provided about an event is described in the [Event data model page](/documentation?tab=data_models).

## Concept

A concept is an annotation that can be assigned to an article, story or event. Concepts can represent entities (people, locations, organizations) or non-entities/keywords (things such as table, personal computer, toy, robot, ...). All concepts have a unique ID called [URI](https://en.wikipedia.org/wiki/Uniform_Resource_Identifier). In Event Registry, we use Wikipedia's URLs as concept URIs. The concept URI for Barack Obama is for example [https://en.wikipedia.org/wiki/Barack_Obama](https://en.wikipedia.org/wiki/Barack_Obama). Each concept can have various properties, such as labels in different languages, synonyms, image and description. Concepts are very important since they allow you to search for things based on the thing itself and not using a keyword. For example, if you want to find all articles that mention White House, you can't use the keyword "White House" to find articles in Spanish, since there it is written as "Casa Blanca". If you use the concept URI for White House ([https://en.wikipedia.org/wiki/White_House](https://en.wikipedia.org/wiki/White_House)) you can, however, retrieve mentions of White House in all languages.

As mentioned, concepts are assigned to articles, stories, and events. A concept is associated with the article if it is mentioned in it. There is also a score assigned to the mentioned concept which is in the range between 1 (the concept is not very relevant for the article) and 5 (the concept is very relevant for the article). Similarly, a concept can be associated with a story or event. Stories and events are assigned concepts that are common in the containing articles. The score assigned to the concepts, in this case, represents the importance of the concept for the story/event and can be in the range 0 - 100.

Available information that can be provided about a concept is described in the [Concept data model page](/documentation?tab=data_models).

In order to get concept's URI for a given label, you can use the utility method "EventRegistry.getConceptUri()". In case the method returns None you have to perform the search using the label as a keyword.

## Category

Event Registry uses three taxonomies of categories - DMOZ (from [DMOZ](https://dmoz-odp.com/)), IPTC and News taxonomy. Each category has a unique identifier (URI) that can be used when querying using the `categoryUri` parameter. Available information that can be provided about a category is described in the [Category data model page](/documentation?tab=data_models). When specifying a category in the query, the results will also include any child categories of the specified category.

- **IPTC taxonomy** - the standard [IPTC Media Topics](https://www.iptc.org/standards/media-topics/) taxonomy used across the news industry to classify content into a well-established set of media topics. The taxonomy was introduced on June 1st, 2026 so articles published prior to that date are not categorized using this taxonomy. The categories from this taxonomy are assigned to articles in all languages. There are about 1.400 categories in this hierarchially structured taxonomy.
  [Download list of IPTC categories](https://eventregistry.org/static/categorization/iptc.txt)
- **DMOZ taxonomy** - a large hierarchical taxonomy derived from the [DMOZ](https://dmoz-odp.com/) web directory. We use the top 3 levels, amounting to about 4.300 categories. The categories from this taxonomy are assigned only to articles in English language.
  [Download list of DMOZ categories](https://eventregistry.org/static/categorization/dmoz.txt)
- **News taxonomy** - a small set of broad news categories (such as `news/Business`, `news/Politics` and `news/Technology`) that are assigned to articles in all languages. Categories correspond to names that typically appear in the navigation bar of news sources. There are 8 categories in this taxonomy.
  [Download list of News categories](https://eventregistry.org/static/categorization/news.txt)

Categories are assigned to articles, stories and events using machine learning models that are trained for each category separately. Categories don't represent a particular mention in the articles/stories/events, but instead represent what topic the content is about.

## Source

Each article has a news source. A news source can have properties such as URI (hostname), title, description, location (geographical location) and importance. Available information that can be provided about a news source is described in the [News source data model page](/documentation?tab=data_models).

## Location

A location in Event Registry stands for a geographical location and can be associated with stories, events, news sources (location of the publisher) and certain concepts (those that represent locations). Information about geographical locations are obtained from [GeoNames](http://www.geonames.org/). Details that can be returned about a geographical location include GeoNames id, wiki URL (URL of the corresponding Wikipedia page), population, geolocation, area, continent and others.
