Horoscopes API For Your Website, Apps and White Label Solutions

Features:

• All Horoscopes covered – Daily, Weekly and Monthly
• Horoscope Subtypes Available – Overview, Love and Money
• Content Features: Our horoscopes cover various aspects of life, including love, career, finance, health, and more, providing your users with a comprehensive and insightful reading.
• Customisation: You can request for customisation of content to suit your audience demographics including tone, region, gender, age, length of horoscopes and any other customisation you can think of that needs to part of the content.
• Multiple output formats: We offer multiple formats for retrieving data, including JSON, SQL, and CSV, making it easy to integrate our data into your platform. By default our API returns content in JSON format. If you would like any other format including monthly dump sent by email please request for customisation.
• Developer-friendly: Our API is designed with developers in mind, with code samples, tutorials, and best practices to help you integrate our data into your platform seamlessly. Please feel free to contact support to help with integration.
• Scalable: Our API can handle large volumes of requests and is built on a scalable infrastructure, ensuring fast and reliable performance even during peak usage periods.

Price Plans

We offer both monthly and yearly subscription pricing plans. Our yearly plans offer upto 20% discount over monthly plans. You can cancel anytime. Feel free to get in touch if you have further questions.

Yearly Plans

Monthly Plans

Getting Started and Documentation

Horoscopes JSON RESTful API

If you are looking forward to use our horoscopes on your apps, software or some custom requirements you can send API calls to api.ask-oracle.com/v2/ endpoint with dt date parameters in YYYY-MM-DD format

https://api.ask-oracle.com/v2/?key=demo&dt=2023-04-11

Above returns daily, weekly and monthly horoscopes content in JSON format as per your plan. Use API KEY demo to view our content

Code Samples

Basic Implementation

<?php
$askoracle_api_key = "demo";
//$dt = date("Y-m-d");
$dt = "2023-04-11";
$url = "https://api.ask-oracle.com/v2/?key={$askoracle_api_key}&dt={$dt}";
$data = file_get_contents($url);
$json = json_decode($data);

// Loop through each zodiac sign and retrieve the horoscope
foreach ($json->{'content'}->{'daily'}->{'overview'} as $sign => $horoscope) {
    echo $sign . ' horoscope: ' . $horoscope . '<br>';
}
?>

import requests

url = 'https://api.ask-oracle.com/v2/'
#params = {'key': 'demo', 'dt': date.today().strftime("%Y-%m-%d")}
params = {'key': 'demo', 'dt': '2023-04-11'}

response = requests.get(url, params=params)
json_data = response.json()

# Loop through each zodiac sign and retrieve the horoscope
for sign, horoscope in json_data['content']['daily']['overview'].items():
    print(sign + ' horoscope: ' + horoscope)

//const url = 'https://api.ask-oracle.com/v2/?key=demo&dt=' + new Date().toISOString().split('T')[0];
const url = 'https://api.ask-oracle.com/v2/?key=demo&dt=2023-04-11';

fetch(url)
  .then(response => response.json())
  .then(data => {
    // Loop through each zodiac sign and retrieve the horoscope
    for (const sign in data.content.daily.overview) {
      const horoscope = data.content.daily.overview[sign];
      console.log(sign + ' horoscope: ' + horoscope);
    }
  });

Past and Future Horoscopes

<?php
function fetch_horoscope($api_key, $date) {
    $url = "https://api.ask-oracle.com/v2/?key={$api_key}&dt={$date}";
    $data = file_get_contents($url);
    return json_decode($data);
}

function display_horoscope($json, $day, $sign) {
    $horoscope = $json->{'content'}->{'daily'}->{'overview'}->{$sign};
    echo $day . ' ' . $sign . ' horoscope: ' . $horoscope . '<br>';
}

$askoracle_api_key = "demo";
$current_date = new DateTime();
$yesterday = $current_date->modify('-1 day')->format('Y-m-d');
$tomorrow = $current_date->modify('+2 day')->format('Y-m-d');

$json_yesterday = fetch_horoscope($askoracle_api_key, $yesterday);
$json_tomorrow = fetch_horoscope($askoracle_api_key, $tomorrow);

$sign = 'aries';

display_horoscope($json_yesterday, 'Yesterday\'s', $sign);
echo '<br>';
display_horoscope($json_tomorrow, 'Tomorrow\'s', $sign);
?>

import requests
from datetime import datetime, timedelta

def fetch_horoscope(api_key, date):
    url = f"https://api.ask-oracle.com/v2/?key={api_key}&dt={date}"
    response = requests.get(url)
    return response.json()

def display_horoscope(json_data, day, sign):
    horoscope = json_data['content']['daily']['overview'][sign]
    print(f"{day} {sign} horoscope: {horoscope}")

askoracle_api_key = "demo"
current_date = datetime.now()
yesterday = (current_date - timedelta(days=1)).strftime('%Y-%m-%d')
tomorrow = (current_date + timedelta(days=1)).strftime('%Y-%m-%d')

json_yesterday = fetch_horoscope(askoracle_api_key, yesterday)
json_tomorrow = fetch_horoscope(askoracle_api_key, tomorrow)

sign = 'aries'

display_horoscope(json_yesterday, "Yesterday's", sign)
print()
display_horoscope(json_tomorrow, "Tomorrow's", sign)

const fetchHoroscope = async (apiKey, date) => {
  const url = `https://api.ask-oracle.com/v2/?key=${apiKey}&dt=${date}`;
  const response = await fetch(url);
  return await response.json();
};

const displayHoroscope = (json, day, sign) => {
  const horoscope = json.content.daily.overview[sign];
  console.log(`${day} ${sign} horoscope: ${horoscope}`);
};

const askoracleApiKey = 'demo';
const currentDate = new Date();
const yesterday = new Date(currentDate);
yesterday.setDate(yesterday.getDate() - 1);
const yesterdayFormatted = yesterday.toISOString().split('T')[0];

const tomorrow = new Date(currentDate);
tomorrow.setDate(tomorrow.getDate() + 1);
const tomorrowFormatted = tomorrow.toISOString().split('T')[0];

const sign = 'Aries';

fetchHoroscope(askoracleApiKey, yesterdayFormatted).then((jsonYesterday) => {
  displayHoroscope(jsonYesterday, "Yesterday's", sign);
});

fetchHoroscope(askoracleApiKey, tomorrowFormatted).then((jsonTomorrow) => {
  displayHoroscope(jsonTomorrow, "Tomorrow's", sign);
});

WordPress Plugin

Step 1: Upload and Activate the Plugin

1. Go to the WordPress Admin Dashboard.
2. Navigate to “Plugins” > “Add New Plugin”.
3. Download the plugin zip file and upload it on your WordPress Add New Plugin screen.

Step 2: Use the Shortcode

You can now use the shortcode [horoscope sign="gemini" category="daily" type="overview" showPrevNext="true"] in posts or pages to display the horoscope for Gemini.

Step 3: Configure the API Key

1. Go to “Settings” > “Horoscope” in the WordPress Admin Dashboard.
2. Enter your API key and save changes.

Example usage in a wordpress page or post:

[horoscope sign="gemini" category="daily" type="overview" showPrevNext="true"]

Frequently Asked Questions

Live Demo