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
      • Using the Snowflake Retail Sample Dataset
      • 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
  • Searching for Events in the WebApp
  • Search Filters
  • List View
  • Map View
  • Calendar View
  • Live TV Events
  • Export Events

Was this helpful?

  1. WebApp Support
  2. WebApp Overview

Events Search

PreviousAPI ToolsNextHow to Create an API Token

Last updated 1 month ago

Was this helpful?

Searching for Events in the WebApp

Find events with our easy-to-use search tool. Increase visibility into the millions of different events happening around the world to understand which ones may have an impact on your business. See results in a variety of ways, including a list, map, or calendar view.

Note that search is set up to display events that you have access to under your subscription. So if you have access to specific cities like New York and Boston, you will only see events from those cities.

The time zone used in the search is the time zone set in your profile within the WebApp.

To use it, choose the categories, locations, ranks, and date range you want to search. Choose more filters. The search supports the following filters:

Search Filters

Filters can be used to narrow down your search results. Your filters will be remembered per device until you change them. So, for example, once you search for a particular location and set of categories those search filters will be remembered the next time you load the search until you change them. Click the cross next to each filter to clear it.

See below for a list of filters:

  • Date range - specify the date range. You can search for future, or past events. Choose from preconfigured date ranges, or set a custom date range on the calendar. Note that the date ranges available are limited by what you have access to in your subscription.

  • Labels - Within categories, we have different labels. For example, labels within the sports category indicate what type of sporting event you are looking at.

  • Event name - This option searches the event title and description. It's a way to search for a specific event or to search for events with text in their title or description.

  • PHQ Attendance - Filter by PHQ attendance to find events above a certain attendance, or within an attendance range. PHQ attendance indicates how many people our advanced models predict will attend an event. For example, you might want to find all events of 10,000 PHQ attendance and above for a city. To do that, set the from value to 10,000.

  • Event status - By default, the status shows active, canceled, predicted, and postponed. Change the status to view certain event statuses. The available statuses are:

    • Active - Active events where the details are confirmed.

    • Canceled - Events that have been canceled.

    • Postponed - Events that have been postponed from the original announced dates and times.

    • Predicted - Future events that we predict will occur but where all the details are not finalized. They could be events that haven’t been scheduled or even announced yet, but are expected to occur – based on years of historical event, entity, demand, and venue data. Or they could be events we know are going to occur like an upcoming sports semi-final game but where the location or timing isn't yet confirmed. See Predicted Events for more details.

Choose Your Location

When searching for events, a key value to choose is the location or locations you want to search. By default, if you don't set locations for some plans the search will return events for all the locations that you have access to under your subscription. For other plans, you will need to choose a location to search.

Note: Depending on your plan you may see a different location control when searching.

Selecting Multiple Locations

By default, you select 1 location at a time when using search. To select multiple locations toggle the "enable multiple select" at the bottom of the dialog as shown below.

When you select multiple locations there are some limits to be aware of. You can select multiple geographic areas (like multiple cities or states). You can also select multiple saved locations. But you cannot select a geographic area and a saved location as they are different types of locations.

See below for an example of entering multiple geographic area (city, state, country type) locations:

You can search on multiple geographic areas or multiple saved locations but you cannot mix the two types.

Using Latitude and Longitude in the New Locations Control

If you want to search on a particular address you can enter that address into the location control. Sometimes though you may want to use latitude and longitude directly in the search. For example, maybe you have a list of coordinates in a spreadsheet for different locations as latitude and longitude and you want to find events in these locations.

If you want to override the suggested radius you can also enter a radius in the format <radius number><unit>@<lat>,<long>. For example 5km@50.63449,5.58148 to set the radius to 5 kilometers for those coordinates or 6mi@50.63449,5.58148 to set the radius to 6 miles. Units supported are:

  • km - kilometers

  • m - meters

  • mi - miles

  • ft - feet

List View

The WebApp List view shows a list of events. The events shown are based on the filters you've selected. You can change the page size at the bottom of the list to show more events. By default, the list view will show all the events available in your subscription.

Events are ordered by the sort parameter. Choose your sort values and run your search to see a list of events that you have access to under your plan.

Map View

Try our map view to see the events on a map.

Calendar View

The calendar will show you upcoming events in a week, month, or year view.

Live TV Events

See Can You Access Live TV Events via the WebApp?

Export Events

See Export Events Data from the WebApp

Categories - choose one or more categories to view events under those categories. See our for an overview.

Rank - Filter by one of our 2 ranks: PHQ Rank or Local Rank. Higher-ranked events will tend to be larger events. PHQ Rank is based on the number of people predicted to attend the event. Filter for large PHQ rank events to find large events in your area. Find out more about our ranks .

In our combined location search control (released in June 2024) you can search on a street address, a geographic area (like a city, country, state, region, or country), or for a . Saved Locations are listed first at the top of the control.

To search on a street address enter the street address and then choose the relevant result from the results shown - below I searched on "130 W 46th St" for an address in New York. Behind the scenes, we locate the latitude and longitude for the address look up the , and then search for events in the radius.

This is a smart search control that will look at what you've entered and try to determine if it's a street address, geographic area, or a saved location. If you have any problems with the search to recognize the right type we'd suggest you and configure that to be the type you need and then search on that saved location.

Below is another example of searching on multiple saved locations (also known as locations).

To do this enter a latitude and longitude into the location control and it will recognize it, look up the , and allow you to search on it. After entering the latitude and longitude you will see it shown below in the control. Click on it to search for events at this location. See the screenshot below:

The list view calls our to get back the events data. All the data you see in the list view can be retrieved using the API. See our for more info on using the API.

categories page
here
saved location
suggested radius
create a saved location
location insights
suggested radius
Events API
tech docs
Events Search in the WebApp
Location filter in the Events Search page
Searching by street address in the Location filter
Selecting multiple locations by geographic area (city, state, country type) in the Location filter
Selecting multiple locations by Saved Locations in the Location filter
Searching location by latitude and longitude in the Location filter
Searching by latitude and longitude with a specified radius in the Location filter
Events search result in List view
Events search result in Map view
Events search result in Calendar view