Aristocles Pty Ltd Energy & Climate API

openapi: 3.2.0
info:
  title: Aristocles Data Energy & Climate 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: Energy & Climate
  description: 'An open-source dataset from the World Resources Institute listing over 35,000 power plants. It is essential for energy market analysts, renewable energy startups, and logistics companies optimizing for energy resources and carbon footprint. Source: World Resources Institute. 2021. Global Power Plant Database. Published on Resource Watch; http://resourcewatch.org/. Licence: CC BY 4.0. Base path: /v1/data/global-power-plant-database. Requires an API key (X-API-Key).'
paths:
  /v1/data/global-power-plant-database:
    get:
      tags:
      - Energy & Climate
      summary: List Global Power Plant Database records
      description: 'List Global Power Plant Database records with optional filters and pagination.


        **Source:** World Resources Institute. 2021. Global Power Plant Database. Published on Resource Watch; http://resourcewatch.org/ (CC BY 4.0).


        **Fields returned:**

        - `country_code` (str) — Three-letter ISO country code

        - `name` (str) — Name of the power plant

        - `gppd_id` (str) — Global Power Plant Database ID

        - `capacity_mw` (float) — Electrical generating capacity in megawatts

        - `latitude` (float) — Latitude of the plant

        - `longitude` (float) — Longitude of the plant

        - `primary_fuel` (str) — Primary fuel type (e.g., Solar, Wind, Gas)

        - `commissioning_year` (int) — Year the plant was commissioned

        - `owner` (str) — Owner of the power plant


        **Example:** `GET /v1/data/global-power-plant-database?limit=10&country_code=example`'
      operationId: list_endpoint_v1_data_global_power_plant_database_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: country_code
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Three-letter ISO country code
          examples:
          - example
          title: Country Code
        description: Three-letter ISO country code
      - name: primary_fuel
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Primary fuel type (e.g., Solar, Wind, Gas)
          examples:
          - example
          title: Primary Fuel
        description: Primary fuel type (e.g., Solar, Wind, Gas)
      - name: X-API-Key
        in: header
        required: true
        schema:
          type: string
          title: X-Api-Key
      responses:
        '200':
          description: A page of Global Power Plant Database records with pagination metadata.
          content:
            application/json:
              schema: {}
              example:
                data:
                  items:
                  - country_code: example
                    name: example
                    gppd_id: example
                    capacity_mw: 4.2
                    latitude: 4.2
                    longitude: 4.2
                    primary_fuel: example
                    commissioning_year: 42
                    owner: example
                  total: 1
                  limit: 25
                  offset: 0
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/data/global-power-plant-database/search:
    get:
      tags:
      - Energy & Climate
      summary: Search Global Power Plant Database by name
      description: 'Search Global Power Plant Database records by `name` (partial, case-insensitive).


        **Example:** `GET /v1/data/global-power-plant-database/search?q=exa`'
      operationId: search_endpoint_v1_data_global_power_plant_database_search_get
      parameters:
      - name: q
        in: query
        required: true
        schema:
          type: string
          minLength: 2
          maxLength: 100
          description: Case-insensitive partial match on name.
          examples:
          - exa
          title: Q
        description: Case-insensitive partial match on 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 Global Power Plant Database records.
          content:
            application/json:
              schema: {}
              example:
                data:
                  items:
                  - country_code: example
                    name: example
                    gppd_id: example
                    capacity_mw: 4.2
                    latitude: 4.2
                    longitude: 4.2
                    primary_fuel: example
                    commissioning_year: 42
                    owner: example
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/data/global-power-plant-database/{key}:
    get:
      tags:
      - Energy & Climate
      summary: Get one Global Power Plant Database record by gppd_id
      description: 'Fetch a single Global Power Plant Database record by its `gppd_id`.


        **Example:** `GET /v1/data/global-power-plant-database/example`'
      operationId: get_endpoint_v1_data_global_power_plant_database__key__get
      parameters:
      - name: key
        in: path
        required: true
        schema:
          type: string
          description: The gppd_id value to look up (case-insensitive).
          examples:
          - example
          title: Key
        description: The gppd_id 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 Global Power Plant Database record.
          content:
            application/json:
              schema: {}
              example:
                data:
                  country_code: example
                  name: example
                  gppd_id: example
                  capacity_mw: 4.2
                  latitude: 4.2
                  longitude: 4.2
                  primary_fuel: example
                  commissioning_year: 42
                  owner: example
        '404':
          content:
            application/json:
              example:
                error:
                  code: NOT_FOUND
                  message: No Global Power Plant Database 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