PredictHQ’s Demand Intelligence API

Access your demand causal factors in a single API. Breakthrough insight for more accurate demand forecasting, operational platforms, event calendars and much more
  • Relevant + Intelligent

    It is impossible to predict demand anomalies without accurate data. That is why we have such a strong focus on high-quality, relevant data for your business.

  • Expansive Global Coverage

    PredictHQ is the single source of truth with coverage across 18 categories (and counting) and global event data coverage from hundreds of sources.

  • Clean Event Data

    Data scientists spend 40% of their time gathering and cleaning data and only 11% of time on data science. We do the frustrating work, so you can focus on what matters.

import requests

response = requests.get(
  url="https://api.predicthq.com/v1/events/impact/",
  headers={
    "Authorization": "Bearer $ACCESS_TOKEN",
    "Accept": "application/json"
  },
  params={
    "impact_rank": "rank",
    "place.scope": "5809844",
    "active.gte": "2020-02-01",
    "active.lte": "2020-02-29",
    "active.tz": "America/Los_Angeles"
  }
)

print(response.json())
Aggregate Event Impact

Remove the friction for quick correlation to demand

Events vary in type, size, location, duration and impact. They also frequently cluster, creating outsize impact. We aggregate and verify millions of events so data science teams have enough high-quality data to identify correlation between demand spikes and events, unlocking new opportunities.
import requests

response = requests.get(
  url="https://api.predicthq.com/v1/events/",
  headers={
    "Authorization": "Bearer $ACCESS_TOKEN",
    "Accept": "application/json"
  },
  params={
    "rank.gte": "80",
    "local_rank.gte": "80",
    "place.scope": "5809844",
    "aviation_rank.gte": "50",
    "active.gte": "2019-12-29",
    "active.lte": "2020-01-10",
    "active.tz": "America/Los_Angeles"
  }
)

print(response.json())
Rankings

Know which events matter the most, instantly

PredictHQ’s proprietary ranking technology systematically sorts through thousands of events each day to identify which will impact your bottom line the most. Focus on the events that matter with PredictHQ Rank™, Local Rank™, and Aviation Rank™.
import requests

response = requests.get(
  url="https://api.predicthq.com/v1/events/",
  headers={
    "Authorization": "Bearer $ACCESS_TOKEN",
    "Accept": "application/json"
  },
  params={
    "q": "jazz",
    "country": "US",
    "category": "concerts",
    "active.gte": "2020-02-20",
    "location_around.offset": "5mi",
    "start_around.origin": "2020-02-20",
    "location_around.origin": "40.782409,-73.971885"
  }
)

print(response.json())
Relevance

Use parameters to ensure relevant results

Filter the data with parameters such as Temporal Relevance to see if events happening sooner are most important to your business. Or see the events closest to your locations with Spatial Relevance.
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

Our customers include leading companies across retail, transport, accommodation and financial service sectors. They use 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 free developer plan to fully customized subscription plans, our pricing is tailored to fit your needs.

Developer

Test our API for FREE

Future event visibility
Historical event visibility
Events returned per page/request
Maximum pages
Location — Seattle, USA
Commercial use allowed
Display without attribution
Caching allowed
Priority support

Premium

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

You can’t prepare for what you don’t see coming

Harness the power of demand intelligence

Knowing the impact of demand causal factors like events will transform your business. The American Society of Hematology has a $45M estimated economic impact — and that's only one event in one city.

  • 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 I'm Interested In *