# Yes No Oracle

> Free oracle card reading app. Ask a yes-or-no question, draw cards from a deck of 44 unique guides, and receive instant personal guidance. No algorithm — your intention at the moment you click determines your cards.

URL: https://www.yes-no-oracle.com
Languages: English (default), French (/fr), Spanish (/es), German (/de)
Twitter: @yesnooracle

## Product overview

Yes No Oracle offers 8 thematic oracle spreads built on a deck of 44 illustrated guide cards.

**Free (no sign-up required):** Destiny Reading — once per day, 3 cards. Daily Horoscope for all 12 zodiac signs, with optional email delivery.

**Exclusive Access (subscription via Stripe):** All 8 spreads + reading journal + send readings as gifts + Printable Kit.

## The 8 spreads

- **Destiny** (free, 3 cards) — "What awaits me?" / "Is [...] a good idea?" — positions: present · immediate future · in a few months
- **Love** — "Are my feelings justified?" / "How will I meet the love of my life?"
- **Guardian Angel** — "I would like to receive a message from my guardian angel" / "Who is my guardian angel?"
- **Life Purpose** — "What is my life purpose?" / "What steps should I take to advance my career?"
- **Relationship** — "Is [...] my soulmate?" / "What should I expect from this relationship?"
- **Fortune** — "When will I receive more money?" / "What can I do to earn more money?"
- **Guidance** — "What do I need to know?" / "What do I need to know about [...]?"
- **Health** — "Will I (or a loved one) recover?" / "How can I help my recovery?"

## Daily horoscope

Free daily horoscope for the 12 zodiac signs, refreshed every day, available in all 4 languages.

- **5 categories per sign:** general · love · work · money · health
- **Hub:** lists all signs with the latest reading date
- **Sign page:** full daily reading across the 5 categories, plus the next day's preview when available
- **Email delivery (free, no ads, opt-in):** subscribe with just an email, confirm via a double opt-in link, then receive one daily digest covering all 12 signs. One-click unsubscribe in every email.

Localised paths: `/horoscope` (en, fr), `/es/horoscopo`, `/de/horoskop`. Sign slugs are translated (e.g. `aries` → `belier` in fr, `widder` in de).

## Key pages

- [Homepage](https://www.yes-no-oracle.com/): Destiny quick draw
- [Readings](https://www.yes-no-oracle.com/readings): All 8 spreads
- [Daily horoscope hub](https://www.yes-no-oracle.com/horoscope): 12 signs
- [Oracle Blog](https://www.yes-no-oracle.com/blog): guides, testimonials, card reading tips
- [Horoscope API](https://www.yes-no-oracle.com/api-horoscope): landing page and documentation
- [Login](https://www.yes-no-oracle.com/login): Magic link + Google sign-in

Individual spread pages live under `/readings/[slug]` (destiny · love · guardian-angel · life-purpose · relationship · fortune · guidance · health), and per-sign readings under `/horoscope/[sign]`.

Localised paths use a prefix: `/fr/tirages`, `/es/tiradas`, `/de/legungen` (readings hub); `/es/horoscopo`, `/de/horoskop` (horoscope hub).

## Horoscope API

Daily horoscope as a REST + JSON API. Included with Exclusive Access (from $6/month), 5,000 calls per month.

Base URL: `https://www.yes-no-oracle.com/api/v1`
Auth: `Authorization: Bearer <api_key>` (key generated in account settings; an active Exclusive Access subscription is required)

### Endpoint

| Method | Path | Description |
|--------|------|-------------|
| GET | /horoscope/{sign} | Daily horoscope for one sign |

`{sign}` is the English sign name: aries · taurus · gemini · cancer · leo · virgo · libra · scorpio · sagittarius · capricorn · aquarius · pisces

Query parameters:

| Param | Values | Default | Description |
|-------|--------|---------|-------------|
| lang | en · fr · es · de | en | Language of the text |
| theme | general · love · work · money · health | general | Life area the text focuses on |
| length | short · long | long | short = 1-2 sentences; long = full daily reading |

Example:

```
curl "https://www.yes-no-oracle.com/api/v1/horoscope/leo?lang=en&theme=love&length=short" \
  -H "Authorization: Bearer yno_your_api_key"
```

Response:

```json
{
  "data": {
    "sign": "leo",
    "theme": "love",
    "date": "2026-06-13",
    "lang": "en",
    "length": "short",
    "text": "..."
  }
}
```

Headers `X-RateLimit-Limit` and `X-RateLimit-Remaining` report the monthly quota. Content is refreshed every morning; responses can be cached for 24 hours.

### Error codes

| Code | Meaning |
|------|---------|
| 200 | OK |
| 400 | Bad request (invalid sign, lang, theme or length) |
| 401 | Unauthorized / invalid API key |
| 403 | Forbidden (active Exclusive Access subscription required) |
| 404 | Not found (no content for that sign/theme/length yet) |
| 429 | Monthly quota of 5,000 calls exceeded |
| 500 | Server error |

## Sitemap

- [Sitemap](https://www.yes-no-oracle.com/sitemap.xml): full list of URLs