Event Categories

We support all the traditional and major event categories. Our data is aggregated and sourced from a blend of trusted businesses who are specialists in their fields, along with hard to find data that we manually collate ourselves. To explore the data further create a free account and, try it for yourself.

Making Requests

You will need to make a number of HTTP requests to the PredictHQ HTTP API. Examples of these requests are included in raw HTTP, cURL, and the Python Requests library - use the links at the top right to switch between these options. Alternatively, you can construct these requests yourself in any standard HTTP client of your choice.

For more detailed information on using the API see our Quickstart Guide.


Scheduled Events

Scheduled events are classed as either Attendance-based Events (such as concerts or conferences) or Non-attendance-based Events (such as public holidays or observances).

Attendance-based Events Non-attendance-based Events
Community Daylight Savings
Concerts Observances
Conferences Politics
Expos Public Holidays
Festivals School Holidays
Performing Arts
Sports
  • GET v1/events?category=sports,public-holidays HTTP/1.1
    Authorization: Bearer $ACCESS_TOKEN
    
  • curl -X GET "https://api.predicthq.com/v1/events?category=sports,public-holidays" \
         -H "Authorization: Bearer $ACCESS_TOKEN"
    
  • import requests
    
    response = requests.get(
        url="https://api.predicthq.com/v1/events/",
        headers={
          "Authorization": "Bearer $ACCESS_TOKEN",
          "Accept": "application/json"
        },
        params={
            "category" : "sports,public-holidays"
        }
    )
    
    print(response.json())
    

Unscheduled Events

Unscheduled events are those which are unplanned.

  • Airport Delays
  • Disasters
  • Severe Weather
  • Terror Attacks
  • GET v1/events?category=disasters HTTP/1.1
    Authorization: Bearer $ACCESS_TOKEN
    
  • curl -X GET "https://api.predicthq.com/v1/events?category=disasters" \
         -H "Authorization: Bearer $ACCESS_TOKEN"
    
  • import requests
    
    response = requests.get(
        url="https://api.predicthq.com/v1/events/",
        headers={
          "Authorization": "Bearer $ACCESS_TOKEN",
          "Accept": "application/json"
        },
        params={
            "category" : "disasters"
        }
    )
    
    print(response.json())
    

Latency

We’re constantly adding and updating events to our ever-growing data set, so it’s important to keep up to date.

We recommend updating scheduled events at least once per day. Due to the nature of unscheduled events, they should usually be updated more frequently to ensure new events are seen rapidly. Please see our Staying Updated Guide for how to do this.