Event Categories

We support all the traditional and major event categories. You can find a more detailed documentation about each category in our Category Info guides. 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 Events 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
Academic Daylight Savings
Community Observances
Concerts Politics
Conferences Public Holidays
Expos School Holidays
Festivals
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.

  • 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())
    

Live TV Events

We provide data about Live TV Events from our Broadcasts API, which is a separate endpoint to our Events API. Live TV Events are not an Events category, however, the Broadcasts API allows you to query how many people will watch a televised broadcast of an Event in different locations.

Please see our Live TV Events Guide for information about the Broadcasts API.


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.