API met horoscoop- en astrologiegegevens voor partners
Een alleen-lezen JSON API bovenop dezelfde hoogprecieze efemeriden waarop Sigastra draait: dagelijkse, wekelijkse en maandelijkse horoscopen voor alle twaalf tekens in vijftien talen, plus de actuele maanfase, de planetaire aspecten van vandaag en tekencompatibiliteit. Geen account en geen factuur; server-side aanroepen noemen je site (adres of gratis sleutel). De enige voorwaarde is bronvermelding, en een canonical tag wanneer je de volledige tekst publiceert.
Probeer het
GET /api/v1/daily?lang=en&sign=leoDraait tegen de live API vanuit je browser. CORS staat open, dus dit is meteen een werkend voorbeeld van een integratie aan de clientkant.
Endpoints
GET /api/v1/daily | lang, sign, full | De horoscoop van vandaag. Alle twaalf tekens, of één. |
GET /api/v1/weekly | lang, sign, full | De huidige week, met periodesleutel en bereiklabel. |
GET /api/v1/monthly | lang, sign, full | De huidige maand. |
GET /api/v1/moon | lang | Verlichte fractie, fase, wassend/afnemend, maanteken. Pure efemeriden. |
GET /api/v1/cosmic | lang | De strakste planeet-tot-planeet aspecten van de dag, met orben. Pure efemeriden. |
GET /api/v1/compat | lang, a, b | Deterministische tekencompatibiliteit: score, band, element- en modaliteitsrelatie. |
Parameters
- lang
- Een van de vijftien bediende talen (en, de, tr, ro, pl, es, sr, hr, nl, sl, pt-BR, fr, it, ja, id). Al het andere valt terug op Engels in plaats van een fout te geven.
- sign
- De Engelse sleutel (leo), de Engelse slug (leo) of de eigen slug van de taal (leeuw). Laat weg voor alle twaalf.
- full
- full=1 geeft de volledige tekst in plaats van een teaser. Dat is de syndicatiemodus en die zet de canonical-verplichting aan.
- a, b
- Alleen voor compat. Twee tekens, in elk van de aanvaarde vormen.
Teaser of volledige tekst
Standaard draagt elk item een teaser: genoeg voor een kaart, een zijbalk of een feedregel. Voeg full=1 toe en je krijgt de volledige tekst, plus een sections-object dat overeenkomt met de bronpagina. Volledige tekst is bedoeld om te herpubliceren, dus het attribution-object zet canonicalRequired op true en geeft je de exacte tag om te plakken.
Snelheidslimiet
10 verzoeken per seconde per IP aan de rand, piek van 30, en een daglimiet van 1.500 verzoeken per adres. Een uitgever die twaalf tekens over dagelijks, wekelijks en maandelijks ophaalt, vier keer per dag, gebruikt er ongeveer 150: u raakt geen van beide limieten. Boven de daglimiet volgt HTTP 429 met een link naar deze pagina. Meer volume nodig? Mail naar info@sigastra.com en vertel ons waar de inhoud draait.
Voorbeelden
curl -s -H "Referer: https://example.com/horoscope" "https://sigastra.com/api/v1/daily?lang=nl&sign=leo" | jq .
curl -s -H "x-sigastra-key: YOUR_KEY" "https://sigastra.com/api/v1/weekly?lang=nl&sign=leo&full=1" | jq '.attribution.canonicalTag'
const res = await fetch("https://sigastra.com/api/v1/daily?lang=nl&sign=leo");
const { items, attribution } = await res.json();
document.querySelector("#horoscope").textContent = items[0].text;
document.querySelector("#credit").outerHTML =
`<a href="${attribution.localizedHref}">${attribution.text}</a>`;
// Publishing the FULL text (full=1)? Also put this in <head>:
// attribution.canonicalTagTelegramkanalen, stap voor stap
- Open sigastra.com/api/partners/verify?site=t.me/jouwkanaal. Het kanaal moet openbaar zijn; je krijgt meteen de gratis sleutel, en de proefperiode van drie dagen begint bij de eerste aanroep.
- Je bot roept de API aan met de sleutel, bijvoorbeeld /api/v1/daily?lang=nl&sign=leo&key=JOUW_SLEUTEL, en plaatst de tekst (ingekort of vertaald mag, zie de voorwaarden).
- Minstens één van je laatste tien berichten linkt naar sigastra.com met het woord “Sigastra”, zonder gat van meer dan zeven dagen. We controleren de openbare preview van het kanaal automatisch.
API FAQ
Is de horoscoop-API echt gratis?+
Ja, op elke site, commercieel of niet. Vanaf je eerste aanroep heb je drie dagen om te testen. Daarna wordt je pagina om de paar uur automatisch gecontroleerd: zonder de link pauzeert de inhoud, en die komt terug zodra de link weer gemeten is. Wil je meteen laten controleren, open dan sigastra.com/api/partners/verify?site=jouwdomein.nl.
Heb ik een API-sleutel nodig?+
Aanroepen vanuit de browser (widgets, of een pagina die zelf de API aanroept) sturen hun paginaadres vanzelf mee en hebben verder niets nodig. Aanroepen vanaf je server moeten zeggen voor welke site de inhoud is: stuur het adres van die pagina mee als Referer-header (onze WordPress-plug-in doet dat voor je). Zodra je site de linkcontrole heeft doorstaan, geeft het controleadres je ook een gratis sleutel. Vanaf 15 oktober 2026 wordt een serveraanroep die geen van beide meestuurt geweigerd.
Wat is de snelheidslimiet?+
10 verzoeken per seconde per IP aan de rand, piek van 30, plus een daglimiet van 1.500 verzoeken per adres. Een uitgever gebruikt er ongeveer 150 per dag en raakt geen van beide. Erboven: HTTP 429: mail naar info@sigastra.com voor meer volume.
Mag ik de hele horoscoop herpubliceren?+
Ja, met full=1, en dan moet je de canonical tag toevoegen die de payload je geeft. Zonder die tag concurreren twee identieke pagina’s en kiest een zoekmachine er één; de canonical is wat die keuze geen muntworp laat zijn.
Welke talen dekt de astrologie-API?+
Vijftien: en, de, tr, ro, pl, es, sr, hr, nl, sl, pt-BR, fr, it, ja, id. Namen van tekens, planeten, aspecten en fasen zijn allemaal gelokaliseerd.
Zijn de gegevens berekend of geschreven?+
Allebei. Planeetstanden, maanfase en aspecten worden berekend uit de efemeriden. De horoscooptekst wordt één keer per dag door AI geschreven (Claude, van Anthropic) op basis van de berekende standen van die dag en daarna in de cache bewaard: de API schrijft nooit iets op jouw verzoek, hij leest wat er al is.
Mag ik dit in een mobiele app gebruiken?+
Niet in een native app. Het programma is gratis omdat de inhoud op een openbare pagina of in een openbaar kanaal met de link staat, en een app heeft geen van beide. Een website of een openbaar Telegramkanaal is prima; voor al het andere schrijf je naar info@sigastra.com.
Alles hier is gratis. De enige voorwaarde is een zichtbare link: plus een canonical tag als je de volledige tekst publiceert.
Zo werkt gratis
- 3 dagen om te testen: in die tijd is nog geen link nodig.
- Vanaf dag 4: een zichtbare link naar sigastra.com waarvan de tekst het woord "Sigastra" bevat, op de pagina die de inhoud toont, voor iedereen leesbaar zonder inloggen. Je eigen taal mag: "Powered by Sigastra", "Horoscoop van Sigastra" of gewoon "Sigastra". Niet in het widget-frame en niet verborgen. Of je rel="nofollow" toevoegt, is jouw keuze.
- Zonder die link pauzeert de inhoud op elk oppervlak (widget, afbeeldingen, JSON) en zegt het antwoord precies wat er moet komen. We meten je live pagina automatisch.
Link geplaatst? Open /api/partners/verify?site=jouw-domein.nl en de inhoud loopt binnen enkele minuten weer. Je site krijgt automatisch een gratis partnersleutel zodra de link is gemeten.