v1

latestOpenAPI 3.0.02026-07-17823107.7 KB

Utilities & Data

Download data as a Zip file of CSVs

Downloads question data, forecast data, and optionally comments, scores, and key factors as a Zip file of CSVs. You must provide at least one of post_id, question_id, or project_id to specify the data to download.

Note: This is a restricted endpoint. To request access, please fill out the Metaculus Data Needs Form. For questions or feedback, contact api-requests@metaculus.com. Additionally, the project_id parameter is only accepted if your account has been whitelisted for that specific project, to prevent heavy data requests.

This endpoint may time out for large data exports. If your download fails due to a timeout, use the /api/data/email/ endpoint instead, which processes the export asynchronously.

get/api/data/download/

Query parameters

post_idinteger

The ID of the post to download data for.

question_idinteger

The ID of the question to download data for.

project_idinteger

The ID of the project to download data for.

sub_questioninteger

If the post contains a group or conditional question, specify a sub-question ID to download data for only that sub-question.

aggregation_methodsstring

Comma-separated list of aggregation methods to include, or all to include all available methods. Valid methods: recency_weighted, unweighted, metaculus_prediction, single_aggregation. single_aggregation is only available to site admins. If not provided, only recency_weighted is included. Including this parameter triggers a recalculation of aggregations, which may increase response time.

minimizeboolean

If false, includes all data points in recalculated aggregations (requires aggregation_methods). May result in very large files or server timeouts for questions with many forecasts.

include_botsboolean

Whether to include bot forecasts in aggregation recalculations. Requires aggregation_methods. If not given, uses the question's include_bots_in_aggregations setting.

user_idsinteger[]

A list of user IDs to recalculate aggregations for only those users' forecasts. Requires aggregation_methods. Only available to staff and whitelisted users.

include_commentsboolean

If true, includes a CSV file containing all public comments.

include_scoresboolean

If true, includes a CSV file containing all scores.

include_key_factorsboolean

If true, includes key factors data in the download.

Response

Zip file containing CSVs (question_data.csv, forecast_data.csv, and optionally comment_data.csv, score_data.csv)