Posts

Retrieve and filter the Metaculus feed

Overview

Posts are the primary content units in Metaculus. Each post can contain:

• Individual Questions - Single binary, multiple choice, numeric, date, or discrete questions
• Groups of Questions - Multiple related questions displayed together
• Conditional Questions - “If Yes” / “If No” scenario pairs
• Notebooks - Long-form content without forecasting components

The Posts endpoint is your main entry point for discovering and filtering forecasting questions.

---

List Posts

cURL

curl -X GET "https://www.metaculus.com/api/posts/?statuses=open&limit=20" \
  -H "Authorization: Token YOUR_TOKEN"

GET /api/posts/

Retrieve a paginated feed of posts with extensive filtering and sorting options.

Query Parameters

Status & Lifecycle Filters

statuses · array

Filter by post status. Multiple values allowed: open, closed, resolved, upcoming

Example: ?statuses=open&statuses=closed

for_main_feed · boolean

Filter posts suitable for the main feed (excludes drafts, rejected, etc.)

Project & Category Filters

tournaments · array

Filter by tournament slug. Multiple values allowed.

Example: ?tournaments=metaculus-cup&tournaments=aibq3

categories · array

Filter by category slug. Multiple values allowed.

Example: ?categories=nuclear&categories=health-pandemics

topic · string

Filter by a single topic slug

community · string

Filter by community slug

Forecaster Filters

forecaster_id · integer

Show only posts where this user has submitted a forecast

not_forecaster_id · integer

Show only posts where this user has NOT submitted a forecast

Question Type Filters

forecast_type · array

Filter by question type: binary, multiple_choice, numeric, discrete, date, conditional, group_of_questions, notebook

Example: ?forecast_type=binary&forecast_type=numeric

Timestamp Filters

open_time__gt · string (datetime)

Posts opened after this timestamp. Also supports: __gte, __lt, __lte

Example: ?open_time__gt=2024-01-01

published_at__gt · string (datetime)

Posts published after this timestamp. Also supports: __gte, __lt, __lte

scheduled_resolve_time__gt · string (datetime)

Posts scheduled to resolve after this timestamp. Also supports: __gte, __lt, __lte

Pagination

limit · integer · default: "20"

Number of posts to return per page

offset · integer · default: "0"

Number of posts to skip

Data Inclusion

with_cp · boolean · default: "false"

Include community predictions. For groups, only returns CP for top 3 subquestions.

include_cp_history · boolean · default: "false"

Include full aggregation history. Significantly increases response size.

include_descriptions · boolean · default: "false"

Include description, fine_print, and resolution_criteria fields

Sorting

order_by · string

Sort posts by field. Prefix with - for descending order.

Options:

• published_at - Publication date
• open_time - Opening date
• scheduled_close_time - Close date
• scheduled_resolve_time - Resolution date
• vote_score - Community votes
• comment_count - Number of comments
• forecasts_count - Number of forecasts
• hotness - Trending score (decay function based on engagement)
• weekly_movement - Community prediction change
• divergence - Spread of user predictions
• score - User performance (requires forecaster_id)

Example: ?order_by=-hotness

Response

next · string

URL for the next page of results, or null if no more pages

previous · string

URL for the previous page of results, or null if on first page

results · array

Array of post objects

Post Object Structure

id · integer

Unique post identifier

title · string

Post title

short_title · string

Shortened title for URLs

slug · string

URL-friendly slug

author_id · integer

User ID of the post author

author_username · string

Username of the post author

created_at · string (datetime)

When the post was created

published_at · string (datetime)

When the post was published

open_time · string (datetime)

When forecasting opened

scheduled_close_time · string (datetime)

When forecasting is scheduled to close

scheduled_resolve_time · string (datetime)

When the question is scheduled to resolve

status · string

Current status: open, closed, resolved, upcoming, draft, pending, rejected

curation_status · string

Curation state: draft, pending, rejected, approved

comment_count · integer

Number of comments on this post

nr_forecasters · integer

Number of unique forecasters

forecasts_count · integer

Total number of forecasts submitted

user_permission · string

Current user’s permission level: forecaster or viewer

vote · object

Voting information

score · integer

Total vote score

user_vote · integer

Current user’s vote: 1 (upvote), -1 (downvote), or null

projects · object

Associated projects, categories, and tournaments

site_main · array

Main site projects

tournament · array

Associated tournaments

category · array

Associated categories

tag · array

Associated tags

default_project · object

The primary project for this post

question · object

Question data (if post contains a single question). See Questions endpoint for full schema.

conditional · object

Conditional question data (if post contains conditional questions)

condition · object

The parent condition question (binary)

condition_child · object

The conditional child question

question_yes · object

Question for “If Yes” scenario

question_no · object

Question for “If No” scenario

group_of_questions · object

Group of questions data (if post contains multiple questions)

id · integer

Group identifier

description · string

Group description

resolution_criteria · string

How questions in this group will be resolved

group_variable · string

The variable that changes across questions (e.g., “Date”, “Country”)

graph_type · string

Visualization type: multiple_choice_graph or fan_graph

questions · array

Array of question objects in this group

notebook · object

Notebook content (if post is a notebook)

markdown · string

The notebook content in markdown

image_url · string

Featured image URL

---

Get Post Details

cURL

curl -X GET "https://www.metaculus.com/api/posts/3530/" \
  -H "Authorization: Token YOUR_TOKEN"

GET /api/posts/{postId}/

Retrieve detailed information about a specific post, including all associated questions and community predictions.

Path Parameters

postId · integer · required

The unique identifier of the post

Response

Returns a single post object with the same structure as the list endpoint, but with more complete data including:

• Full community prediction history for all questions
• Complete descriptions and resolution criteria
• All subquestions in groups (not limited to top 3)

---

Example Response

{
  "next": "https://www.metaculus.com/api/posts/?limit=1&offset=1",
  "previous": null,
  "results": [
    {
      "id": 3530,
      "title": "How many people will die as a result of COVID-19 before 2021?",
      "short_title": "COVID-19 Related Deaths before 2021",
      "slug": "covid-19-related-deaths-before-2021",
      "author_id": 101465,
      "author_username": "Jgalt",
      "created_at": "2020-01-25T04:09:23.208127Z",
      "published_at": "2020-01-27T00:00:00Z",
      "open_time": "2020-01-27T00:00:00Z",
      "scheduled_close_time": "2020-11-01T00:00:00Z",
      "scheduled_resolve_time": "2022-05-06T16:00:00Z",
      "status": "resolved",
      "curation_status": "approved",
      "comment_count": 270,
      "nr_forecasters": 546,
      "forecasts_count": 2760,
      "user_permission": "forecaster",
      "vote": {
        "score": 172,
        "user_vote": null
      },
      "question": {
        "id": 3530,
        "title": "How many people will die as a result of COVID-19 before 2021?",
        "type": "numeric",
        "status": "resolved",
        "resolution": "77289125.94957079",
        "scaling": {
          "range_min": 200.0,
          "range_max": 100000000.0,
          "zero_point": 0.0,
          "open_upper_bound": true,
          "open_lower_bound": true
        }
      },
      "projects": {
        "category": [
          {
            "id": 3685,
            "name": "Health & Pandemics",
            "slug": "health-pandemics"
          }
        ],
        "default_project": {
          "id": 144,
          "name": "Metaculus Community",
          "type": "site_main"
        }
      }
    }
  ]
}