Documentación API

Bienvenido a la documentación de la API

Explora nuestra API astrológica completa, con soporte para sistemas occidentales, védicos y chinos. Cada endpoint incluye ejemplos de código en Python, PHP y Node.js.

Empezar con la autenticación

¿Prefieres un flujo guiado en Postman? Haz fork de la colección pública Start Here y empieza con un conjunto de solicitudes listo para producción.

Inicio rápido

Construye tu primera solicitud en 30 s

Base URL: https://api.freeastroapi.com

Obtener una clave API

curl

curl -X POST 'https://api.freeastroapi.com/api/v1/natal/calculate' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_KEY' \
  -d '{"year":1990,"month":5,"day":15,"hour":14,"minute":30,"city":"New York"}'

Encabezados: x-api-key requiredSeguro vía HTTPSEstado

Base URL

https://api.freeastroapi.com

Todos los endpoints

Primeros pasos

Claves API y seguridad

Límites de velocidad

Comportamiento 429, Retry-After y estrategia de reintentos

Astrología occidental

Posiciones planetarias tropicales

Posiciones planetarias en un rango de fechas

Astrocartografía

Líneas, parans, rankings de reubicación y cartas reubicadas

Sol, Luna, ASC y MC especializados

Instantánea de tránsitos para una fecha contra una carta natal

Timeline de tránsitos

Intervalos mensuales de tránsitos para calendarios e interfaces Gantt

Direcciones primarias

Direcciones Regiomontanus in-mundo con doctrina de latitud y movimiento secundario lunar

Direcciones simbólicas

Timing zodiacal simple: 1 año equivale a 1 grado

Revolución solar

Carta anual de cumpleaños y temas

Retorno planetario

Retornos del Sol, la Luna y otros planetas

Aspectos relacionales brutos, superposiciones y puntuaciones

Sinastría (móvil)

Compatibilidad relacional

Informes psicológicos

Flujo asíncrono de informes premium completos

Horóscopo diario por signo zodiacal

Predicción personal diaria

Predicción diaria personalizada

Predicción personal semanal

Predicción personalizada de siete días

Horóscopo de sinastría

Predicciones diarias románticas o de amistad basadas en sinastría

Gráficos visuales occidentales (SVG)

Visualizaciones personalizables de carta natal

Gráfico SVG de tránsitos

Render SVG de tránsitos en doble rueda

Gráfico SVG de sinastría

Render SVG relacional en doble rueda

Gráfico SVG compuesto

Render compuesto de una rueda por midpoint

Astrología védica

Posiciones sidéreas V2

Cartas Kundli SVG y PNG con ejemplos visuales

Cálculo completo

Endpoint todo en uno V2

Vimshottari Dasha

Periodos planetarios V2

Datos de interpretación V1

Gochar Timeline

Ventanas de tránsito V2

Gochar Timeline Insights

Datos de interpretación de tránsitos V2

Detección de yogas

Catálogo de yogas V2

Fuerza planetaria

Shadbala y Ashtakavarga V2

Cartas divisionales

D1, D9, D10, D60, etc. V2

Almanaque diario V2

Matching por nacimiento

Compatibilidad V2 a partir de datos de nacimiento

Entrada manual de la Luna V2

Astrología china

BaZi (4 pilares)

Carta natal completa

Timing anual y mensual

Mapeos de ID

Pilares actuales

Energía del día

Utilidades (gratis)

Búsqueda de ciudad

Autocompletado autenticado de ciudades y localidades

Conectar FreeAstroAPI directamente a herramientas de IA

Archivos para agentes IA

llms.txt, sitemap, robots y guía de descubrimiento IA

Datos de fase y visuales SVG

Moon Phase Timeline

Calendario lunar mensual y entradas en signos

Notificaciones de eventos astro

Flujo de eventos celestes para notificaciones push móviles

Sistema de zonas horarias

Motor de zonas horarias y LMT histórico

Guía AstroFont

Usar StarFont Sans y Serif en cualquier aplicación front-end

Plantillas de aplicaciones listas para desplegar

Inicio rápido

1. Obtener una clave API 2. Probar la carta natal