--- name: agentdataapi.onrender.com description: agentdataapi.onrender.com provides two categories of data: SpaceX launch schedules (upcoming launches, today's launches, and Starship-specific next launch) and Internet Archive page-level metadata including IIIF image URLs for scanned books. All endpoints are read-only and return structured JSON. host: agentdataapi.onrender.com --- # agentdataapi.onrender.com This host serves agents that need structured SpaceX launch data or Internet Archive digitized-book metadata. The SpaceX skills cover three time horizons: the next 24 hours, the next 5 upcoming launches, and the next Starship-specific launch. The Archive skill retrieves bibliographic and image data for a single scanned page of a specified work. There is no thematic connection between the two data domains; they are co-hosted on the same service. ## When to use this host Use this host when an agent needs SpaceX launch schedule data (upcoming missions, today's launches, or Starship-specific timing) or needs to retrieve a IIIF image URL and bibliographic metadata for a specific leaf of an Internet Archive digitized book. Do not use it for historical SpaceX or Starship launch records — use a dedicated space history API such as the SpaceX-API or Launch Library 2 instead. Do not use it for real-time telemetry or live video feeds during a launch. Do not use it for full-text search or bulk page retrieval from Internet Archive; the Archive skill returns data for exactly one leaf per call. For non-SpaceX launch providers (ULA, Rocket Lab, etc.) use a broader launch aggregator like Launch Library 2. ## Capabilities ### Internet Archive Page Retrieval Fetches IIIF image URLs and bibliographic metadata (title, author, year, leaf count, license, attribution) for a single scanned page of a digitized book on Internet Archive. - **`fetch-archive-page-metadata`** — Returns IIIF image URLs and metadata (title, author, year, leaf count, license, attribution, source) for a single scanned page of an Internet Archive work. ### SpaceX Launch Schedules Provides structured SpaceX launch data across three scopes: launches in the next 24 hours, the next 5 upcoming launches, and the next Starship-specific launch with a live countdown. - **`fetch-todays-space-launches`** — Returns SpaceX launches scheduled within the next 24 hours, including launch window times, rocket, mission description, orbit, pad, location, and go/no-go status. - **`fetch-spacex-upcoming-launches`** — Returns the next 5 upcoming SpaceX launches with mission details, launch windows, rocket type, orbit, and pad location, plus a total upcoming count. - **`fetch-starship-next-launch`** — Returns the next scheduled Starship launch with mission details, status, launch window, vehicle, pad, location, and a live countdown in seconds. ## Workflows ### SpaceX Launch Situation Report *Use when an agent needs to know both what is launching today and what is coming up soon, to give a complete near-term SpaceX launch picture.* 1. **`fetch-todays-space-launches`** — Retrieve any SpaceX launches scheduled within the next 24 hours, including go/no-go status and window times. 2. **`fetch-spacex-upcoming-launches`** — Retrieve the next 5 upcoming SpaceX launches to provide context beyond today's window. 3. **`fetch-starship-next-launch`** — Check whether the next Starship launch falls within or near the same window and obtain its live countdown. ## Skill reference ### `fetch-archive-page-metadata` **Archive Page Metadata** — Returns IIIF image URLs and metadata (title, author, year, leaf count, license, attribution, source) for a single scanned page of an Internet Archive work. *Use when:* Use when an agent needs page-level image links or bibliographic metadata for a specific leaf of a digitized book hosted on Internet Archive, such as displaying or processing a scanned page. *Not for:* Do not use for full-text search or bulk retrieval of all pages in a work; this endpoint returns data for one leaf at a time only. **Inputs:** - `work` (string) — Internet Archive work identifier. Defaults to 'ramelli-machine-1588' if omitted. - `leaf` (integer) — Zero-based leaf (page) number within the work. Defaults to 42 if omitted. **Returns:** Returns a JSON object with work_id, title, author, year, leaf index, total_leaves, three IIIF image URLs (small/medium/full), a fallback image URL, license, attribution, and source link. **Example:** `GET https://agentdataapi.onrender.com/archive/page?work=ramelli-machine-1588&leaf=42` --- ### `fetch-spacex-upcoming-launches` **SpaceX Upcoming Launches** — Returns the next 5 upcoming SpaceX launches with mission details, launch windows, rocket type, orbit, and pad location, plus a total upcoming count. *Use when:* Use when an agent needs structured data about imminent SpaceX launches, including NET (no-earlier-than) times, launch windows, mission descriptions, orbit targets, and launch site details. *Not for:* Do not use for historical launch records, non-SpaceX launches, or real-time telemetry during a launch; use a dedicated space history or telemetry API instead. **Returns:** Returns count_upcoming_total (e.g. 128), a stale flag, and an array of 5 upcoming SpaceX launches each with name, status, NET time, window start/end, rocket, mission description, orbit, pad, and location. **Example:** `GET https://agentdataapi.onrender.com/launches` --- ### `fetch-todays-space-launches` **Today's Space Launches** — Returns SpaceX launches scheduled within the next 24 hours, including launch window times, rocket, mission description, orbit, pad, location, and go/no-go status. *Use when:* Use when an agent needs to know what SpaceX launches are happening today, including their scheduled windows, vehicle details, mission info, and current launch status. *Not for:* Do not use for historical launch data or launches beyond the next 24 hours; use a broader launch schedule API instead. Not suitable for non-SpaceX launch providers. **Returns:** Returns a window_hours value of 24, a stale flag, and a launches array where each entry contains the rocket name, mission, status, net/window times, orbit, pad, and location. **Example:** `GET https://agentdataapi.onrender.com/launches/today` --- ### `fetch-starship-next-launch` **Starship Next Launch** — Returns the next scheduled Starship launch with mission details, status, launch window, vehicle, pad, location, and a live countdown in seconds. *Use when:* Use when an agent needs the current next Starship launch schedule, including mission name, go/no-go status, NET time, launch window, rocket variant, pad, and seconds until launch. *Not for:* Do not use for historical Starship launch records or non-Starship SpaceX launches; use a broader launch history API instead. **Returns:** Returns a launch object with mission name, status, NET/window times, rocket variant, pad, location, last_updated, plus seconds_until_launch integer and a stale boolean flag. **Example:** `GET https://agentdataapi.onrender.com/starship/next` ---