Contenido e Interpretaciones

Acceded a la biblioteca completa de interpretaciones astrológicas.

Descripción General

La API de Contenido proporciona acceso a textos de interpretación para:

• Posiciones de planetas en signos
• Posiciones de planetas en casas
• Aspectos entre planetas
• Interpretaciones de tránsitos
• Interpretaciones de sinastría

Listado de Contenido

Listado de contenido por tipo de horóscopo y tipo de contenido:

curl -X GET "https://api.astroapi.cloud/api/content/natal/planet-in-sign?page[size]=20" \
  -H "X-Api-Key: your-api-key"

Tipos de Contenido

Tipo	Descripción
planet-in-sign	Posición del planeta en el signo zodiacal
planet-in-house	Posición del planeta en la casa
aspect	Aspecto entre dos planetas
transit	Interpretación de tránsito
synastry	Interpretación de aspecto de sinastría

Tipos de Horóscopo

Tipo	Descripción
natal	Interpretaciones de carta natal
transit	Interpretaciones de tránsitos
synastry	Interpretaciones de sinastría
composite	Interpretaciones de carta compuesta
chinese-horoscope	Interpretaciones de horóscopo chino
chinese-forecast	Interpretaciones de pronóstico anual chino
numerology	Interpretaciones de numerología
moon-sun	Interpretaciones de Luna y Sol
moon-calendar	Interpretaciones de calendario lunar
retrograde	Interpretaciones de períodos retrógrados
progression	Interpretaciones de progresiones secundarias
horoscope	Interpretaciones generales de horóscopo

Obtener por ID

curl -X GET "https://api.astroapi.cloud/api/content/natal/planet-in-sign/abc123" \
  -H "X-Api-Key: your-api-key"

Respuesta

{
  "data": {
    "type": "content",
    "id": "abc123",
    "attributes": {
      "title": "Sun in Gemini",
      "body": "With your Sun in Gemini, you possess a quick, curious mind...",
      "urn": "urn:content:1:natal:planet-in-sign:sun:gemini:en"
    }
  }
}

Formato Markdown

El campo body en las respuestas de contenido está formateado en Markdown. Esto permite texto enriquecido con encabezados, negrita/cursiva, listas y más.

Si queréis mostrar el contenido como HTML en vuestra aplicación, necesitaréis convertir el Markdown a HTML utilizando una librería de parseo de Markdown.

JavaScript/TypeScript

import { marked } from "marked";

const html = marked.parse(content.body);

O con markdown-it:

import MarkdownIt from "markdown-it";

const md = new MarkdownIt();
const html = md.render(content.body);

Python

import markdown

html = markdown.markdown(content["body"])

PHP

use League\CommonMark\CommonMarkConverter;

$converter = new CommonMarkConverter();
$html = $converter->convert($content['body']);

Filtrar por Título

Buscad contenido por título usando el parámetro de consulta filter:

curl -X GET "https://api.astroapi.cloud/api/content/natal/planet-in-sign?filter=title:*sun*" \
  -H "X-Api-Key: your-api-key"

Incluir Interpretaciones con los Cálculos

La forma recomendada de obtener textos de interpretación es incluirlos directamente en vuestras solicitudes de cálculo utilizando el parámetro includeText:

curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "1990-06-15T14:30",
    "location": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "includeText": true,
    "language": "en"
  }'

Esto enriquece vuestra respuesta de cálculo con textos de interpretación para cada posición y aspecto.

Paginación

Usad los parámetros de paginación de JSON:API:

curl -X GET "https://api.astroapi.cloud/api/content/natal/planet-in-sign?page[size]=10&page[number]=0" \
  -H "X-Api-Key: your-api-key"

La respuesta incluye una URL links.next para la siguiente página de resultados.