Sign in

v1

latestOpenAPI 3.0.02026-07-17823107.7 KB
Utilities & Data

Email data as a Zip file of CSVs

Schedules an email to be sent to the authenticated user containing question data, forecast data, and optionally comments, scores, and key factors as a Zip file of CSVs. Useful for large data exports that may time out with a direct download. Accepts the same parameters as /api/data/download/. You must provide at least one of post_id, question_id, or project_id.

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.

The email attachment has a size limit of 25 MB. If your export exceeds this limit, try removing include_comments to reduce the file size.

post/api/data/email/

Request body

post_idinteger

The ID of the post to export data for.

question_idinteger

The ID of the question to export data for.

project_idinteger

The ID of the project to export data for.

sub_questioninteger

If the post contains a group or conditional question, specify a sub-question ID.

aggregation_methodsstring[]

List of aggregation methods to include. Valid methods: recency_weighted, unweighted, metaculus_prediction, single_aggregation.

minimizeboolean

If false, includes all data points in recalculated aggregations.

include_botsboolean

Whether to include bot forecasts in aggregation recalculations.

user_idsinteger[]

A list of user IDs to restrict aggregation recalculations to. Only available to staff and whitelisted users.

include_commentsboolean

If true, includes comment data.

include_scoresboolean

If true, includes score data.

include_key_factorsboolean

If true, includes key factors data.

Response

Email scheduled successfully

messagestring

Example response

{
  "message": "Email scheduled to be sent"
}