Projects

Overview

Projects in Metaculus organize questions into curated collections. There are several types:

Tournaments - Competitive forecasting events with leaderboards and prizes
Categories - Topic-based groupings (e.g., “Health & Pandemics”, “AI”)
Topics - High-level thematic areas
Communities - User-created private or public question collections
Site Main - The main Metaculus community

Projects are used to filter posts and track specialized leaderboards.

List Tournaments

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

import requests

response = requests.get(
    "https://www.metaculus.com/api/projects/tournaments/",
    headers={"Authorization": "Token YOUR_TOKEN"}
)
print(response.json())

GET /api/projects/tournaments/ Retrieve a list of all active tournaments.

Response

array

Array of tournament objects

Tournament Object

integer

Unique tournament identifier

string

Always "tournament"

string

Tournament name

string

URL-friendly slug used in filters

string

Total prize pool amount

string (datetime)

When the tournament starts

string (datetime)

When the tournament ends

boolean

Whether the tournament is currently active

string

Current user’s permission: forecaster or viewer

string

Default permission for new users

string

Visibility level: normal, not_in_main_feed, or unlisted

Get Tournament by Slug

curl -X GET "https://www.metaculus.com/api/projects/tournaments/aibq4/" \
  -H "Authorization: Token YOUR_TOKEN"

import requests

response = requests.get(
    "https://www.metaculus.com/api/projects/tournaments/aibq4/",
    headers={"Authorization": "Token YOUR_TOKEN"}
)
print(response.json())

GET /api/projects/tournaments/{slug}/ Retrieve detailed information about a specific tournament.

Path Parameters

string

required

The tournament slug

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

import requests

response = requests.get(
    "https://www.metaculus.com/api/projects/categories/",
    headers={"Authorization": "Token YOUR_TOKEN"}
)
print(response.json())

GET /api/projects/categories/ Retrieve all available categories.

Response

array

Array of category objects

Category Object

integer

Unique category identifier

string

Category name (e.g., “Health & Pandemics”)

string

URL-friendly slug (e.g., “health-pandemics”)

string

Category description

List Topics

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

import requests

response = requests.get(
    "https://www.metaculus.com/api/projects/topics/",
    headers={"Authorization": "Token YOUR_TOKEN"}
)
print(response.json())

GET /api/projects/topics/ Retrieve all available topics.

Response

array

Array of topic objects

Topic Object

integer

Unique topic identifier

string

Topic name

string

URL-friendly slug

string

Emoji icon for the topic

string

Section this topic belongs to

List Communities

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

import requests

response = requests.get(
    "https://www.metaculus.com/api/projects/communities/",
    headers={"Authorization": "Token YOUR_TOKEN"}
)
print(response.json())

GET /api/projects/communities/ Retrieve all communities visible to the current user.

Response

Returns array of project objects with type: "community".

Get Community by Slug

curl -X GET "https://www.metaculus.com/api/projects/communities/my-community/" \
  -H "Authorization: Token YOUR_TOKEN"

import requests

response = requests.get(
    "https://www.metaculus.com/api/projects/communities/my-community/",
    headers={"Authorization": "Token YOUR_TOKEN"}
)
print(response.json())

GET /api/projects/communities/{slug}/ Retrieve detailed information about a specific community.

Path Parameters

string

required

The community slug

Get Project Members

curl -X GET "https://www.metaculus.com/api/projects/144/members/" \
  -H "Authorization: Token YOUR_TOKEN"

import requests

response = requests.get(
    "https://www.metaculus.com/api/projects/144/members/",
    headers={"Authorization": "Token YOUR_TOKEN"}
)
print(response.json())

GET /api/projects/{projectId}/members/ Retrieve members of a project (typically used for communities and tournaments).

Path Parameters

integer

required

The project ID

Response

array

Array of member objects

object

User information

integer

User ID

string

Username

string

User’s permission level in this project

string

User’s role (e.g., “admin”, “member”)

curl -X POST "https://www.metaculus.com/api/projects/144/subscribe/" \
  -H "Authorization: Token YOUR_TOKEN"

import requests

response = requests.post(
    "https://www.metaculus.com/api/projects/144/subscribe/",
    headers={"Authorization": "Token YOUR_TOKEN"}
)
print(response.status_code)

POST /api/projects/{projectId}/subscribe/ Subscribe to notifications from a project.

Path Parameters

integer

required

The project ID to subscribe to

Unsubscribe from Project

curl -X POST "https://www.metaculus.com/api/projects/144/unsubscribe/" \
  -H "Authorization: Token YOUR_TOKEN"

import requests

response = requests.post(
    "https://www.metaculus.com/api/projects/144/unsubscribe/",
    headers={"Authorization": "Token YOUR_TOKEN"}
)
print(response.status_code)

POST /api/projects/{projectId}/unsubscribe/ Unsubscribe from project notifications.

Path Parameters

integer

required

The project ID to unsubscribe from

Download Project Data

curl -X GET "https://www.metaculus.com/api/projects/144/download-data/?include_scores=true" \
  -H "Authorization: Token YOUR_TOKEN" \
  --output project_data.zip

import requests

response = requests.get(
    "https://www.metaculus.com/api/projects/144/download-data/",
    headers={"Authorization": "Token YOUR_TOKEN"},
    params={"include_scores": True}
)

with open("project_data.zip", "wb") as f:
    f.write(response.content)

GET /api/projects/{projectId}/download-data/ Download all question and forecast data for a project as a ZIP file containing CSVs.

Path Parameters

integer

required

The project ID

Query Parameters

boolean

default:"false"

Include comment data in the export

boolean

default:"false"

Include scoring data in the export

Response

Returns a ZIP file containing:

question_data.csv - Question metadata
forecast_data.csv - All forecasts and aggregations
comment_data.csv - Comments (if requested)
score_data.csv - Scores (if requested)
README.txt - Data dictionary

Access RestrictionsFull project data downloads are only available to:

Site administrators
Project administrators
Whitelisted users

Contact Metaculus if you need bulk data access for research purposes.

Get Site Main Project

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

import requests

response = requests.get(
    "https://www.metaculus.com/api/projects/site_main/",
    headers={"Authorization": "Token YOUR_TOKEN"}
)
print(response.json())

GET /api/projects/site_main/ Retrieve information about the main Metaculus community project.

Usage Examples

Filter Posts by Tournament

import requests

# Get all open questions in the AI Benchmarking tournament
response = requests.get(
    "https://www.metaculus.com/api/posts/",
    headers={"Authorization": "Token YOUR_TOKEN"},
    params={
        "tournaments": "aibq4",
        "statuses": "open",
        "limit": 50
    }
)

for post in response.json()["results"]:
    print(f"{post['title']} - {post['nr_forecasters']} forecasters")

Filter Posts by Category

import requests

# Get recent AI questions
response = requests.get(
    "https://www.metaculus.com/api/posts/",
    headers={"Authorization": "Token YOUR_TOKEN"},
    params={
        "categories": "artificial-intelligence",
        "order_by": "-published_at",
        "limit": 20
    }
)

for post in response.json()["results"]:
    print(f"{post['title']}")

Getting Started

Endpoints

Examples

Overview

List Tournaments

Response

Tournament Object

Get Tournament by Slug

Path Parameters

Response

Category Object

List Topics

Response

Topic Object

List Communities

Response

Get Community by Slug

Path Parameters

Get Project Members

Path Parameters

Response

Path Parameters

Unsubscribe from Project

Path Parameters

Download Project Data

Path Parameters

Query Parameters

Response

Get Site Main Project

Usage Examples

Filter Posts by Tournament

Filter Posts by Category

​Overview

​List Tournaments

​Response

​Tournament Object

​Get Tournament by Slug

​Path Parameters

​List Categories

​Response

​Category Object

​List Topics

​Response

​Topic Object

​List Communities

​Response

​Get Community by Slug

​Path Parameters

​Get Project Members

​Path Parameters

​Response

​Subscribe to Project

​Path Parameters

​Unsubscribe from Project

​Path Parameters

​Download Project Data

​Path Parameters

​Query Parameters

​Response

​Get Site Main Project

​Usage Examples

​Filter Posts by Tournament

​Filter Posts by Category

Overview

List Tournaments

Response

Tournament Object

Get Tournament by Slug

Path Parameters

List Categories

Response

Category Object

List Topics

Response

Topic Object

List Communities

Response

Get Community by Slug

Path Parameters

Get Project Members

Path Parameters

Response

Subscribe to Project

Path Parameters

Unsubscribe from Project

Path Parameters

Download Project Data

Path Parameters

Query Parameters

Response

Get Site Main Project

Usage Examples

Filter Posts by Tournament

Filter Posts by Category