An Alert object represents a single event captured by Craft for a particular company.
UUID to identify this Alert document
Dataset represents the type of source data used to generate this alert
Class of the Alert. Contains machine-friendly
"code" as well as human-readable "label" fields.
Summary describing the Alert contents
Full text of the Alert
Represents news source URL for Alerts from the "news" dataset
Stores the value of the dataset at the point when Alert was created
Describes the variable from the dataset which was used to create the Alert
Represents the polarity (sentiment) of the signal. Typical values are: -1 - negative polarity 0 - neutral 1 - positive polarity
Holds additional data about the Company, Alert belongs to. May be "null" in case Alert is related to multiple companies at the same time, when none of them is specifically an Alert target.
For example, a change of the aluminum price may affect many dependent manufacturers, but being a result of overall market movement, rather than an Alert for a specific company.
Contains all the companies related to the parent Alert.
For example, a change of the steel price may affect multiple manufacturers.
When filtering by
Holds additional metadata related to the specific Alert.
Please, note that the metadata structure varies depending on the Alert's dataset, variable and class. You may find examples of
Resource that is affected by the given Alert, such as steel, coal, oil, etc. May be missing for Alerts from the datasets that are describing other type of events.
Defines the time window over which the change of variable was detected
ISO 8601 timestamp when Alert was published by Craft
ISO 8601 timestamp of change in the tracked value causing this Alert to be created.
Represents the category of changes that are described by an Alert.
URL-friendly class code
A human-readable version of the Alert's class
Company ID which can be used to query additional Company data from the
A human-readable company name. Same as
Company's homepage URL. Same as
A Resource that is affected by the given Alert, such as
oil, etc. May be missing for Alerts from the datasets that are describing other types of events.
Resource ID, such as:
General category of the resource, for example: