API - Fatebook

Fatebook API

Use the API to create Fatebook questions from a URL

You can use your API key to create Fatebook questions just by going this URL (separated onto multiple lines for readability):

https://fatebook.io/api/v0/createQuestion?apiKey=YOUR_API_KEY
&title=YOUR_QUESTION_TITLE
&resolveBy=RESOLUTION_DATE_YYYY-MM-DD
&forecast=FORECAST_BETWEEN_0_AND_1

Note: a date by itself will default to a time of 00:00 in the UTC timezone, which may not be the date you intended in your local timezone. You can pass an ISO 8601 datetime for localization; for example, 2025-01-01T00:00+00:00. You can also add some optional parameters, here's an example:

https://fatebook.io/api/v0/createQuestion?apiKey=YOUR_API_KEY
&title=YOUR_QUESTION_TITLE
&resolveBy=RESOLUTION_DATE_YYYY-MM-DD
&forecast=FORECAST_BETWEEN_0_AND_1
&tags=TAG_1
&tags=TAG_2
&sharePublicly=yes
&shareWithLists=LIST_NAME_1
&shareWithLists=LIST_NAME_2
&shareWithEmail=EMAIL_1
&shareWithEmail=EMAIL_2
&hideForecastsUntil=HIDE_FORECASTS_UNTIL_DATE_YYYY-MM-DD

You can use this to integrate Fatebook with other tools, like iOS shortcuts. If you create an integration, let us know and we can tell other Fatebook users about it!

Having trouble? Ask for help in Discord.

Integrations that other Fatebook users have created:

An Obsidian plugin to create and preview Fatebook questions right inside your editor - by D0TheMath
An iOS shortcut to create a Fatebook question - by @JasperGo. You can add it to your homescreen or use Siri to create a question!
An Emacs plugin to create Fatebook questions - by @sonofhypnos
An Alfred workflow to create Fatebook questions - by Caleb Parikh

Use the API to get Fatebook questions by ID

You can also use the API to get Fatebook questions by ID, here's an example:

https://fatebook.io/api/v0/getQuestion?apiKey=YOUR_API_KEY
&questionId=QUESTION_ID

To get the question ID, go to the question page and copy the ID from the URL. The ID is the part after the --, e.g. for this question: https://fatebook.io/q/will-adam-win-the-next-aoe-game---clkqtczp00001l008qcrma6s7 the ID is clkqtczp00001l008qcrma6s7.

Click here to see an example of the getQuestion endpoint in action.