api-ninjas-com Helicopter API

openapi: 3.2.0
info:
  title: Ninjas Helicopter API
  description: 'Combined OpenAPI specification for every API Ninjas endpoint. Requests go to https://api.api-ninjas.com with an `X-Api-Key` header; get a free key at https://api-ninjas.com/register. Human-readable docs: https://api-ninjas.com/api. Index for LLMs: https://api-ninjas.com/llms.txt.'
  version: 1.0.0
  contact:
    name: API Ninjas
    url: https://api-ninjas.com
  license:
    name: Proprietary
servers:
- url: https://api.api-ninjas.com
  description: API Ninjas Production
security:
- ApiKeyAuth: []
tags:
- name: Helicopter
  description: The Helicopter API provides detailed technical specs on hundreds of helicopter models.
paths:
  /v1/helicopter:
    get:
      summary: Get helicopter data
      description: Returns technical specifications for helicopter models, filtered by manufacturer, model, or ranges of air speed, range, length, and height.
      operationId: getHelicopterData
      tags:
      - Helicopter
      parameters:
      - name: manufacturer
        in: query
        description: Company that designed and built the helicopter.
        required: false
        schema:
          type: string
      - name: model
        in: query
        description: Helicopter model name.
        required: false
        schema:
          type: string
      - name: min_speed
        in: query
        description: Minimum max. air speed in knots.
        required: false
        schema:
          type: integer
      - name: max_speed
        in: query
        description: Maximum max. air speed in knots.
        required: false
        schema:
          type: integer
      - name: min_range
        in: query
        description: Minimum range of the helicopter in nautical miles.
        required: false
        schema:
          type: integer
      - name: max_range
        in: query
        description: Maximum range of the helicopter in nautical miles.
        required: false
        schema:
          type: integer
      - name: min_length
        in: query
        description: Minimum length of the helicopter in feet.
        required: false
        schema:
          type: number
      - name: max_length
        in: query
        description: Maximum length of the helicopter in feet.
        required: false
        schema:
          type: number
      - name: min_height
        in: query
        description: Minimum height of the helicopter in feet.
        required: false
        schema:
          type: number
      - name: max_height
        in: query
        description: Maximum height of the helicopter in feet.
        required: false
        schema:
          type: number
      - name: limit
        in: query
        description: How many results to return. Must be between 1 and 30. Default is 1.
        required: false
        schema:
          type: integer
          default: 1
          minimum: 1
          maximum: 30
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Helicopter'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HelicopterOpenapi_Error'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HelicopterOpenapi_Error'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HelicopterOpenapi_Error'
      security:
      - ApiKeyAuth: []
components:
  schemas:
    HelicopterOpenapi_Error:
      type: object
      properties:
        error:
          type: string
          description: Error message.
    Helicopter:
      type: object
      properties:
        image_url:
          type:
          - string
          - 'null'
          format: uri
          description: Direct media.api-ninjas.com URL to an AI-generated helicopter image. Business tier and above only; null when no approved image is available. An exact variant query selects its image for grouped models; otherwise the first listed variant is used.
        manufacturer:
          type: string
          description: Company that designed and built the helicopter.
        model:
          type: string
          description: Helicopter model name.
        max_speed_sl_knots:
          type: string
          description: Maximum max. air speed in knots.
        cruise_speed_sl_knots:
          type: string
          description: Cruise speed at sea level in knots.
        range_nautical_miles:
          type: string
          description: Range of the helicopter in nautical miles.
        cruise_time_min:
          type: string
          description: Cruise time in minutes.
        fuel_capacity_gallons:
          type: string
          description: Fuel capacity in gallons.
        gross_external_load_lbs:
          type: string
          description: Gross external load in pounds.
        external_load_limit_lbs:
          type: string
          description: External load limit in pounds.
        main_rotor_diameter_ft:
          type: string
          description: Main rotor diameter in feet.
        num_blades:
          type: string
          description: Number of blades.
        blade_material:
          type: string
          description: Blade material.
        rotor_type:
          type: string
          description: Rotor type.
        storage_width_ft:
          type: string
          description: Storage width in feet.
        length_ft:
          type: string
          description: Length of the helicopter in feet.
        height_ft:
          type: string
          description: Height of the helicopter in feet.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key
externalDocs:
  description: API Ninjas documentation
  url: https://api-ninjas.com/api