Astroletra. Disseny i desenvolupament d’un almanac del cel amb API i dades obertes
Astroletra és un horòscop diari i un almanac del cel en castellà, per a Espanya i Llatinoamèrica. La vam dissenyar i desenvolupar de cap a peus. Calcula el cel amb les efemèrides JPL DE440 i obre les dades amb una API gratuïta i un DOI.
De què va aquest projecte
Astroletra publica cada dia l’horòscop dels dotze signes i un almanac del cel en castellà, pensat per a lectors d’Espanya i de Llatinoamèrica. Al costat de cada lectura hi ha la dada, l’hora de la Lluna, dels eclipsis i dels planetes, calculada i posada a l’hora de cada ciutat.
Ens en vam encarregar de cap a peus, de la marca i el disseny al motor de càlcul, l’API, les dades obertes i el SEO. Els càlculs surten de les efemèrides JPL DE440, del Jet Propulsion Laboratory de la NASA, i les dades són obertes, amb una API gratuïta i un DOI perquè qualsevol les pugui citar i comprovar.
Aquí expliquem com vam resoldre les peces que més feina van donar, el càlcul, l’eclipsi municipi a municipi i les dades obertes. És la mena de projecte que ens agrada, una web on cada dada es pot comprovar.
El projecte
- Dades obertes
- DOI 10.5281/zenodo.24132871
- API pública
- Documentació de l’API
- Eclipsi per municipi
- El cercador dels 8.132 municipis
- Mercat
- Espanya i Llatinoamèrica
- Serveis
- Disseny i desenvolupament web, marca, SEO, dades obertes i API pública
- Idioma de la web
- Castellà
- Estat
- En línia
Com va començar
Astroletra havia de servir alhora per llegir l’horòscop de cada dia i per saber a quina hora passa de veritat cada cosa al cel. Volia arribar a lectors d’Espanya i de Llatinoamèrica, i que la dada sempre es pogués comprovar. La vam començar al novembre.
Què vam decidir
La imatge d’Astroletra
També vam fer la marca. El logo és una tessel·la que va del blau de Prússia al blau de nit, amb una A de paper i un anell de llum al voltant, com el d’un planeta. Al costat hi ha el nom, en Ibarra Real Nova, una lletra amb aire de capçalera de diari.
La resta segueix el mateix to, el paper i la tinta d’un diari, el blau de Prússia i un ocre, i un color propi per a cada signe. Volíem que Astroletra semblés un diari ben fet, i no una web d’horòscops com les altres.
El logo té versions per a fons clar i fosc, i la tessel·la sola fa d’icona al mòbil i a la pestanya del navegador.
- Paper
- Tinta
- Blau de Prússia
- Ocre
El logo d’Astroletra per a fons fosc i els quatre colors de la marca. Disseny de crida studio. La dada i la lectura, cadascuna al seu lloc
A la portada, la dada i la lectura van per separat. A un costat hi ha el cel d’avui, amb la Lluna, la sortida i la posta i l’hora de cada moment a la ciutat de qui llegeix. A l’altre, els dotze signes per triar el teu.
Així qui hi entra sap què és càlcul i què és interpretació, i pot canviar la ciutat perquè totes les hores s’hi ajustin.

El cel d’avui a la portada d’Astroletra, al mòbil, el 19 de novembre de 2026. Captura de crida studio. Cada hora, calculada amb les efemèrides JPL DE440
Les hores de la Lluna, els eclipsis, els planetes retrògrads i les entrades del Sol a cada signe no es copien d’enlloc. Les calcula el motor que vam fer, amb les efemèrides JPL DE440 del Jet Propulsion Laboratory de la NASA, i després es passen a l’hora de cada lloc.
Les dades donen l’hora local de vuit ciutats, Madrid, Londres, Nova York, Los Angeles, Ciutat de Mèxic, Bogotà, Santiago i Buenos Aires, i la web dona l’hora de cada lluna a Espanya, Mèxic, Colòmbia, el Perú, l’Argentina i Xile.
De les mateixes dades surten les pàgines de la web, l’API i els fitxers oberts, de manera que tot diu sempre el mateix.
- Efemèrides JPL DE440On són la Lluna, el Sol i els planetes a cada moment.
- El càlculLes fases, els eclipsis, els retrògrads i les entrades del Sol, amb la seva hora.
- L’hora de cada llocCada moment passat a la zona horària de cada ciutat.
Una sola fontLes pàgines, l’API i els fitxers oberts surten de les mateixes dades.Com es calcula cada hora que surt a Astroletra. L’eclipsi total de l’agost, municipi a municipi
Per a l’eclipsi total de Sol del 2 d’agost vam fer un cercador amb els 8.132 municipis d’Espanya, amb les dades de l’INE. Cadascú escriu el seu, o fa servir la ubicació, i veu a quina hora comença, quan és total, quant dura i quan acaba.
La totalitat es veurà en 104 municipis, a més de Ceuta i Melilla. Un mapa marca la franja on serà total, una llista ordena els municipis per la durada i cada província té la seva pàgina. La ubicació es fa servir al mateix telèfon i no en surt.


La pàgina de l’eclipsi del 2 d’agost de 2027, amb el mapa de la franja a l’ordinador i Tarifa triada al mòbil, el 19 de novembre de 2026. Captures de crida studio. Dades obertes amb DOI i una API gratuïta
Les dades calculades es poden descarregar en CSV, JSON i iCal, amb llicència CC BY 4.0. Són tres anys de cel, amb 75 llunes noves i plenes, 14 eclipsis i 18 períodes retrògrads, i 1.272 entrades del Sol a cada signe al llarg de 106 anys, amb l’hora local de les vuit ciutats.
Les publiquem a Zenodo amb un DOI que porta sempre a l’última versió, i també a GitHub i Hugging Face, perquè un periodista o un investigador les pugui citar amb un identificador que no canvia.
Per a dates i zones a mida hi ha una API pública, gratuïta, sense clau ni registre i oberta a qualsevol web, descrita en OpenAPI 3.1. Admet 60 peticions per minut i dates de fins a set dies abans o després d’avui, perquè sigui oberta sense que se’n pugui abusar.


Les dades obertes a l’ordinador i l’API pública al mòbil, el 19 de novembre de 2026. Captures de crida studio.
Què hi vam fer
Tota la web, del disseny de la primera pàgina a les dades que es poden descarregar.
- Logo i imatgeLa tessel·la amb la A, el nom i els colors de la marca.
- Disseny de la webDe la portada a l’última fitxa, en clar i en fosc.
- DesenvolupamentLes pàgines, el cercador i la navegació.
- Motor de càlculAmb les efemèrides JPL DE440, per a la Lluna, els eclipsis i els planetes.
- Eclipsi municipi a municipiEls 8.132 municipis d’Espanya, amb el mapa de la franja.
- Dades obertesEn CSV, JSON i iCal, a Zenodo amb DOI, GitHub i Hugging Face.
- API públicaGratuïta i sense clau, descrita en OpenAPI.
- CalendarisPer subscriure’s a les llunes, els eclipsis i els retrògrads.
- SEOPerquè cada pàgina es pugui trobar i entendre a Google.
Preguntes sobre el projecte
Feu webs a partir de dades pròpies o calculades?
Sí. Astroletra n’és un exemple, amb pàgines que surten de dades calculades i que qualsevol pot comprovar. Si tens dades que vols convertir en pàgines útils, explica’ns què tens i com les fas servir ara.
Què vol dir publicar dades obertes amb DOI?
Que les dades es poden descarregar i citar amb un identificador permanent. Les d’Astroletra són a Zenodo amb un DOI que porta sempre a l’última versió, amb llicència CC BY 4.0, i la web explica com citar-les.
Una API gratuïta no pot sortir cara?
Pot, si no té límits. La d’Astroletra no demana clau ni registre, però admet 60 peticions per minut i només dates de fins a set dies d’avui, i qui vol les dades de tres anys les baixa en fitxers.
Treballeu amb projectes de fora de Catalunya?
Sí. Astroletra és per a lectors d’Espanya i de Llatinoamèrica, i treballem amb empreses de tot Espanya i de fora, a distància.
Crèdits
- Marca, disseny, desenvolupament, càlcul, API, dades obertes i SEO
- crida studio
- Efemèrides
- JPL DE440, del Jet Propulsion Laboratory de la NASA
- Municipis
- Institut Nacional d’Estadística
- Captures d’aquesta pàgina
- crida studio, 19 de novembre de 2026
Publicat el Actualitzat el
Tens dades que vols convertir en una web?
Si tens dades pròpies i vols que la gent les pugui consultar, citar o fer servir, explica’ns què tens i et direm per on començaríem.
