# 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.

**Full Access (subscription via Stripe, from $4.99/month billed yearly, 3-day free trial):**

- All 8 spreads, unlimited
- Reading journal that keeps every draw
- Send a reading as a gift
- Printable Kit: a PDF to print your own 44-card paper deck, with assembly guide, card backs and oracle manual
- Paper readings: run a guided reading with your printed deck and scan the cards with your phone camera (or enter them by hand) to read their meaning and save the reading to your journal
- Share a single card as a 9:16 story visual

Sign-in is by magic link or Google. The login page is excluded from crawling in robots.txt, so it is not listed below.

## 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` becomes `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
- [Author profile](https://www.yes-no-oracle.com/author/nicolas): Nicolas, author of the blog articles
- [Horoscope API](https://www.yes-no-oracle.com/api-horoscope): landing page and documentation

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); `/es/api-horoscopo`, `/de/horoskop-api` (API landing page).

## Horoscope API

Daily horoscope as a REST + JSON API. Included with Full Access (from $4.99/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 Full 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 Full 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