{"id":14959224,"url":"https://github.com/sameerkumar18/aztro","last_synced_at":"2025-04-06T04:10:21.494Z","repository":{"id":22105819,"uuid":"95226803","full_name":"sameerkumar18/aztro","owner":"sameerkumar18","description":"The Astrology API 💫 Get daily horoscope!","archived":false,"fork":false,"pushed_at":"2023-03-31T15:26:11.000Z","size":141,"stargazers_count":299,"open_issues_count":12,"forks_count":77,"subscribers_count":12,"default_branch":"master","last_synced_at":"2025-03-30T03:03:58.263Z","etag":null,"topics":["api","astro","astrology","horoscope","horoscope-api","python","rest-api","restful-api","zodiac-api","zodiac-sign"],"latest_commit_sha":null,"homepage":"https://aztro.sameerkumar.website","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sameerkumar18.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":"contributing.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"sameerkumar18","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2017-06-23T14:17:38.000Z","updated_at":"2025-03-27T14:23:21.000Z","dependencies_parsed_at":"2024-12-30T09:11:31.947Z","dependency_job_id":"d81cf96a-8a04-4c4f-a1be-1b9d2ced4d78","html_url":"https://github.com/sameerkumar18/aztro","commit_stats":{"total_commits":116,"total_committers":11,"mean_commits":"10.545454545454545","dds":0.2931034482758621,"last_synced_commit":"cfada7fd1e3db38996811c1bef55cb9b66803ca6"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sameerkumar18%2Faztro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sameerkumar18%2Faztro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sameerkumar18%2Faztro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sameerkumar18%2Faztro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sameerkumar18","download_url":"https://codeload.github.com/sameerkumar18/aztro/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247430870,"owners_count":20937874,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","astro","astrology","horoscope","horoscope-api","python","rest-api","restful-api","zodiac-api","zodiac-sign"],"created_at":"2024-09-24T13:19:10.888Z","updated_at":"2025-04-06T04:10:21.393Z","avatar_url":"https://github.com/sameerkumar18.png","language":"Python","funding_links":["https://github.com/sponsors/sameerkumar18","https://www.buymeacoffee.com/sameerkumar"],"categories":[],"sub_categories":[],"readme":"\n#################################\naztro - The astrology API \n#################################\n Free and open API. Needs no authentication\n|Travis| |Docs| |Maintenance yes| |SayThanks| |Paypal|\n    \n    \n.. image:: https://github.com/sameerkumar18/aztro/raw/master/aztro-bg.png\n   :height: 412px\n   :width: 898px\n   :alt: aztro api logo\n   :align: center\n\nWhat is aztro?\n==============\naztro REST API allows developers to access and integrate the functionality of aztro with other applications. The API retrieves daily horoscopes for yesterday, today, and tomorrow.\n\nFeel free to contribute on `Github \u003chttp://github.com/sameerkumar18/aztro\u003e`_.\n\n\n\n\nWhy aztro?\n==========\naztro is for a developer who wants an API that provides horoscope info for sun signs such as Lucky Number, Lucky Color, Mood, Color, Compatibility with other sun signs, description of a sign for that day etc.\n\nURL\n===\n.. code-block:: python\n\n    POST: https://aztro.sameerkumar.website\n\n\nParameters\n==========\nsign : \n   Name of the sign.\n\n   List of all signs - aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius and pisces.\n\n\nday : \n   Day can be today,tomorrow or yesterday\n\n\nUsage\n=====\n.. code-block:: text\n\n    POST: https://aztro.sameerkumar.website?sign= \u003csign\u003e \u0026day= \u003cday\u003e\n\n\nExample \n=======\nThe following example is for sun sign aries - \n\n\ncURL\n^^^^\n.. code-block:: python\n\n    curl -X POST \\\n    'https://aztro.sameerkumar.website/?sign=aries\u0026day=today'\n\n\nPython\n^^^^^^\n.. code-block:: python\n\n    import requests\n\n    params = (\n    ('sign', 'aries'),\n    ('day', 'today'),\n    )\n\n    requests.post('https://aztro.sameerkumar.website/', params=params)\n\n\nNode.js\n^^^^^^^\n.. code-block:: javascript\n\n    var request = require('request');\n\n    var options = {\n    url: 'https://aztro.sameerkumar.website/?sign=aries\u0026day=today',\n    method: 'POST'\n    };\n\n    function callback(error, response, body) {\n    if (!error \u0026\u0026 response.statusCode == 200) {\n        console.log(body);\n    }\n    }\n\n    request(options, callback);\n\n\nPHP\n^^^\n.. code-block:: php\n\n    \u003c?php\n\n        //This function can be used in any PHP framework like laravel, wordpress, drupal, cakephp etc.\n\n        function aztro($sign, $day) {\n            $aztro = curl_init('https://aztro.sameerkumar.website/?sign='.$sign.'\u0026day='.$day);\n            curl_setopt_array($aztro, array(\n                CURLOPT_POST =\u003e TRUE,\n                CURLOPT_RETURNTRANSFER =\u003e TRUE,\n                CURLOPT_HTTPHEADER =\u003e array(\n                    'Content-Type: application/json'\n                )\n            ));\n            $response = curl_exec($aztro);\n            if($response === FALSE){\n                die(curl_error($aztro));\n            }\n            $responseData = json_decode($response, TRUE);\n            return $responseData;\n        }\n\n        $ObjData = aztro('aries', 'today');\n        var_dump($ObjData);\n\n    ?\u003e\n    \n    \njQuery Ajax\n^^^^^^\n.. code-block:: javascript\n\n    $.ajax({\n   type:'POST',\n   url:'https://aztro.sameerkumar.website?sign=aries\u0026day=today',\n   success:function(data){\n   console.log(data);\n   }\n    });\n\n\nECMAScript (ES6)\n^^^^^^\n.. code-block:: javascript\n\n    const URL = 'https://aztro.sameerkumar.website/?sign=aries\u0026day=today';\n    fetch(URL, {\n        method: 'POST'\n    })\n    .then(response =\u003e response.json())\n    .then(json =\u003e {\n        const date = json.current_date;\n        console.log(date);\n    });\n\n\nVue.JS using axios\n^^^^^^^^^^^^^^^^^^\n.. code-block:: html\n\n    \u003cul id=\"aztro\"\u003e\n        \u003cli\u003eCurrent Date: {{data.current_date}}\u003c/li\u003e\n        \u003cli\u003eCompatibility: {{data.compatibility}}\u003c/li\u003e\n        \u003cli\u003eLucky Number: {{data.lucky_number}}\u003c/li\u003e\n        \u003cli\u003eLucky Time: {{data.lucky_time}}\u003c/li\u003e\n        \u003cli\u003eColor: {{data.color}}\u003c/li\u003e\n        \u003cli\u003eDate Range: {{data.date_range}}\u003c/li\u003e \n        \u003cli\u003eMood: {{data.mood}}\u003c/li\u003e\n        \u003cli\u003eDescription: {{data.description}}\u003c/li\u003e\n    \u003c/ul\u003e\n\n.. code-block:: javascript\n\n    const URL = 'https://aztro.sameerkumar.website/?sign=aries\u0026day=today';\n    new Vue({\n        el: '#aztro',\n        data() {\n                return {\n                data: {}\n            }\n        },\n        created() {\n            axios.post(URL).then((response) =\u003e {\n                this.data = response.data\n            })\n        }\n    })\n\n\nReactJS with ES6\n^^^^^^\n.. code-block:: jsx\n    \n    import React, { Component } from 'react';\n\n    class Aztro extends Component {\n        constructor(props){\n            super(props);\n            this.state = {\n              json: {}\n            }\n        }\n        \n        componentDidMount () {\n            const URL = 'https://aztro.sameerkumar.website/?sign=aries\u0026day=today';\n            fetch(URL, {\n                method: 'POST'\n            }).then(response =\u003e response.json())\n            .then(json =\u003e { this.setState({json}); });\n        }\n        \n        render() {\n            return (\n              \u003cdiv\u003e\n                  Current Date: {this.state.json.current_date} \u003cbr /\u003e\n                  Compatibility: {this.state.json.compatibility} \u003cbr /\u003e\n                  Lucky Number: {this.state.json.lucky_number} \u003cbr /\u003e\n                  Lucky Time: {this.state.json.lucky_time} \u003cbr /\u003e\n                  Color: {this.state.json.color} \u003cbr /\u003e\n                  Date Range: {this.state.json.date_range} \u003cbr /\u003e\n                  Mood: {this.state.json.mood} \u003cbr /\u003e\n                  Description: {this.state.json.description} \u003cbr /\u003e\n              \u003c/div\u003e\n            );\n        }\n    }\n\n    export default Aztro;\n\n\nGolang\n^^^^^^\n.. code-block:: Golang\n\n    package main\n\n    import (\n        \"fmt\"\n        \"log\"\n\n        \"github.com/irfansofyana/go-aztro-api-wrapper/aztro\"\n    )\n\n    func main() {\n        aztroClient, err := aztro.NewAztroClient()\n        if err != nil {\n            log.Fatal(err)\n        }\n\n        aztroParam := aztro.NewAztroRequestParam(aztro.Taurus)\n        todayHoroscope, aztroErr := aztroClient.GetHoroscope(aztroParam)\n        if aztroErr != nil {\n            log.Fatal(aztroErr)\n        }\n        fmt.Println(todayHoroscope) // Get today's horoscope\n\n        tmrrowParam := aztro.NewAztroRequestParam(\n            aztro.Taurus,\n            aztro.WithDay(aztro.Tomorrow),\n        )\n        tmrrwHoroscope, aztroErr := aztroClient.GetHoroscope(tmrrowParam)\n        if aztroErr != nil {\n            log.Fatal(aztroErr)\n        }\n        fmt.Println(tmrrwHoroscope) // Get tomorrow's horoscope\n    }\n\n\nResponse\n^^^^^^^^\n.. code-block:: json\n\n    {\"current_date\": \"June 23, 2017\", \"compatibility\": \" Cancer\", \"lucky_time\": \" 7am\",\n     \"lucky_number\": \" 64\", \"color\": \" Spring Green\", \"date_range\": \"Mar 21 - Apr 20\",\n     \"mood\": \" Relaxed\", \"description\": \"It's finally time for you to think about just\n      one thing: what makes you happy. Fortunately, that happens to be a person who feels\n      the same way. Give yourself the evening off. Refuse to be put in charge of anything.\"}\n\n\nTests\n=======\n.. code-block:: text\n\n    pip install nose\n    nosetests tests\n\nProjects using aztro API\n========================\n\n.. raw:: html\n\n   \u003ctable\u003e \n    \u003ctr\u003e\n      \u003cth\u003eRepository\u003c/th\u003e\n      \u003cth\u003eDescription\u003c/th\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003e\n        \u003ca href=\"https://github.com/Bratanov/community-driven-radio\"\u003eCommunity Driven Radio\u003c/a\u003e\n      \u003c/td\u003e\n      \u003ctd\u003eA radio station driven by the community\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003e\n        \u003ca href=\"https://github.com/andreslopezrm/WatchOS_Swift_Horoscope\"\u003eHoroscope Apple Watch App\u003c/a\u003e\n      \u003c/td\u003e\n      \u003ctd\u003eApple Watch Application for Horoscope\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003e\n        \u003ca href=\"https://github.com/sergeKashkin/daily_scope\"\u003eYour Daily Horoscope\u003c/a\u003e\n      \u003c/td\u003e\n      \u003ctd\u003eReact app which shows your daily horoscope\u003c/td\u003e\n    \u003c/tr\u003e\n    \n    \u003c/table\u003e\n\n\nUsed aztro API in your project? Check out the `contributing guidelines \u003chttps://github.com/sameerkumar18/aztro/blob/master/contributing.md\u003e`_ for this list and let us know. we love PRs :)\n\n\nAPI Wrappers\n============\n\nFor Python - `PyAztro \u003chttps://github.com/sameerkumar18/pyaztro\u003e`_ (pip install pyaztro)\n\nFor NodeJS - `aztro-js \u003chttps://github.com/srijitcoder/aztro-js\u003e`_ (npm install aztro-js)\n\nFor Golang - `go-aztro-api-wrapper \u003chttps://github.com/irfansofyana/go-aztro-api-wrapper\u003e`_ (go get github.com/irfansofyana/go-aztro-api-wrapper)\n\n\nLicense\n=======\n\n2021 Sameer Kumar\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\n\n\nContact\n=======\n\nQuestions? Suggestions? Feel free to contact me at sam+aztro-ghreadme@sameerkumar.website\n\n\nBuy me a coffee 🥤\n=====================\n\nIf this project helped you reduce the development time, please consider donating :) \n\n.. image:: https://i.giphy.com/media/513lZvPf6khjIQFibF/giphy.webp\n    :target: https://www.buymeacoffee.com/sameerkumar\n\n\nCredits\n=======\n\n\"aztro\" was created by `Sameer Kumar \u003chttps://sameerkumar.website\u003e`_ and these awesome individual `contributors \u003chttps://github.com/sameerkumar18/aztro/graphs/contributors\u003e`_\n\nSource of horoscope updates - http://astrology.kudosmedia.net/\n\nPlease feel free to use and adapt this small API.\n\n    \n.. |Docs| image:: https://readthedocs.org/projects/aztro/badge/?version=latest\n    :target: https://aztro.readthedocs.io/en/latest/?badge=latest\n    \n.. |Maintenance yes| image:: https://img.shields.io/badge/Maintained%3F-yes-green.svg\n   :target: https://gitHub.com/sameerkumar18/pyaztro\n\n\n.. |Travis| image:: https://travis-ci.org/sameerkumar18/aztro.svg?branch=master\n    :target: https://travis-ci.org/sameerkumar18/aztro\n\n.. |SayThanks| image:: https://img.shields.io/badge/Say%20Thanks-!-1EAEDB.svg\n    :target: https://saythanks.io/to/sameer18051998%40gmail.com\n\n.. |Paypal| image:: https://img.shields.io/badge/Paypal-Donate-blue.svg\n    :target: https://www.buymeacoffee.com/sameerkumar\n\n.. Indices and tables\n.. ==================\n\n.. * :ref:`genindex`\n.. * :ref:`modindex`\n.. * :ref:`search`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsameerkumar18%2Faztro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsameerkumar18%2Faztro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsameerkumar18%2Faztro/lists"}