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, geen sleutel, geen factuur — de enige voorwaarde is bronvermelding, en een canonical tag wanneer je de volledige tekst publiceert.

Probeer het

full=1

GET /api/v1/daily?lang=en&sign=leo

Draait 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, met een piek van 30, afgedwongen aan de rand. Een syndicatiepartner haalt één keer per dag per taal op en zal hem nooit zien. Er is geen daglimiet en geen quotum om aan te vragen.

Voorbeelden

curl -s "https://sigastra.com/api/v1/daily?lang=nl&sign=leo" | jq .

curl -s "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.canonicalTag

De voorwaarden, volledig

Gratis voor elke site, commercieel of niet. Geen account, geen sleutel, geen tarievenkaart.
Toon de zichtbare “Powered by Sigastra” link, do-follow, wijzend naar de localizedHref die wij teruggeven.
Publiceer je de VOLLEDIGE tekst, voeg dan de canonicalTag uit de payload toe aan de <head> van die pagina.
Presenteer de inhoud niet als door jou berekend — hij ís berekend, en de bronvermelding is wat die bewering controleerbaar maakt.

API FAQ

Is de horoscoop-API echt gratis?+

Ja — geen account, geen sleutel, geen factuur, ook voor commerciële sites. De voorwaarden zijn bronvermelding en, voor volledige tekst, een canonical tag.

Heb ik een API-sleutel nodig?+

Nee. De endpoints werken zonder sleutel en worden in plaats daarvan aan de rand begrensd. De vorm van het antwoord draagt al alles waar een sleutel zich later aan zou hechten, dus er een toevoegen zou je integratie niet breken.

Wat is de snelheidslimiet?+

10 verzoeken per seconde per IP met een piek van 30. Er is geen daglimiet.

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?+

Berekend. Maanfase en aspecten komen rechtstreeks uit de efemeriden; de horoscooptekst wordt dagelijks gegenereerd uit de werkelijke planeetposities van die dag en gecached — de API genereert nooit op jouw verzoek, hij leest wat er al is.

Alles hier is gratis. De enige voorwaarde is een zichtbare do-follow-link — plus een canonical tag als je de volledige tekst publiceert.

Widgets →Syndicatie →WordPress →Overzicht →