Zero to production in 4 steps

Start buildingright now.

Name: RoxyAPI
Rating: 5.0 (89 reviews)
Author: RoxyAPI

Four progressive tutorials that take you from your first API call to a production app. No astrology knowledge required.

Before you start

A terminal

The built-in app where you type commands. On Mac: Terminal. On Windows: PowerShell or CMD.

A code editor

Any text editor works. We recommend VS Code (free, from code.visualstudio.com).

Node.js (optional)

Only needed for Tutorial 3. Download from nodejs.org. It lets you run JavaScript outside a browser.

Your API key

Get one from the pricing page. Takes 30 seconds. Instant activation.

Get API Key →

Tutorial 1

Your First API Call

5 min

An API is just a URL you send data to and get data back from. Thats it. Lets try it.

Open your terminal and paste this command:

bash

curl -X POST https://roxyapi.com/api/v2/tarot/daily \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{}'

Replace YOUR_API_KEY with your actual key.

You will see a JSON response like this:

json

{
  "date": "2026-03-04",
  "seed": "2026-03-04",
  "card": {
    "id": "star",
    "name": "The Star",
    "arcana": "major",
    "number": 17,
    "position": 1,
    "reversed": false,
    "keywords": ["Hope", "faith", "purpose", "renewal", "spirituality"],
    "meaning": "As The Star follows The Tower in Tarot, it comes as a welcome reprieve...",
    "imageUrl": "https://roxyapi.com/img/tarot/major/star.jpg"
  },
  "dailyMessage": "Your card for 2026-03-04: The Star. Hope, faith, purpose..."
}

What just happened?

You sent a request to the RoxyAPI server. It drew a tarot card for today and sent back structured data as JSON. Your app can now display this card however you want: as text, as a card image, as a push notification. The data is yours to use.

You just made your first API call. Every RoxyAPI endpoint works the same way: send a request, get structured data back.

Tutorial 2

Build a Simple Web Page

15 min

Lets turn that API call into a web page you can open in your browser.

Create a file called index.html and paste this:

html

<!DOCTYPE html>
<html>
<head>
  <title>My Numerology App</title>
  <style>
    body { font-family: system-ui; max-width: 500px; margin: 40px auto; padding: 0 20px; }
    button { padding: 10px 20px; cursor: pointer; font-size: 16px; }
    #result { margin-top: 20px; padding: 20px; background: #f5f5f5; border-radius: 8px; display: none; }
  </style>
</head>
<body>
  <h1>Life Path Calculator</h1>
  <p>Enter your birth date:</p>
  <input type="date" id="birthdate" />
  <button onclick="calculate()">Calculate</button>
  <div id="result"></div>

  <script>
    async function calculate() {
      const date = new Date(document.getElementById('birthdate').value);
      const response = await fetch('https://roxyapi.com/api/v2/numerology/life-path', {
        method: 'POST',
        headers: {
          'Content-Type': 'application/json',
          'X-API-Key': 'YOUR_API_KEY'
        },
        body: JSON.stringify({
          year: date.getFullYear(),
          month: date.getMonth() + 1,
          day: date.getDate()
        })
      });
      const data = await response.json();
      const el = document.getElementById('result');
      el.style.display = 'block';
      el.innerHTML = '<h2>Life Path ' + data.number + ': ' + data.meaning.title + '</h2>'
        + '<p>' + data.meaning.description + '</p>';
    }
  </script>
</body>
</html>

Replace YOUR_API_KEY with your key, then open the file in your browser.

Double-click the file to open it. Pick a birth date, click Calculate, and see your Life Path number with a full interpretation.

What just happened?

Your browser sent the birth date to the Numerology API, which calculated the Life Path number and returned a detailed interpretation. You now have a working numerology calculator. The same pattern works for any endpoint: tarot readings, birth charts, dream interpretation, I-Ching hexagrams.

You built a working web app powered by an API. This is the foundation of every app on the internet: a frontend that calls an API and displays data.

Tutorial 3

Build a Real App

30 min

Skip the boilerplate. Clone a production-ready starter app, add your API key, and ship.

Pick a starter and clone it:

bash

# Tarot app (React Native + Expo)
git clone https://github.com/RoxyAPI/tarot-starter-app.git
cd tarot-starter-app

# Or: Numerology, Astrology, Vedic Astrology, Dreams
# See all starters at roxyapi.com/starters

Install dependencies and add your API key:

bash

npm install
cp .env.example .env

Open .env and paste your API key.

Start the dev server:

bash

npm start

Open the app on your phone with Expo Go, or in the browser. You have a fully working app with dark mode, navigation, and real API data.

From here:

Customize the UI to match your brand
Add your own screens and features
Deploy to App Store / Google Play / web

Browse all starter apps at roxyapi.com/starters

Tutorial 4

Use with AI Tools

5 min

If you use Cursor, Windsurf, Claude, or any AI coding tool, you can build an entire app without writing a single line yourself.

Give your AI assistant the RoxyAPI knowledge base:

text

https://roxyapi.com/llms-full.txt

In Cursor: paste this URL in Settings → Docs. In Claude: share it as context. The AI now knows every endpoint, parameter, and response format.

Ask it to build something:

text

"Build me a React app that shows a daily tarot card reading
with card imagery and interpretation. Use the RoxyAPI tarot
endpoints. My API key is in .env as ROXY_API_KEY."

Or connect via MCP for AI agents:

json

{
  "mcpServers": {
    "roxyapi-tarot": {
      "url": "https://roxyapi.com/mcp/tarot-api",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}

Add this to your Claude Desktop, OpenAI, or any MCP-compatible client. Each product has its own MCP server (e.g. /mcp/vedic-astrology-api, /mcp/numerology-api). See full MCP setup guide.

You dont need to know astrology, tarot, or numerology. The AI handles the integration. You handle the product vision.

Ready to build something real?

Six intelligence domains. 86+ endpoints. One API key. Ship your insight app this weekend.

Get API Key Browse API docs