Yes or No Oracle

Free · No key · JSON

Yes or No API

One GET request returns a random yes, no, or maybe as JSON — with seven themed oracle voices. Free, no sign-up, no API key. Drop it in a bot, a tutorial, or a weekend project.

Try it

GET /api/oracle?tool=magic-8-ball

Endpoint

A single read-only endpoint. No authentication, CORS open to all origins.

GET https://yesnooracle.app/api/oracle

Parameters

ParamValuesDescription
toolsee list belowThemed answer pool. Omit for the general oracle.
forceyes · no · maybeForce a verdict (handy for tests/demos).

Available tools

Response

Every response is JSON. answer is normalized to yes/no/maybe; the extra word and phrase give you a themed headline and a reflective sentence — richer than a bare yes/no.

{
  "answer": "yes",
  "verdict": "yes",
  "word": "The Emperor",
  "phrase": "The Emperor brings order and solid ground. Build on it with confidence — yes.",
  "tool": "tarot",
  "forced": false,
  "image": "https://yesnooracle.app/art-tarot.webp"
}

Examples

cURL

curl https://yesnooracle.app/api/oracle
curl "https://yesnooracle.app/api/oracle?tool=magic-8-ball"

JavaScript

const res = await fetch("https://yesnooracle.app/api/oracle?tool=tarot");
const { answer, word, phrase } = await res.json();
console.log(answer, "—", word); // e.g. "yes — The Emperor"

Python

import requests
r = requests.get("https://yesnooracle.app/api/oracle", params={"tool": "crystal-ball"})
print(r.json()["answer"])  # yes | no | maybe

Fair use

Free for any project — personal or commercial. There is a soft per-IP rate limit (about 60 requests/minute) to keep the oracle responsive for everyone. If you build something with it, a link back to yesnooracle.app is always appreciated but never required.

For reflection and entertainment only. The oracle does not provide medical, legal, or financial advice.

Back to the oracle