v1
latestOpenAPI 3.0.02026-07-17823107.7 KBFeed
Retrieve posts feed
Retrieves a feed of posts with various filters.
get/api/posts/
Query parameters
tournamentsstring[]
Tournament slug. You can apply multiple filters.
[ "metaculus-cup", "aibq3" ]
statusesstring[]
Post statuses. You can apply multiple filters.
[ "closed", "resolved" ]
forecaster_idinteger
Example:123
Filters posts where the specified user has submitted a forecast on a question within the post.
with_cpboolean
Example:true
Include Community Prediction data in the response. Note: aggregation data is only available for certain questions depending on your API access tier (see above). When enabled on a group post, only the top 3 subquestions include CP; use the post details endpoint for all subquestions.
include_cp_historyboolean
Example:true
Include full aggregation history in the response.
include_descriptionsboolean
Example:true
With this flag enabled, each post question will include the description, fine_print, and resolution_criteria fields in its response.
not_forecaster_idinteger
Example:123
Filters posts where the specified user has not submitted a forecast on a question within the post.
open_time__gtstring date-time
Example:2024-01-01
Post open timestamp filter: open_time__<operator>. Supported operators: gt, gte, lt, lte.
published_at__gtstring date-time
Example:2024-01-01
Post publication timestamp filter: published_at__<operator>. Supported operators: gt, gte, lt, lte.
scheduled_resolve_time__gtstring date-time
Example:2024-01-01
Scheduled resolution timestamp filter: scheduled_resolve_time__<operator>. Supported operators: gt, gte, lt, lte.
forecast_typestring[]
Forecast type. You can apply multiple filters.
[ "numeric", "binary" ]
limitinteger
Example:20
Number of posts to return per page (pagination limit).
offsetinteger
Number of posts to skip (pagination offset).
for_main_feedboolean
Example:true
Filter posts suitable for the main feed.
categoriesstring[]
Category slugs to filter by. You can apply multiple filters.
[ "nuclear", "health-pandemics" ]
order_by'published_at' | 'open_time' | 'vote_score' | 'comment_count' | 'forecasts_count' | 'scheduled_close_time' | 'scheduled_resolve_time' | 'user_last_forecasts_date' | 'unread_comment_count' | 'weekly_movement' | 'divergence' | 'hotness' | 'score'
Example:-published_at
Order by specific fields. For DESC sorting, add - prefix, e.g. -published_at.
Sorting option descriptions:
- hotness: Composite score based on post approval time, relevant news, votes, comments, and question metrics (movement, open time, resolution). Uses a decay function where scores decrease over time (posts older than 3.5 days decay with (days/3.5)^-2).
- score: User-specific forecasting performance score. Requires forecaster_id parameter to be provided.
Response
A paginated list of posts
Example response
{
"next": "https://metaculus.com/api/posts/?forecast_type=binary&limit=1&offset=1",
"results": [
{
"id": 1,
"title": "Binary Post title",
"short_title": "Binary Post url title",
"slug": "numeric-post",
"author_id": 1000,
"author_username": "metaculus",
"projects": {
"site_main": [
{
"id": 144,
"type": "site_main",
"name": "Metaculus Community",
"prize_pool": "0.00",
"default_permission": "forecaster",
"visibility": "normal"
}
],
"tournament": [
{
"id": 144,
"type": "site_main",
"name": "Metaculus Community",
"prize_pool": "0.00",
"default_permission": "forecaster",
"visibility": "normal"
}
],
"category": [
{
"id": 3690,
"name": "Nuclear Technology & Risks",
"slug": "nuclear",
"description": "Nuclear Technology & Risks"
}
],
"tag": [
{
"name": "Space"
}
],
"question_series": [
{
"id": 144,
"type": "site_main",
"name": "Metaculus Community",
"prize_pool": "0.00",
"default_permission": "forecaster",
"visibility": "normal"
}
],
"default_project": {
"id": 144,
"type": "site_main",
"name": "Metaculus Community",
"prize_pool": "0.00",
"default_permission": "forecaster",
"visibility": "normal"
}
},
"created_at": "2024-10-16T12:56:51.751385Z",
"curation_status": "pending",
"comment_count": 10,
"status": "pending",
"nr_forecasters": 5,
"question": {
"id": 2,
"title": "Binary Question",
"description": "string",
"type": "binary",
"options": [
"Democratic",
"Republican",
"Libertarian",
"Green",
"Other"
],
"all_options_ever": [
"Democratic",
"Republican",
"Libertarian",
"Green",
"Blue",
"Other"
],
"options_history": [
[
"0001-01-01T00:00:00",
[
"a",
"b",
"c",
"other"
]
],
[
"2026-10-22T16:00:00",
[
"a",
"b",
"c",
"d",
"other"
]
]
],
"status": "upcoming",
"possibilities": {
"type": "binary"
},
"inbound_outcome_count": 200,
"resolution_criteria": "string",
"fine_print": "string",
"unit": "$",
"scaling": {
"inbound_outcome_count": 200,
"continuous_range": [
"2023-01-01T00:00:00Z",
"2023-01-02T00:00:00Z",
"...",
"2023-01-03T00:00:00Z"
]
}
},
"conditional": {
"id": 1,
"condition": {
"id": 2,
"title": "Binary Question",
"description": "string",
"type": "binary",
"options": [
"Democratic",
"Republican",
"Libertarian",
"Green",
"Other"
],
"all_options_ever": [
"Democratic",
"Republican",
"Libertarian",
"Green",
"Blue",
"Other"
],
"options_history": [
[
"0001-01-01T00:00:00",
[
"a",
"b",
"c",
"other"
]
],
[
"2026-10-22T16:00:00",
[
"a",
"b",
"c",
"d",
"other"
]
]
],
"status": "upcoming",
"possibilities": {
"type": "binary"
},
"inbound_outcome_count": 200,
"resolution_criteria": "string",
"fine_print": "string",
"unit": "$",
"scaling": {
"inbound_outcome_count": 200,
"continuous_range": [
"2023-01-01T00:00:00Z",
"2023-01-02T00:00:00Z",
"...",
"2023-01-03T00:00:00Z"
]
}
},
"condition_child": {
"id": 2,
"title": "Binary Question",
"description": "string",
"type": "binary",
"options": [
"Democratic",
"Republican",
"Libertarian",
"Green",
"Other"
],
"all_options_ever": [
"Democratic",
"Republican",
"Libertarian",
"Green",
"Blue",
"Other"
],
"options_history": [
[
"0001-01-01T00:00:00",
[
"a",
"b",
"c",
"other"
]
],
[
"2026-10-22T16:00:00",
[
"a",
"b",
"c",
"d",
"other"
]
]
],
"status": "upcoming",
"possibilities": {
"type": "binary"
},
"inbound_outcome_count": 200,
"resolution_criteria": "string",
"fine_print": "string",
"unit": "$",
"scaling": {
"inbound_outcome_count": 200,
"continuous_range": [
"2023-01-01T00:00:00Z",
"2023-01-02T00:00:00Z",
"...",
"2023-01-03T00:00:00Z"
]
}
},
"question_yes": {
"id": 2,
"title": "Binary Question",
"description": "string",
"type": "binary",
"options": [
"Democratic",
"Republican",
"Libertarian",
"Green",
"Other"
],
"all_options_ever": [
"Democratic",
"Republican",
"Libertarian",
"Green",
"Blue",
"Other"
],
"options_history": [
[
"0001-01-01T00:00:00",
[
"a",
"b",
"c",
"other"
]
],
[
"2026-10-22T16:00:00",
[
"a",
"b",
"c",
"d",
"other"
]
]
],
"status": "upcoming",
"possibilities": {
"type": "binary"
},
"inbound_outcome_count": 200,
"resolution_criteria": "string",
"fine_print": "string",
"unit": "$",
"scaling": {
"inbound_outcome_count": 200,
"continuous_range": [
"2023-01-01T00:00:00Z",
"2023-01-02T00:00:00Z",
"...",
"2023-01-03T00:00:00Z"
]
}
},
"question_no": {
"id": 2,
"title": "Binary Question",
"description": "string",
"type": "binary",
"options": [
"Democratic",
"Republican",
"Libertarian",
"Green",
"Other"
],
"all_options_ever": [
"Democratic",
"Republican",
"Libertarian",
"Green",
"Blue",
"Other"
],
"options_history": [
[
"0001-01-01T00:00:00",
[
"a",
"b",
"c",
"other"
]
],
[
"2026-10-22T16:00:00",
[
"a",
"b",
"c",
"d",
"other"
]
]
],
"status": "upcoming",
"possibilities": {
"type": "binary"
},
"inbound_outcome_count": 200,
"resolution_criteria": "string",
"fine_print": "string",
"unit": "$",
"scaling": {
"inbound_outcome_count": 200,
"continuous_range": [
"2023-01-01T00:00:00Z",
"2023-01-02T00:00:00Z",
"...",
"2023-01-03T00:00:00Z"
]
}
}
},
"group_of_questions": {
"id": 1,
"questions": [
{
"id": 2,
"title": "Binary Question",
"description": "string",
"type": "binary",
"options": [
"Democratic",
"Republican",
"Libertarian",
"Green",
"Other"
],
"all_options_ever": [
"Democratic",
"Republican",
"Libertarian",
"Green",
"Blue",
"Other"
],
"options_history": [
[
"0001-01-01T00:00:00",
[
"a",
"b",
"c",
"other"
]
],
[
"2026-10-22T16:00:00",
[
"a",
"b",
"c",
"d",
"other"
]
]
],
"status": "upcoming",
"possibilities": {
"type": "binary"
},
"inbound_outcome_count": 200,
"resolution_criteria": "string",
"fine_print": "string",
"unit": "$",
"scaling": {
"inbound_outcome_count": 200,
"continuous_range": [
"2023-01-01T00:00:00Z",
"2023-01-02T00:00:00Z",
"...",
"2023-01-03T00:00:00Z"
]
}
}
]
},
"user_permission": "forecaster"
}
]
}