Export events data from Control Center

The exporter feature allows you to export our events data in CSV or JSONL format directly from Control Center search, enabling you to use this data locally on your computer, or for other use cases. It’s easy to get started.

What’s supported?

PredictHQ currently supports the export of real-world events and Live TV events.

You can export large volumes of data using the exporter. It runs in the background and you can continue using Control Center while it runs.

How can I export data?

  1. Visit the search feature within Control Center

  2. Search for events with the filters and ranges you want to be applied.

  3. Press the “Export” button above the search results

    Export option in CC

  4. A dialog will appear, select the format you would like to export the file in - CSV or JSONL

  5. The data exporter will begin processing your export. If it’s small, the export will be available soon on the pop-up (click refresh in the dialog to see the latest status). For larger exports of tens of thousands of records or more they may take some time. You can continue using Control Center while the export runs. There is no need to keep the dialog open to wait for it to complete.

  6. You will receive an email when the export is ready for download. Click on the button in the file to download your exported file. The file will be a ZIP file containing the formatted data of your choice.

export email

Viewing export status and previous exports

To view previously exported files or check the progress of a current export choose "Previous Exports" from the export menu. This will open a dialog showing a list of previously exported files. It will also show any exports that are in progress and being processed. In progress exports will showing as "processing". Completed exports will have a green tick and indicate the file size.

From this screen you can download exports or delete exports.

Exported Files Dialog

Export file format

See the Events API Response Fields documentation for information on the fields included in the export.

JSONL format exports are very similar to the Events API response.

CSV exports have some fields split into "normalized" fields.

When are exports deleted?

We encourage you to download your export as soon as it’s ready. At the moment we store exports for 30 days.