post_astrology_planetary_returns

Parameters schema

{
  "type": "object",
  "required": [
    "birthDate",
    "birthTime",
    "planet",
    "approximateDate",
    "latitude",
    "longitude",
    "timezone"
  ],
  "properties": {
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English."
    },
    "planet": {
      "enum": [
        "Mercury",
        "Venus",
        "Mars",
        "Jupiter",
        "Saturn"
      ],
      "type": "string",
      "example": "Jupiter",
      "description": "Planet for the return calculation. Supports Mercury (~88 days), Venus (~225 days), Mars (~687 days), Jupiter (~12 years), and Saturn (~29 years). Saturn return is a major life milestone in Western astrology."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true to receive the exact same data in a token-optimized shape that is cheaper for you to read: whitespace is stripped and every array of same-shaped objects is encoded columnar as {\"__cols\":[field names],\"__rows\":[[values]]}, so each field name is sent once instead of once per row. Fully lossless (no field or value is dropped or changed) and typically 40 to 52 percent fewer tokens on large results. Prefer true whenever token or inference cost matters. Default false returns standard indented JSON."
    },
    "latitude": {
      "type": "number",
      "example": 40.7128,
      "maximum": 90,
      "minimum": -90,
      "description": "Latitude of the return location in decimal degrees (-90 to 90). Affects house cusps and Ascendant of the return chart."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 14,
          "minimum": -14
        },
        {
          "type": "string"
        }
      ],
      "example": -5,
      "description": "Decimal hours from UTC OR IANA name (e.g. \"America/New_York\"). IANA resolved to the DST-correct offset for the birthDate. Output datetime is adjusted to this timezone."
    },
    "birthDate": {
      "type": "string",
      "format": "date",
      "example": "1990-07-15",
      "description": "Original birth date in YYYY-MM-DD format. Used to determine the natal longitude of the selected planet."
    },
    "birthTime": {
      "type": "string",
      "format": "time",
      "example": "14:30:00",
      "description": "Original birth time in 24-hour HH:MM:SS format. Determines exact natal planet position for return timing."
    },
    "longitude": {
      "type": "number",
      "example": -74.006,
      "maximum": 180,
      "minimum": -180,
      "description": "Longitude of the return location in decimal degrees (-180 to 180)."
    },
    "houseSystem": {
      "enum": [
        "placidus",
        "whole-sign",
        "equal",
        "koch"
      ],
      "type": "string",
      "default": "placidus",
      "example": "placidus",
      "description": "House system for the return chart. Placidus (default), Whole Sign, Equal, or Koch."
    },
    "approximateDate": {
      "type": "string",
      "format": "date",
      "example": "2026-08-15",
      "description": "Approximate date near the expected planetary return (YYYY-MM-DD). Provide a date within the expected return window. The algorithm searches from this starting point."
    }
  }
}

• Data resourceNASA Open API

  NASA · scientific-data

  name mention0.55

Parent server