Aristocles Pty Ltd Exoplanets API

openapi: 3.2.0
info:
  title: Aristocles Data Exoplanets API
  description: 'Four Australian data APIs on one key — subscriptions, trade pricing, PBS drugs, and rental prices.


    ---


    ## Quick start


    **1. Get your API key** — register in one request:

    ```

    POST /v1/auth/register

    {"email": "you@example.com", "name": "Your Name"}

    ```

    Copy the `api_key` from the response.


    **2. Authenticate** — add your key to every request as a header:

    ```

    X-API-Key: ar_live_xxxxxxxxxxxx

    ```


    **3. Run the discovery endpoint** — returns all available slugs, example calls, and your account limits:

    ```

    GET /v1/discovery

    ```


    **4. Make your first call:**

    ```

    GET /v1/prices/netflix?country=AU

    GET /v1/trades/electrician/prices?state=NSW&country=AU

    GET /v1/pbs/metformin

    GET /v1/rental/VIC/Richmond

    ```


    ---


    ## Four data domains


    | Domain | Base path | What it covers |

    |---|---|---|

    | **Subscription Pricing** | `/v1/prices`, `/v1/services` | 50+ SaaS & streaming services: Netflix, Spotify, Adobe, etc. |

    | **Contractor Trades** | `/v1/trades` | Plumbers, electricians, painters across AU, US, UK, CA, NZ |

    | **PBS Drug Pricing** | `/v1/pbs` | 14,000+ medications on Australia''s Pharmaceutical Benefits Scheme |

    | **Rental Market** | `/v1/rental` | Median weekly rent by suburb and postcode across Australia |

    | **RBA Economic Data** | `/v1/rba` | Cash rate, AUD FX rates, CPI inflation, mortgage rates, credit aggregates |


    ---


    ## MCP Server


    All four data domains are also available as MCP tools at:

    ```

    https://api.aristocles.com.au/mcp/

    ```

    Connect any MCP-compatible AI agent (Claude, GPT, Gemini) to get structured data without writing API calls.'
  version: 2.1.0
tags:
- name: Exoplanets
  description: 'A catalogue of all confirmed exoplanets with their host star, discovery year and method, orbital period, radius, mass, temperature and distance from Earth. Education platforms, science apps, researchers and AI tutors use it to explore and explain planetary discoveries. Source: This research has made use of the NASA Exoplanet Archive, which is operated by the California Institute of Technology, under contract with NASA.. Licence: Public domain (NASA data, free to use). Base path: /v1/data/confirmed-exoplanets-catalogue. Requires an API key (X-API-Key).'
paths:
  /v1/data/confirmed-exoplanets-catalogue:
    get:
      tags:
      - Exoplanets
      summary: List Confirmed Exoplanets Catalogue records
      description: 'List Confirmed Exoplanets Catalogue records with optional filters and pagination.


        **Source:** This research has made use of the NASA Exoplanet Archive, which is operated by the California Institute of Technology, under contract with NASA. (Public domain (NASA data, free to use)).


        **Fields returned:**

        - `planet_name` (str) — Planet name

        - `host_star` (str) — Host star name

        - `discovery_year` (int) — Year of discovery

        - `discovery_method` (str) — Detection method, e.g. Transit

        - `discovery_facility` (str) — Observatory or mission that made the discovery

        - `orbital_period_days` (float) — Orbital period in days

        - `radius_earth` (float) — Planet radius in Earth radii

        - `mass_earth` (float) — Planet mass in Earth masses

        - `equilibrium_temp_k` (float) — Equilibrium temperature in Kelvin

        - `distance_parsecs` (float) — Distance from Earth in parsecs


        **Example:** `GET /v1/data/confirmed-exoplanets-catalogue?limit=10&discovery_year=42`'
      operationId: list_endpoint_v1_data_confirmed_exoplanets_catalogue_get
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 1
          description: Max records to return (1-100).
          default: 25
          title: Limit
        description: Max records to return (1-100).
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
          description: Records to skip, for pagination.
          default: 0
          title: Offset
        description: Records to skip, for pagination.
      - name: discovery_year
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Year of discovery
          examples:
          - '42'
          title: Discovery Year
        description: Year of discovery
      - name: discovery_method
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Detection method, e.g. Transit
          examples:
          - example
          title: Discovery Method
        description: Detection method, e.g. Transit
      - name: discovery_facility
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Observatory or mission that made the discovery
          examples:
          - example
          title: Discovery Facility
        description: Observatory or mission that made the discovery
      - name: host_star
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Host star name
          examples:
          - example
          title: Host Star
        description: Host star name
      - name: X-API-Key
        in: header
        required: true
        schema:
          type: string
          title: X-Api-Key
      responses:
        '200':
          description: A page of Confirmed Exoplanets Catalogue records with pagination metadata.
          content:
            application/json:
              schema: {}
              example:
                data:
                  items:
                  - planet_name: example
                    host_star: example
                    discovery_year: 42
                    discovery_method: example
                    discovery_facility: example
                    orbital_period_days: 4.2
                    radius_earth: 4.2
                    mass_earth: 4.2
                    equilibrium_temp_k: 4.2
                    distance_parsecs: 4.2
                  total: 1
                  limit: 25
                  offset: 0
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/data/confirmed-exoplanets-catalogue/search:
    get:
      tags:
      - Exoplanets
      summary: Search Confirmed Exoplanets Catalogue by planet_name
      description: 'Search Confirmed Exoplanets Catalogue records by `planet_name` (partial, case-insensitive).


        **Example:** `GET /v1/data/confirmed-exoplanets-catalogue/search?q=exa`'
      operationId: search_endpoint_v1_data_confirmed_exoplanets_catalogue_search_get
      parameters:
      - name: q
        in: query
        required: true
        schema:
          type: string
          minLength: 2
          maxLength: 100
          description: Case-insensitive partial match on planet_name.
          examples:
          - exa
          title: Q
        description: Case-insensitive partial match on planet_name.
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 1
          description: Max records to return (1-100).
          default: 25
          title: Limit
        description: Max records to return (1-100).
      - name: X-API-Key
        in: header
        required: true
        schema:
          type: string
          title: X-Api-Key
      responses:
        '200':
          description: Matching Confirmed Exoplanets Catalogue records.
          content:
            application/json:
              schema: {}
              example:
                data:
                  items:
                  - planet_name: example
                    host_star: example
                    discovery_year: 42
                    discovery_method: example
                    discovery_facility: example
                    orbital_period_days: 4.2
                    radius_earth: 4.2
                    mass_earth: 4.2
                    equilibrium_temp_k: 4.2
                    distance_parsecs: 4.2
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/data/confirmed-exoplanets-catalogue/{key}:
    get:
      tags:
      - Exoplanets
      summary: Get one Confirmed Exoplanets Catalogue record by planet_name
      description: 'Fetch a single Confirmed Exoplanets Catalogue record by its `planet_name`.


        **Example:** `GET /v1/data/confirmed-exoplanets-catalogue/example`'
      operationId: get_endpoint_v1_data_confirmed_exoplanets_catalogue__key__get
      parameters:
      - name: key
        in: path
        required: true
        schema:
          type: string
          description: The planet_name value to look up (case-insensitive).
          examples:
          - example
          title: Key
        description: The planet_name value to look up (case-insensitive).
      - name: X-API-Key
        in: header
        required: true
        schema:
          type: string
          title: X-Api-Key
      responses:
        '200':
          description: A single Confirmed Exoplanets Catalogue record.
          content:
            application/json:
              schema: {}
              example:
                data:
                  planet_name: example
                  host_star: example
                  discovery_year: 42
                  discovery_method: example
                  discovery_facility: example
                  orbital_period_days: 4.2
                  radius_earth: 4.2
                  mass_earth: 4.2
                  equilibrium_temp_k: 4.2
                  distance_parsecs: 4.2
        '404':
          content:
            application/json:
              example:
                error:
                  code: NOT_FOUND
                  message: No Confirmed Exoplanets Catalogue record for '...'.
          description: Not Found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError