Introducing the Forecasts API — Event-driven forecasts for precise demand planning. Fast, accurate, and easy to run.
Explore Now
LogoLogo
Visit websiteWebAppGet DemoTry for Free
  • Introduction
  • Swagger UI
  • Loop
  • System Status
  • Getting Started
    • API Quickstart
    • Data Science Notebooks
    • PredictHQ Data
      • Data Accuracy
      • Event Categories
        • Attendance-Based Events
        • Non-Attendance-Based Events
        • Unscheduled Events
        • Live TV Events
      • Labels
      • Entities
      • Ranks
        • PHQ Rank
        • Local Rank
        • Aviation Rank
      • Predicted Attendance
      • Predicted End Times
      • Predicted Event Spend
      • Predicted Events
      • Predicted Impact Patterns
    • Guides
      • Geolocation Guides
        • Overview
        • Searching by Location
          • Find Events by Latitude/Longitude and Radius
          • Find Events by Place ID
          • Find Events by IATA Code
          • Find Events by Country Code
          • Find Events by Placekey
          • Working with Location-Based Subscriptions
        • Understanding Place Hierarchies
        • Working with Polygons
        • Join Events using Placekey
      • Date and Time Guides
        • Working with Recurring Events
        • Working with Multi-day and Umbrella Events
        • Working with Dates, Times and Timezones
      • Events API Guides
        • Understanding Relevance Field in Event Results
        • Attendance-Based Events Notebooks
        • Non-Attendance-Based Events Notebooks
        • Severe Weather Events Notebooks
        • Academic Events Notebooks
        • Working with Venues Notebook
      • Features API Guides
        • Increase Accuracy with the Features API
        • Get ML Features
        • Demand Forecasting with Event Features
      • Forecasts API Guides
        • Getting Started with Forecasts API
        • Understanding Forecast Accuracy Metrics
        • Troubleshooting Guide for Forecasts API
      • Live TV Event Guides
        • Find Broadcasts by County Place ID
        • Find Broadcasts by Latitude and Longitude
        • Find all Broadcasts for an Event
        • Find Broadcasts for Specific Sport Types
        • Aggregating Live TV Events
        • Live TV Events Notebooks
      • Beam Guides
        • ML Features by Location
        • ML Features by Group
      • Demand Surge API Guides
        • Demand Surge Notebook
      • Guide to Protecting PredictHQ Data
      • Streamlit Demo Apps
      • Guide to Bulk Export Data via the WebApp
      • Industry-Specific Event Filters
      • Tutorials
        • Filtering and Finding Relevant Events
        • Improving Demand Forecasting Models with Event Features
        • Using Event Data in Power BI
        • Using Event Data in Tableau
        • Connecting to PredictHQ APIs with Microsoft Excel
        • Loading Event Data into a Data Warehouse
        • Displaying Events in a Heatmap Calendar
        • Displaying Events on a Map
    • Tutorials by Use Case
      • Demand Forecasting with ML Models
      • Dynamic Pricing
      • Inventory Management
      • Workforce Optimization
      • Visualization and Insights
  • Integrations
    • Integration Guides
      • Keep Data Updated via API
      • Integrate with Beam
      • Integrate with Loop Links
    • Third-Party Integrations
      • Receive Data via Snowflake
        • Example SQL Queries for Snowflake
        • Snowflake Data Science Guide
          • Snowpark Method Guide
          • SQL Method Guide
      • Receive Data via AWS Data Exchange
        • CSV/Parquet Data Structure for ADX
        • NDJSON Data Structure for ADX
      • Integrate with Databricks
      • Integrate with Tableau
      • Integrate with a Demand Forecast in PowerBI
      • Google Cloud BigQuery
    • PredictHQ SDKs
      • Python SDK
      • Javascript SDK
  • API Reference
    • API Overview
      • Authenticating
      • API Specs
      • Rate Limits
      • Pagination
      • API Changes
      • Attribution
      • Troubleshooting
    • Events
      • Search Events
      • Get Event Counts
    • Broadcasts
      • Search Broadcasts
      • Get Broadcasts Count
    • Features
      • Get ML Features
    • Forecasts
      • Models
        • Create Model
        • Update Model
        • Replace Model
        • Delete Model
        • Search Models
        • Get Model
        • Train Model
      • Demand Data
        • Upload Demand Data
        • Get Demand Data
      • Forecasts
        • Get Forecast
      • Algorithms
        • Get Algorithms
    • Beam
      • Create an Analysis
      • Upload Demand Data
      • Search Analyses
      • Get an Analysis
      • Update an Analysis
      • Partially Update an Analysis
      • Get Correlation Results
      • Get Feature Importance
      • Refresh an Analysis
      • Delete an Analysis
      • Analysis Groups
        • Create an Analysis Group
        • Get an Analysis Group
        • Search Analysis Groups
        • Update an Analysis Group
        • Partially Update an Analysis Group
        • Refresh an Analysis Group
        • Delete an Analysis Group
        • Get Feature Importance for an Analysis Group
    • Demand Surge
      • Get Demand Surges
    • Suggested Radius
      • Get Suggested Radius
    • Saved Locations
      • Create a Saved Location
      • Search Saved Locations
      • Get a Saved Location
      • Search Events for a Saved Location
      • Update a Saved Location
      • Delete a Saved Location
    • Loop
      • Loop Links
        • Create a Loop Link
        • Search Loop Links
        • Get a Loop Link
        • Update a Loop Link
        • Delete a Loop Link
      • Loop Settings
        • Get Loop Settings
        • Update Loop Settings
      • Loop Submissions
        • Search Submitted Events
      • Loop Feedback
        • Search Feedback
    • Places
      • Search Places
      • Get Place Hierarchies
  • WebApp Support
    • WebApp Overview
      • Using the WebApp
      • API Tools
      • Events Search
      • How to Create an API Token
    • Getting Started
      • Can I Give PredictHQ a Go on a Free Trial Basis?
      • How Do I Get in Touch if I Need Help?
      • Using AWS Data Exchange to Access PredictHQ Events Data
      • Using Snowflake to Access PredictHQ Events Data
      • What Happens at the End of My Free Trial?
      • Export Events Data from the WebApp
    • Account Management
      • Managing your Account Settings
      • How Do I Change My Name in My Account?
      • How Do I Change My Password?
      • How Do I Delete My Account?
      • How Do I Invite People Into My Organization?
      • How Do I Log In With My Google or LinkedIn Account?
      • How Do I Update My Email Address?
      • I Signed Up Using My Google/LinkedIn Account, but I Want To Log In With My Own Email
    • API Plans, Pricing & Billing
      • Do I Need To Provide Credit Card Details for the 14-Day Trial?
      • How Do I Cancel My API Subscription?
      • Learn About Our 14-Day Trial
      • What Are the Definitions for "Storing" and "Caching"?
      • What Attribution Do I Have To Give PredictHQ?
      • What Does "Commercial Use" Mean?
      • What Happens If I Go Over My API Plan's Rate Limit?
    • FAQ
      • How Does PredictHQ Support Placekey?
      • Using Power BI and Tableau With PredictHQ Data
      • Can I Download a CSV of Your Data?
      • Can I Suggest a New Event Category?
      • Does PredictHQ Have Historical Event Data?
      • Is There a PredictHQ Mobile App?
      • What Are Labels?
      • What Countries Do You Have School Holidays For?
      • What Do The Different Event Ranks Mean?
      • What Does Event Visibility Window Mean?
      • What Is the Difference Between an Observed Holiday and an Observance?
    • Tools
      • Is PHQ Attendance Available for All Categories?
      • See Event Trends in the WebApp
      • What is Event Trends?
      • Live TV Events
        • What is Live TV Events?
        • Can You Access Live TV Events via the WebApp?
        • How Do I Integrate Live TV Events into Forecasting Models?
      • Labels
        • What Does the Closed-Doors Label Mean?
    • Beam (Relevancy Engine)
      • An Overview of Beam - Relevancy Engine
      • Creating an Analysis in Beam
      • Uploading Your Demand Data to Beam
      • Viewing the List of Analysis in Beam
      • Viewing the Table of Results in Beam
      • Viewing the Category Importance Information in Beam
      • Feature Importance With Beam - Find the ML Features to Use in Your Forecasts
      • Beam Value Quantification
      • Exporting Correlation Data With Beam
      • Getting More Details on a Date on the Beam Graph
      • Grouping Analyses in Beam
      • Using the Beam Graph
      • Viewing the Time Series Impact Analysis in Beam
    • Location Insights
      • An Overview of Location Insights
      • How to Set a Default Location
      • How Do I Add a Location?
      • How Do I Edit a Location?
      • How Do I Share Location Insights With My Team?
      • How Do I View Details for One Location?
      • How Do I View My Saved Locations as a List?
      • Search and View Event Impact in Location Insights
      • What Do Each of the Columns Mean?
      • What Is the Difference Between Center Point & Radius and City, State, Country?
Powered by GitBook

PredictHQ

  • Terms of Service
  • Privacy Policy
  • GitHub

© 2025 PredictHQ Ltd

On this page
  • Categories
  • Sports
  • Conferences
  • Expos
  • Concerts
  • Festivals
  • Performing Arts
  • Community
  • Academic

Was this helpful?

  1. Getting Started
  2. PredictHQ Data
  3. Event Categories

Attendance-Based Events

Attended Events are gatherings with a start and end date/time, where people come together in one location for entertainment or business.

Categories

Sports

A sports competition consists of multiple players or teams. It has a certain theme or goals with its own rules to regulate and a dedicated environment as well.

Labels

Labels for a sports event provide more information about the type, league, and environment.

  1. Sports Type

    The most common sports types in PredictHQ dataset are: soccer, basketball, ice-hockey, rugby, baseball.

  2. Sports League

    The most popular sports leagues in the PredictHQ dataset are: NFL, MLB, NHL, NBA.

  3. Sports Games Environment

    The general environment where the sports game is held, or the purpose of the sports game, for example:

    • closed-doors: When the sports game has no physical audience in attendance. This is most commonly due to COVID-19 restrictions.

    • outdoors: Where the sports game is held in an outdoor area.

    • fundraise: A community-related sports game for fundraising purposes.

  4. Youth Sports

    • These events have the youth-sport label

    • These events are defined as any sports event where competitors are younger than adult age, whether children or adolescents. Youth sports include school sports at primary and secondary level, as well as sports played outside the education system, whether informally or organized. They do not include colleague sports which are separate and can be cound with the NCAA label.

    • Sports covered are youth basketball, baseball, softball and soccer

    • These events are for the US (with a very small amount in Canada)

    • Youth sports include a new dynamic ranking model that predicts attendance and rank based on the type of sport, age group, level, gender, population density, student numbers, and other features

Date & Time

Date & Time Field
Availability
Notes

Start date

Yes

End date

Yes

Start time

Yes

Sports games are expected to have a specific start time.

End time

Yes

Yes

For sports events where there is no official end time available, PredictHQ predicts end times using our machine learning models and intelligent algorithms. PredictHQ’s Predicted End Times feature provides end times in the predicted_end field. When a predicted end time is provided, the event’s end time (in the end field) is set to be the same as the start time (in the start field).

Timezone

Yes

Note: datetime is in UTC.

Location

Entities

Sports events have event group entities and venue entities available.

Ranking

PHQ Rank

Sports events have PHQ Rank available.

Local Rank

Sports events have Local Rank available.

PHQ Attendance

Sports events have PHQ Attendance available.

Conferences

LABELS

Labels for a conference event provide more information about the event. The most common 5 labels are:

Date & Time

Date & Time Fields
Availability
NOTES

Start date

Yes

End date

Yes

Start time

Yes

Conferences are expected to have a specific start time.

End time

Yes

Timezone

Yes

Note: datetime is in UTC.

Location

Conferences events are point events, meaning the latitude and longitude of the event represents the location of the event’s venue. The smaller size conferences are usually held in a hotel, and the large conferences in convention centers.

Entities

Conference events have event group entities and venue entities available.

Ranking

PHQ Rank

Conference events have PHQ Rank available.

Local Rank

Conference events have Local Rank available.

PHQ Attendance

Conference events have PHQ Attendance available.

Expos

An industrial exhibition for communicating and trading purpose between business, or a trade fair that connects business and customers.

LABELS

Labels for an expo event provide more information about the event. The most common 5 labels are:

Date & Time

Date & Time Fields
Availability
Notes

Start date

Yes

End date

Yes

Start time

Yes

End time

Yes

Timezone

Yes

Note: datetime is in UTC.

Location

Expos events are point events, meaning the latitude and longitude of the event represents the location of the event’s venue. Expos are usually held in venues that can fit a large number of attendees such as a convention center.

Entities

Expos events have event group entities and venue entities available.

Ranking

PHQ Rank

Expos events have PHQ Rank available.

Local Rank

Expos events have Local Rank available.

PHQ Attendance

Expos events have PHQ Attendance available.

Concerts

LABELS

All concert events have a music label as concert events are expected to be music-related.

Date & Time

Date & Time Fields
Availability
Notes

Start date

Yes

End date

Yes

Start time

Yes

Concerts are expected to have a specific start time

End time

Yes

Yes

For concert events where there is no official end time available, PredictHQ predicts end times using our machine-learning models and intelligent algorithms. PredictHQ’s Predicted End Times feature provides end times in the predicted_end field. When a predicted end time is provided, the event’s end time (in the end field) is set to be the same as the start time (in the start field).

Timezone

Yes

Note: datetime is in UTC.

Location

Concerts events are point events, meaning the latitude and longitude of the event represent the location of the event’s venue.

Entities

Concerts events have event group entities and venue entities available.

Ranking

PHQ Rank

Concerts events have PHQ Rank available.

Local Rank

Concerts events have Local Rank available.

PHQ Attendance

Concerts events have PHQ Attendance available.

Festivals

LABELS

Labels for a festival event provide more information about the festival. The most common 5 labels are:

Date & Time

Date & Time Fields
Availability
Notes

Start date

Yes

End date

Yes

Start time

Yes

End time

Yes

Timezone

Yes

Note: datetime is in UTC.

Location

Entities

Festival events have event group entities and venue entities available.

Ranking

PHQ Rank

Festival events have PHQ Rank available.

Local Rank

Festival events have Local Rank available.

PHQ Attendance

Festival events have PHQ Attendance available.

Performing Arts

EVENT TYPES

The most common 5 types of performing-arts events are:

  1. General Theatre

  2. Comedy club

  3. Concert

  4. Family Theatre

  5. Cultural Performances

Date & Time

Date & Time Fields
Availability
Notes

Start date

Yes

End date

Yes

Start time

Yes

Performing-arts events are expected to have a specific start time

End time

Yes

Yes

For performing arts events where there is no official end time available, PredictHQ predicts end times using our machine-learning models and intelligent algorithms. PredictHQ’s Predicted End Times feature provides end times in the predicted_end field. When a predicted end time is provided, the event’s end time (in the end field) is set to be the same as the start time (in the start field).

Timezone

Yes

Note: datetime is in UTC.

Location

Performing-arts events are point events meaning the latitude and longitude of the event is for the location of the event’s venue. Venues for these events are usually theatres, playgrounds, or clubs, etc.

Entities

Performing-arts events have event group entities and venue entities available.

Ranking

PHQ Rank

Performing-arts events have PHQ Rank available.

Local Rank

Performing-arts events have Local Rank available.

PHQ Attendance

Performing-arts events have PHQ Attendance available.

Community

LABELS

Labels for a community event provide more information about the event. The most common 5 labels are:

Date & Time

Date & Time Fields
Availability
Notes

Start date

Yes

End date

Yes

Start time

Yes

End time

Yes

Timezone

Yes

Note: datetime is in UTC.

Location

A community event is a point events meaning the latitude and longitude of the event represents the location of the event’s venue.

Entities

Community events have event group entities and venue entities available.

Ranking

PHQ Rank

Community events have PHQ Rank available.

Local Rank

Community events have Local Rank available.

PHQ Attendance

Community events have PHQ Attendance available.

Academic

Academic Events are captured from an individual higher education institute’s academic calendar. They outline the general undergraduate activities, for example instruction period, break, exams, graduation, social, etc.

Note:

  • Academic Events currently covers institutions where full-time undergraduate enrollment (or FTE, full-time equivalent) is over 5,000. The student number is campus-based instead of the overall enrollment across different locations.

  • Academic Events currently covers institutions in US and top 20 institutions in UK. In future it will expand to other countries.

LABELS / EVENT TYPES

The Academic Events category has six main event types affecting students’ activities. The dates are retrieved from the official academic calendar and/or estimated based on the pattern. The estimated date will have an additional estimated label.

  1. Academic-session

    • The compulsory academic session for students to graduate upon completion.

    • Session starts on the first day of instruction and ends on the last day of instruction.

    • Orientation, reading days, and exams are not included.

    • Session events are labeled with academic and academic-session.

    • Intensive session, the optional academic session between the normal sessions for earlier graduation where the compulsory term is not applied, is also included in this event type.

  2. Exam

    • The exam period for the academic session.

    • Exam starts on the first day of the exam period and ends on the last day of the exam period

    • No separate exam period for the intensive session.

    • Reading days are not included.

    • Exam event is labeled with academic and exam.

  3. Holiday

    • The break/holiday period between the sessions or within the sessions.

    • Holiday events consist of:

      • Fall break

      • Thanksgiving break

      • Winter break

      • Spring break

      • Summer break

    • Holiday events don’t cover the public holidays such as Labor day, Easter holiday, Martin Luther King Jr. Day, etc as we already have the public holiday and observance categories.

    • Holiday events cover the Thanksgiving break because institutions may have a different schedule, e.g. 9 days vs 4 days.

    • Holiday events start on the day after the instruction / exam finishes and ends before the following instruction starts.

    • Winter and summer breaks may overlap with intensive sessions as the break will affect the majority of students while the intensive session only affects a few.

    • Holiday events are labeled with academic andholiday.

  4. Graduation

    • Graduation (also called commencement) date for undergraduate students.

    • Graduation events may have a specific start time where applicable.

    • Graduation venues may be outside the campus.

    • Graduation events include the institute’s name in the title.

    • Graduation events are labeled with academic and graduation.

  5. Social

    • Social events currently cover homecoming where alumni come back to the campus to visit.

    • Homecoming events may last up to a week.

    • Parent/family day/weekend may be included in the future.

    • Social events is labeled with academic and social.

Date & Time

Date & Time Fields
Availability
Notes

Start date

Yes

End date

Yes

End date will be as same as the start date when it’s not available, e.g. an one day graduation event has end date same as start date

Start time

Yes

Available for graduation and social events only. This is an optional data point and may not always be provided.

End time

Yes

Available for graduation and social events only. This is an optional data point and may not always be provided.

Timezone

Yes

Note: datetime is in UTC.

Location

Academic events are tracked as an event with a scope of locality. In terms of geographic information we return a latitude/longitude for the event and the address of the event. However, Academic events can apply to an entire campus or a specific location, e.g. an academic session applies to the whole campus, and a point event, e.g. graduation happens at a specific location. Use labels to distinguish these different types of events. graduation and social event are point events, academic-session, holiday, exam impact the whole area of the campus.

Entities

The Academic events have venue entities available.

Ranking

PHQ Rank

Academic events have PHQ Rank available.

  • Session, exam, and holiday types use student numbers (FTE) to indicate the event’s impact as the events apply on the whole campus.

  • Intensive sessions use 30% of the total student numbers (FTE) to indicate the event’s impact as the events apply to only a small population.

  • Graduation and social events use the actual number of attendees to indicate the impact.

Local Rank

Academic events have no Local Rank available.

PHQ Attendance

Academic events have PHQ Attendance available for all event types. PHQ Attendance for academic-session, exam, and holiday event types is based on student population, e.g. the amount of students enrolled in the term. PHQ attendance on graduation and social events are based on the number of people in attendance at the event.

PreviousEvent CategoriesNextNon-Attendance-Based Events

Last updated 11 months ago

Was this helpful?

Sports events are usually point events, meaning the latitude and longitude of the event represent the location of the event’s venue. The event can also impact an area or region, for example, the location of the is the state of Rio de Janeiro.

A formal meeting or forum relating to a certain topic between a group of people with shared interests. A major conference, especially an industry-related one, may last for several days and occur with regular frequency. An example of an annually occurring conference is the .

business: The conferences for a commercial purpose, for example, by Salesforce.

education: The conferences for an educational purpose, for example, .

health: The conferences related to the health industry, for example, .

technology: The conferences related to the technology topic, for example, .

science: The conferences related to the scientific topic, for example, .

education: The expos for an educational purpose or education-related topics, for example, .

technology: The expos related to topics in technology, for example, .

performing-arts: The shows or fairs that have live performances or are art-related, for example, , and .

entertainment: The shows or fairs for entertainment purposes, for example, .

career: A career or job fair that includes a number of businesses as well large numbers of candidates , for example, .

A musical performance where the primary intention of attendance is to see the musical artist or listen to music. Concerts usually last less than one day. Examples are a large concert, or a smaller nightclub event, for example, .

A commonly known day or a period of time when people gather together to celebrate a specific reason; or a day or a period of time consisting of an organized series of shows and entertainment activities Festivals typically occur on a certain frequency. For example, the is held annually.

music: Music festivals when a large group of musical artists continuously perform over several days. Music festivals are usually held at a dedicated venue that can fit a large number of attendees, for example, the .

performing-arts: The festivals that consist of performing shows such as a costume parade or a fireworks show. Such festivals could feature traditional music, theatre, poetry and art. For example, the .

family: The festivals which are family-friendly and children-friendly, for example, .

community: Traditional festivals in the local area. Community festivals are less formal than world-wide festivals and may also include street markets and entertainment activities. The is an example of a community festival.

food: Food festivals where communities or businesses trade food products, for example, .

A festival event can be a point event or an area event. The latitude and longitude of a point event represents the location of the venue where the festival takes place. The latitude and longitude of an area event is the geometric center of the area of the festival - either the area impacted by the festival, or an area where the festival takes place since its location is not fixed. An example of a festival without a fixed location is the .

A show or an exhibition of creative activities for an audience, for example, .

Theatre plays, for example, .

Standup comedy shows, for example, .

Musical plays, for example, A , or an , etc.

Shows or plays where the main audience are children, for example, , a , etc.

Traditional or cultural activities, for example, , a , etc.

This category includes various types of events, for example, a , a , an , or a .

music, concert: Social events with musical activity, for example, a .

family: Community events which are children and family-friendly, for example, a .

food: Social events about food or have food provided, for example, a .

education: Informal training workshops or clubs that consist of a group of people that share the same interest, for example, an .

fundraiser: Community events.

2016 Rio Summer Olympics
ASH Annual Meeting
Dreamforce
Young Social Innovators of the Year Awards
CIOSP - Congresso Internacional de Odontologia de São Paulo
FPD China
IAPM ASM
Riyadh International Book Fair
IIMS - Indonesia International Motor Show
Wizard World Comic Con
Saint Louis Art Fair
The Big E (The Eastern States Exposition)
HKTDC Education & Careers Expo
Eminem
Darude At Hq2 Nightclub Atlantic City
Yosakoi Soran Festival
Ultra Music Festival
National Festival of Popular Arts in Marrakech
Magnificent Mile Lights Festival
Odunde Festival
Bite of Seattle
Norwich St. Patrick’s Day Parade and Festival
a circus show
The Nutcracker ballet show
Eddie Izzard - Wunderbar World Tour
symphony
opera
Magic On Ice
dubbing show
Sewing & Quilt Expo
poetry slam
college event
community party
auction
fan meeting
karaoke at a bar
book club breakfast in the library
wine tasting event
installation art workshop
fundraising
Predicted end time
Predicted end time
Predicted end time