Fatebook
  • Loading...

Fatebook API

Use the API to create Fatebook questions from a URL

API Versions

Fatebook offers two versions of the API: v0 and v1. New users should use the v1 API, which offers improved functionality and stability. The v0 documentation is preserved here for users who have already adopted that version.

V1 API (Recommended for new users)

The latest V1 API documentation is available below on this page. You can find detailed information about endpoints and usage in theV1 API Documentation section.

V0 API (Legacy)

The following documentation is for the v0 API. If you're already using this version, you can continue to do so, but we recommend migrating to v1 for new integrations.

Below are examples of two common endpoints. For a complete list of available endpoints and detailed documentation for the v0 API, please refer to theV0 API Documentation section in the OpenAPI specification further down this page.

GET /v0/createQuestion

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

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.

GET /v0/getQuestion

You can also use the API toget 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.

Integrations that other Fatebook users have created: