Find forecasts
Search forecasts by text
Find forecasts about a topic when you don't know their title or ID.
Send the topic as search on GET /questions:
curl --get "https://api.mantic.com/questions" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
--data-urlencode "search=UK inflation at the end of 2026" \
--data-urlencode "show_forecasts=true"Results are ranked by meaning, not keywords, so an exact title match may not come first.
An abridged response looks like this:
{
"questions": [
{
"id": 123,
"title": "Will UK CPI inflation be below 2.5% in December 2026?",
"tags": ["Economics", "United Kingdom"]
}
],
"next": null
}A result's id is its question_id. Search returns a single page of up to 25 results.
Narrow the results
Add a tag filter:
curl --get "https://api.mantic.com/questions" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
--data-urlencode "search=inflation below target" \
--data-urlencode 'filter={"tags":["Economics"]}' \
--data-urlencode "show_forecasts=true"To list every matching forecast rather than a ranked shortlist, filter and sort without search.