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.
Aggregate Event IMpact endpoint

Find the Aggregate Event Impact on any 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.

AEI reduces friction in forecasting by aggregating the total predicted attendees of all events occuring 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, AEI instantly shows you which days will be most impactful, and you’re able to drill down from there to see the individual event data.

GET /v1/events/impact/?place.scope=4887398&active.gte=2020-02-01&active.lte=2020-02-29& HTTP/1.1

Authorization: Bearer $ACCESS_TOKEN
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 was built with advanced feature engineering to expedite your forecasting and unlock revenue and efficiency opportunities for your business.
  • Radial search
    Need to know events happening within a mile of you? Use the "within" parameter to search for events happening within a certain distance of a specific point, such as a hotel or retail store.
    Radial search
  • NLP Labels
    PredictHQ uses natural language processing (NLP) and machine learning to classify events into niche subtypes to better identify their exact predicted impact.
    NLP Labels
  • PHQ End Times
    Some event data sources provide start times but none provide the end times for every event. This is critical for transport, delivery and ride-sharing companies that want to ensure drivers are at a location when an event ends.
    PHQ End Times
  • Geocoded Events
    Many of the events we aggregate are incorrectly geocoded or missing geocoding all together. Our systems ensure every event available through PredictHQ is correctly geocoded.
    Geocoded Events
  • Umbrella Events
    There are often many individual events within a single larger event. The single larger event is called an umbrella event. Easily search and filter by overarching events e.g. a festival as the umbrella event and the individual performances under it. Some businesses are only interested in the umbrella event whereas others are more interested in the individual events under it. Sometimes perhaps both.
    Umbrella Events
  • PHQ Attendance
    A numerical value that reflects the predicted attendance for supported attendance-based categories. The following categories are supported: concerts, performing arts, sports, expos, conferences, community and festivals.
    PHQ Attendance
  • Location search parameters
    Search, filter and analyze events in specific locations using latitude and longitude geocenter and radius, or by airport codes such as IATA, ICAO, UN/LOCODE. You can also search by country, continent, state, region, province, county or city using our Places API.
    Location search parameters
  • Recurring Events
    Many events recur but 85% of recurring events change location or date each time. By using recurring events, you'll have the ability to move beyond “we had a spike here last year” to pinpointing exactly why you experienced that spike and ensuring you can meet it again.
    Recurring Events
  • Geographical place scope
    Hierarchies are accounted for within our ranks with geographical scope e.g. events that occur at a country level vs. events that happen at a region or city level.
    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

Which plan is right for me?

From a 14-day free developer plan to fully customized subscriptions plans, our pricing is tailored to fit your needs.


Test our API for FREE for 14 days

Future event visibility
Historical event visibility
Events returned per page/request
Maximum pages
Global Locations
Commercial use allowed
Display without attribution
Caching allowed
Priority support


Priced for your needs as you scale


Increase your limits to get the data your business needs. We'll partner with you to find the right solution.

Commercial use allowed
Display without attribution
Caching allowed
Priority support

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

Products/Features I'm Interested In *