cosmik

Live schedule of upcoming orbital rocket launches (SpaceX, NASA, Rocket Lab, ULA, Arianespace, China…) with liftoff times (UTC), pads, status and a live-tracking link. Optionally filter by provider/rocket name.

{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "description": "Case-insensitive filter matched against provider and rocket name, e.g. 'SpaceX', 'NASA', 'Rocket Lab'"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "default": 5,
      "description": "Maximum number of launches to return (1-20, default 5)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "launches": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Rocket and mission name"
          },
          "liftoff_utc": {
            "type": "string",
            "description": "Scheduled liftoff time, ISO 8601 UTC"
          },
          "status": {
            "type": "string",
            "description": "Launch status, e.g. 'Go for Launch', 'To Be Confirmed'"
          },
          "provider": {
            "type": "string",
            "description": "Launch service provider"
          },
          "pad": {
            "type": "string",
            "description": "Launch pad and location"
          },
          "watch_live": {
            "type": "string",
            "description": "Cosmik URL tracking this launch live in 3D"
          }
        },
        "required": [
          "name",
          "liftoff_utc",
          "status",
          "provider",
          "pad",
          "watch_live"
        ],
        "additionalProperties": false
      },
      "description": "Upcoming launches, soonest first"
    }
  },
  "required": [
    "launches"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

When the International Space Station will pass over a location in the next 3 days: start time (UTC), maximum elevation, duration, and whether the pass is in a good viewing window (evening/pre-dawn). Provide a city name OR latitude+longitude.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "City name, e.g. 'Paris', 'New York' — 550+ major cities known; takes precedence over lat/lon"
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude in decimal degrees (-90 to 90), used with lon when no city is given"
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude in decimal degrees (-180 to 180), used with lat when no city is given"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "location": {
      "type": "string",
      "description": "Resolved location label, or 'unknown' when the input couldn't be resolved"
    },
    "passes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "start_utc": {
            "type": "string",
            "description": "Pass start time, ISO 8601 UTC"
          },
          "max_elevation_deg": {
            "type": "number",
            "description": "Maximum elevation above the horizon in degrees"
          },
          "duration_min": {
            "type": "number",
            "description": "Approximate pass duration in minutes"
          },
          "good_viewing": {
            "type": "boolean",
            "description": "True when the pass is genuinely visible to the naked eye: the observer's sky is dark (Sun ≤ −6°, civil twilight) while the ISS is still outside Earth's shadow and lit by the Sun"
          },
          "visible_start_utc": {
            "type": [
              "string",
              "null"
            ],
            "description": "Start of the actually-visible part of the pass, ISO 8601 UTC; null when the pass is not visible. Usually LATER than start_utc"
          },
          "visible_end_utc": {
            "type": [
              "string",
              "null"
            ],
            "description": "End of the actually-visible part of the pass, ISO 8601 UTC; null when the pass is not visible. Usually EARLIER than start_utc + duration_min, because the satellite enters Earth's shadow mid-pass. Quote this window, not the full pass, when telling someone when to look up"
          }
        },
        "required": [
          "start_utc",
          "max_elevation_deg",
          "duration_min",
          "good_viewing",
          "visible_start_utc",
          "visible_end_utc"
        ],
        "additionalProperties": false
      },
      "description": "Upcoming ISS passes above 10° elevation, soonest first (empty when none in the next 3 days)"
    }
  },
  "required": [
    "location",
    "passes"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Latest rocket-launch news articles (previews and post-launch recaps) from Cosmik, optionally filtered by a search term (mission, rocket, or provider name).

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search term matched against article titles, e.g. 'Starship', 'Crew', 'Ariane'"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "default": 5,
      "description": "Maximum number of articles to return (1-10, default 5)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "articles": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "preview",
              "recap"
            ],
            "description": "'preview' before liftoff, 'recap' after"
          },
          "title": {
            "type": "string",
            "description": "Article headline"
          },
          "description": {
            "type": "string",
            "description": "One-paragraph summary"
          },
          "url": {
            "type": "string",
            "description": "Canonical article URL on gocosmik.com"
          }
        },
        "required": [
          "kind",
          "title",
          "description",
          "url"
        ],
        "additionalProperties": false
      },
      "description": "Launch articles, most recent launch first"
    }
  },
  "required": [
    "articles"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}