Content & Interpretations

Access the comprehensive library of astrological interpretations.

Overview

The Content API provides access to interpretation texts for:

• Planet in sign placements
• Planet in house placements
• Aspects between planets
• Transit interpretations
• Synastry interpretations

Fetching Interpretations

curl -X GET "https://api.astroapi.cloud/api/content/interpretations?filter[type]=planet-in-sign&filter[planet]=sun&filter[sign]=gemini" \
  -H "X-Api-Key: your-api-key"

Content Types

Type	Description
planet-in-sign	Planet placement in zodiac sign
planet-in-house	Planet placement in house
aspect	Aspect between two planets
transit	Transit interpretation
synastry	Synastry aspect interpretation

URN Format

Content is identified using URN (Uniform Resource Name) format:

urn:astro:interpretation:planet-in-sign:sun:gemini
urn:astro:interpretation:aspect:sun:moon:conjunction

Fetching by URN

curl -X GET "https://api.astroapi.cloud/api/content/urn/astro:interpretation:planet-in-sign:sun:gemini" \
  -H "X-Api-Key: your-api-key"

Response

{
  "data": {
    "type": "interpretation",
    "id": "urn:astro:interpretation:planet-in-sign:sun:gemini",
    "attributes": {
      "title": "Sun in Gemini",
      "content": "With your Sun in Gemini, you possess a quick, curious mind...",
      "keywords": ["communication", "versatility", "curiosity"],
      "category": "planet-in-sign"
    }
  }
}

Batch Fetch

Fetch multiple interpretations at once:

curl -X POST "https://api.astroapi.cloud/api/content/batch" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "urns": [
      "urn:astro:interpretation:planet-in-sign:sun:gemini",
      "urn:astro:interpretation:planet-in-sign:moon:sagittarius",
      "urn:astro:interpretation:aspect:sun:moon:opposition"
    ]
  }'

Searching Content

curl -X GET "https://api.astroapi.cloud/api/content/search?q=communication+mercury" \
  -H "X-Api-Key: your-api-key"