Forecasting Features

Reduce your time to production by using PredictHQ’s API. Our forecasting features are designed to make your data models more accurate with less work on your end.
Aggregating Event Attendance

Find the total impact of events on a given day

Having insights into individual events is useful, but when it comes to demand forecasting, it’s useful to be able to identify peaks and throughs in demand on a daily basis.

The Features API reduces friction in forecasting by aggregating the total predicted attendees of events occurring in key locations on any given day. That means you spend less time trying to add up event attendees and then look for the spikes in demand. Instead, the Features API instantly shows you which days will be most impactful, and you’re able to drill down from there to see the individual event data.

POST /v1/features HTTP/1.1
      Accept: application/json
      Authorization: Bearer $ACCESS_TOKEN
      "location": {
            "place_id": ["4887398"]
      "active": {
            "gt": "2019-02-01",
            "lt": "2019-02-28"
      "phq_attendance_conferences": {
            "stats": ["sum"]
      "phq_attendance_sports": {
            "stats": ["sum"]
Relevance features

Search for events occuring within a certain radius

Event locations matter. If there’s a big expo occuring next to a downtown hotel and a coffee shop, those businesses will see an uptick in patrons on those days due to the influx of people attending the event. Your business’s proximity to events that drive demand will be a good indicator of the scale of the impact you’ll experience from them.

The PredictHQ API relevance endpoint provides a number of parameters that you can use to understand an event’s importance to you. Features such as Radial Search allow you refine your results based on an event’s physical proximity to locations that matter to you and your business.

GET /v1/events/?location_around.origin=40.782409,-73.971885&location_around.offset=1km&start_around.origin=$CURRENT_DATE&q=jazz&category=concerts&country=US&active.gte=$CURRENT_DATE HTTP/1.1

Authorization: Bearer $ACCESS_TOKEN
Label Features

Explore event labels for more granulatiry

Not only do events themselves matter, but specific types of events will impact your business differently. Having labels adds rich context to the categories of events that you’re analyzing.

For example, you might have a Community Event occuring near one of your key locations. Being able to know whether that event is a fundraising event vesus a religious gathering can influence your forecasting models. If you know for certain that religious gatherings are influential, but fundraising events are not, you can exlude events with the “fundraising” label and ensure that it doesn’t interfere with your models.

GET /v1/events/?label=fundraiser HTTP/1.1

Accept: application/json

Authorization: Bearer $ACCESS_TOKEN

Create a new access token via API clients

All API features

PredictHQ's Demand Intelligence API features were built to expedite your forecasting and unlock revenue opportunities for your business.
  • Radial search
  • NLP Labels
  • PHQ End Times
  • Geocoded Events
  • Umbrella Events
  • PHQ Attendance
  • Location search parameters
  • Recurring Events
  • Directional Flow
  • Geographical place scope

Customer Stories

Demand intelligence gets results

PredictHQ's customers include leading companies across a range of industries, including accommodation, transport, and retail. They're using our intelligent event data for labor optimization, demand forecasting, dynamic pricing, supply chain optimization and more.
Don't underestimate how much effort it takes to work with event data... Being able to rely on a company whose sole purpose is to remove the ambiguity of event data has been game-changing for us.
Read Legion’s Story

Every plan starts with an all access 14 day free trial

Choose our Lite or Premium plan and we will build a customized subscription plan for you while you have full access during the trial.


Access to our Web Application only

  • Location Insights: 3 locations
  • Location Type: Radius only
  • Max Radius: 5 miles
  • Central Dashboard
  • Event Search
  • Event Notifications
  • Demand Surge Impact


Access to our Web Application only

Typical users: Revenue Management, Business Analysts, Product Managers, Operations

  • Location Insights: Unlimited
  • Location Type: All
  • Max Radius: 10 miles
  • Central Dashboard
  • Event Search
  • Event Notifications
  • Demand Surge Impact


Access to both our Web Application and APIs

import requests

response = requests.get(
    "Authorization": "Bearer $ACCESS_TOKEN",
    "Accept": "application/json"
      "active.gte": "2019-12-29",
      "active.lte": "2020-02-20",

Typical users: Data Engineers, Data Scientists, Developers

  • Everything from the "Lite" plan
  • Events API
  • Features API
  • Live TV Events API
  • Snowflake Integration
  • ADX Integration
  • Tableau Integration + more

Don’t be left in the dark

Harness the power of demand intelligence

Knowing the impact of incoming events will transform your business. RideLondon brings 280k people and $32 million to the city each year - and that's only one event.

  • 0
    data points enriching
  • 0
    events across
  • 0
    cities, accessed via
    1 API

Get Started

Contact our data science experts to find out the best solutions for your business. We'll get back to you within 1 business day.

Talk to an Expert