NDJSON Data Structure for ADX
Data can be provided as NDJSON, CSV or Parquet. This document describes the NDJSON data structure.
Field | Description |
---|---|
| The unique identifier of the event. |
| Used to indicate if this event is part of a larger event. These types of events are called umbrella events in the system. For example, a large multi-day parent umbrella event may have individual child events for sessions on different days. This field only shows if a child event has a parent id. It does not indicate if a parent event has child events. For details see our Umbrella Events docs. |
| The title of the event. |
| The description of the event. |
| The category of the event. |
| The labels associated with the event. Use the count endpoint to fetch a list of available labels. |
| A log scale numerical value between 0 and 100 with a five-level hierarchical impact schema. It is designed to represent the potential impact of an event independent of its geographical location. See also our PHQ Rank docs. |
| Similar to PHQ Rank, this is a log scale numerical value between 0 and 100 with a five-level hierarchical impact schema. It is designed to represent the potential impact of an event on its local geographical area. Local Rank is calculated for events in the categories community, concerts, conferences, expos, sports, festivals, performing-arts. If local_rank is not intended to be available for an event, this field will be See also our Local Rank docs. |
| A log scale numerical value between 0 and 100 with a five-level hierarchical impact schema. Aviation Rank indicates how much an event will impact flight bookings by considering both domestic and international travel. It can be mapped to the predicted increase in demand based on people flying to an event. Therefore, events with higher Aviation Rank are expected to result in more people taking flights than lower Aviation Rank events. Aviation Rank is calculated for events in the categories concerts, conferences, expos, sports, festivals, performing-arts, observances, public-holidays, and school-holidays. If aviation_rank is not intended to be available for an event or we couldn't calculate it, this field will be null. See also our Aviation Rank docs. |
|
For details see our Predicted Attendance guide. |
| An array of entities linked to the event. This is a complex data type, please see Events API for details. |
| Not directly corresponding to a previous field, but relates to the difference in seconds between EVENT_START and EVENT_END. |
| The date and time that the event starts in UTC. |
| The date and time that the event ends in UTC. |
| The date and time the event was last updated in UTC. |
| The date and time the event was first seen by PredictHQ in UTC. |
| The time zone of the event in TZ Database format. |
| This field seems to provide geographic coordinates derived from GEO. |
| The geographic details (location) of the event in GeoJSON format. |
| Also known as “Demand impact patterns”. This field shows impact for leading days (days before the event), lagging days (days after an event) and the days the event occurs. It contains details such as the industry vertical the impact pattern applies to, the type of impact shown in the impact pattern, and an array of objects for each day showing the date in the local timezone of the event and the value of the impact_type for that given day. |
| The geographical scope the events apply to. |
| The Placekey identifier for the physical address where the event takes place. See Placekey. This field will be |
| The country code in ISO 3166-1 alpha-2 format. |
| An array of place hierarchies for the event. Each hierarchy is an array of place ids. The final place in a hierarchy is a specific place the event applies to. Each place is a sub-place of the place immediately preceding it in the hierarchy. An empty array is possible and valid. See also the Place Hierarchies guide. |
| The publication state of the event. Possible values:
|
| Whether or not this event is considered brand-safe. Examples of brand-unsafe events include content that promotes hate, violence, or discrimination, coarse language, content that is sexually suggestive or explicit, etc. |
| The date and time the event was set to cancelled in UTC. |
| The date and time the event was set to postponed in UTC. |
| An object containing predicted event spend for various industries like accommodation, hospitality, and transportation. See Events API docs. |
| The PHQ Labels associated with the event. This field will be |
| The date and time that PredictHQ predicts that the physical event being broadcast will end, in the timezone of the event. |
| Indicates if the record has been updated, deleted or inserted. Use when processing the data file to keep your database updated.
|
Last updated
Was this helpful?