PredictHQ’s Demand Intelligence APIs

Make your forecasts and operations more real world aware with our APIs built for scale, speed and accuracy. PredictHQ provides options for different API access points to suit your needs, from a featurized API to build models faster to a granular event API for better explainability.

World #1 Demand intelligence platform used by

Demand Forecasting: Incorporating events into models for smarter forecasting.

Customer Stories
Labor optimization: Ensuring the right number of drivers and store staff to meet demand.

Customer stories
Demand Forecasting: Incorporating events into models for smarter forecasting.

Customer Stories
Demand forecasting: Incorporating events into their Antuit-built models to better understand demand across 9600 stores.

Customer Stories
Amazon Alexa's "Events Near Me" feature uses PredictHQ data to inform users about local events.

Blog
Demand forecasting: Getting drivers in the right place ahead of time to improve pick-up times.

Customer stories
Event visibility: Available in Zartico’s platform enabling deeper insight and smarter decisions.

Customer Stories
Pricing: A key source of intelligence for the OTA Insights platform, enabling smarter pricing.

Customer Stories
Labor optimization: Enriching the Legion Technologies platform, used by retailers to reduce labor inefficiencies.

Customer Stories

Pick your API

What are your business needs?

Depending on what you are looking for, we’ll make sure we get you set up with the right API to start getting value out of PredictHQ’s demand intelligence as soon as possible.

Event API

Access to individual event data

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.

More on the event API Event API technical docs

import requests
response = requests.get(
    url="https://api.predicthq.com/v1/events/",
    headers={
      "Authorization": "Bearer $ACCESS_TOKEN",
      "Accept": "application/json"
    },
    params={
        "id": "e5c55724e854289204"
    }
)
print(response.json())

Features API

Save time with prebuilt intelligence and features

With the Features API, no need to build complex data handling systems or build features on your own. We handle the post processing work so you can focus on enabling your teams to extract value from event data rapidly. You can insert directly into your forecasting models.

More on the features API Features API technical docs

import requests
data = {
    "active": {
        "gte": "2019-11-28",
        "lte": "2019-11-29"
    },
    "location": {
        "place_id": [
            5224323,
            5811704,
            4887398
        ]
    },
    "phq_attendance_conferences": {
        "stats": [
            "min",
            "max"
        ]
    },
    "phq_attendance_sports": True,
    "phq_attendance_concerts": True,
    "phq_rank_public_holidays": True
}
response = requests.post(
    url="https://api.predicthq.com/v1/features",
    headers={
      "Authorization": "Bearer $ACCESS_TOKEN",
      "Accept": "application/json"
    },
    json=data
)
print(response.json())

Live TV Events API

Access to historical and predicted viewership data

Better predict surges in demand caused by televised events such as sports. Filter by city or county to access relevant data rather than by broad designated market areas (DMAs) used by other providers. Access to county-level viewership data enables you to confidently forecast at a more granular level, such as for individual stores if you’re a quick-service restaurant or grocery store.

More on live tv events Live TV Events API technical docs

Walk through the Data with Data Scientist Andrew Walker

Watch video (14:37)

import requests

response = requests.get(
    url="https://api.predicthq.com/v1/broadcasts/",
    headers={
        "Accept": "application/json",
        "Authorization": "Bearer $ACCESS_TOKEN"
    },
    params={
        "location.place_id": "5368381,5391832",
        "start.gte": "2020-11-01",
        "start.lte": "2020-11-30",
        "start.tz": "America/Los_Angeles"
    }
)

print(response.json())

Forecast ready Features

Regardless of the API you choose, get up and running quickly

We’ve created Jupyter notebooks on how to integrate our 19 (and counting) event categories into your models to help your Data Science teams get up and running quickly. It includes guides to using our APIs and data with common Data Science tools and libraries in Python.

Check out our Notebooks

Create a new access token via API clients

Create Token

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.

Explore use cases More customer stories

Thomas Joseph

Head of Data Science ,

Legion

Thomas Joseph

Head of Data Science ,

Legion

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

PRICING

Which plan is right for me?

Start searching for events today for free or work with us to build a customized subscription plan.

Trial

Test our API and Web UI for FREE for 14 days

import requests

response = requests.get(
  url="https://api.predicthq.com/v1/events/",
  headers={
    "Authorization": "Bearer $ACCESS_TOKEN",
    "Accept": "application/json"
  },
  params={
      "active.gte": "2019-12-29",
      "active.lte": "2020-02-20",
  }
)

Easy-to-use central dashboard
Search for events
Demand surges
Access to our events API
Access to our API features

14 days trial

Get started

Typical users: Anyone who wants to test out and explore our data set

Lite

Access to our Web UI

Easy-to-use central dashboard
Search for events
Demand surges
Get notified about events
Unlimited users

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

Premium

Access to our APIs and Web UI

import requests

response = requests.get(
  url="https://api.predicthq.com/v1/events/",
  headers={
    "Authorization": "Bearer $ACCESS_TOKEN",
    "Accept": "application/json"
  },
  params={
      "active.gte": "2019-12-29",
      "active.lte": "2020-02-20",
  }
)

Everything from the "Lite" plan
Event and Features API
Pre-engineered features
Snowflake integration
ADX integration
Tableau integrations + more

Typical users: Data Engineers, Data Scientists, Developers

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.