Be the first to know about events with Predicted Events

Predicted Events will have their own status, and you will be able to search and retrieve them just as any other event. Predicted Events will always carry some risk that they might not happen, because some of them may not come from our providers. We have internal logic and mechanisms in place to mitigate this risk.

All Predicted Events will be either upgraded to Active Events (the standard events that you’re already getting through our web application and APIs), or downgraded to Deleted, depending on whether or not they get confirmed by the providers closer to the date of the event. The same ID will carry over from Predicted, to Active, or Deleted – so you don’t need to fetch new IDs periodically. The Predicted Events feature includes the release of existing events that don’t officially have start times yet. These are events we had, but didn’t previously show due to their unconfirmed status. Now, these events will be visible with the label Predicted Events. These events will lack precise start times (hours of the day), but they will include start dates (the date on which they’re predicted to be held).

Predicted Events also include entirely new events. These are based on analyzing recurring events, and inferring the next event in the set before it is officially announced by event organizers.

You can query for Predicted Events in the API by setting the state filter (see the Events API search events documentation) to predicted. This will return events with the predicted state. You can choose multiple state values for example set state to active and predicted events to get back events in either state. The predicted value is also returned in the state field in the response.

To see Predicted Events in our web application, choose “Predicted” from the Event Status pull-down and click on the search button. Predicted Events are shown with a “Predicted Event” label and an explanation on the event details page. Predicted Events also show in the list of events shown for a location with Location Insights.

Predicted Events apply to events being held in the future. Events that occurred in the past wont have this status.