api-ninjas-com Motorcycles API

openapi: 3.2.0
info:
  title: Ninjas Motorcycles 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: Motorcycles
  description: The Motorcycles API provides highly-detailed technical data on over 20,000 motorcycle models from over 600 makes.
paths:
  /v1/motorcycles:
    get:
      summary: Search motorcycles by make, model, and year
      description: Returns technical specifications for motorcycle models matching a make, model and/or year, with partial matching on make and model and `offset` paging.
      operationId: searchMotorcycles
      parameters:
      - name: make
        in: query
        description: Name of manufacturer/brand. Supports partial matching.
        required: false
        schema:
          type: string
      - name: model
        in: query
        description: Name of motorcycle model. Supports partial matching.
        required: false
        schema:
          type: string
      - name: year
        in: query
        description: Release year of motorcycle model. Must be in the form of YYYY.
        required: false
        schema:
          type: string
      - name: offset
        in: query
        description: Number of results to offset for pagination. Default is 0.
        required: false
        schema:
          type: integer
          default: 0
      responses:
        '200':
          description: A list of motorcycles
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Motorcycle'
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '500':
          description: Internal Server Error
      security:
      - ApiKeyAuth: []
      tags:
      - Motorcycles
  /v1/motorcyclemakes:
    get:
      summary: Get list of all motorcycle manufacturers
      description: Returns the list of motorcycle manufacturers covered. For one manufacturer's model names use /motorcyclemodels; for a model's technical data use /motorcycles.
      operationId: getMotorcycleMakes
      responses:
        '200':
          description: A list of motorcycle makes
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Makes'
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '500':
          description: Internal Server Error
      security:
      - ApiKeyAuth: []
      tags:
      - Motorcycles
  /v1/motorcyclemodels:
    get:
      summary: Get list of all models for a specific manufacturer
      description: Returns the model names offered by one motorcycle manufacturer. Requires a `make`. For full technical specifications of a model use /motorcycles.
      operationId: getMotorcycleModels
      parameters:
      - name: make
        in: query
        description: Vehicle manufacturer (e.g. kawasaki).
        required: true
        schema:
          type: string
      responses:
        '200':
          description: A list of motorcycle models
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Models'
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '500':
          description: Internal Server Error
      security:
      - ApiKeyAuth: []
      tags:
      - Motorcycles
components:
  schemas:
    Models:
      type: array
      items:
        type: string
    Motorcycle:
      type: object
      properties:
        make:
          type: string
          description: Name of manufacturer/brand.
        model:
          type: string
          description: Name of motorcycle model.
        year:
          type: string
          description: Release year of motorcycle model.
        type:
          type: string
          description: Type of motorcycle.
        displacement:
          type: string
          description: Engine displacement.
        engine:
          type: string
          description: Engine type.
        power:
          type: string
          description: Power output.
        torque:
          type: string
          description: Torque.
        compression:
          type: string
          description: Compression ratio.
        bore_stroke:
          type: string
          description: Bore and stroke.
        valves_per_cylinder:
          type: string
          description: Number of valves per cylinder.
        fuel_system:
          type: string
          description: Fuel system type.
        fuel_control:
          type: string
          description: Fuel control type.
        ignition:
          type: string
          description: Ignition type.
        lubrication:
          type: string
          description: Lubrication method.
        cooling:
          type: string
          description: Cooling system.
        gearbox:
          type: string
          description: Gearbox type.
        transmission:
          type: string
          description: Transmission type.
        clutch:
          type: string
          description: Clutch type.
        frame:
          type: string
          description: Frame type.
        front_suspension:
          type: string
          description: Front suspension type.
        front_wheel_travel:
          type: string
          description: Front wheel travel distance.
        rear_suspension:
          type: string
          description: Rear suspension type.
        rear_wheel_travel:
          type: string
          description: Rear wheel travel distance.
        front_tire:
          type: string
          description: Front tire specification.
        rear_tire:
          type: string
          description: Rear tire specification.
        front_brakes:
          type: string
          description: Front brakes type.
        rear_brakes:
          type: string
          description: Rear brakes type.
        total_weight:
          type: string
          description: Total weight of the motorcycle.
        seat_height:
          type: string
          description: Seat height.
        total_height:
          type: string
          description: Total height of the motorcycle.
        total_length:
          type: string
          description: Total length of the motorcycle.
        total_width:
          type: string
          description: Total width of the motorcycle.
        ground_clearance:
          type: string
          description: Ground clearance.
        wheelbase:
          type: string
          description: Wheelbase.
        fuel_capacity:
          type: string
          description: Fuel capacity.
        starter:
          type: string
          description: Starter type.
        image_url:
          type: string
          format: uri
          description: Image URL. Business tier and above.
          example: https://media.api-ninjas.com/motorcycle_images/generated/front-right-v1/kawasaki/ninja-650.png
    Makes:
      type: array
      items:
        type: string
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key
externalDocs:
  description: API Ninjas documentation
  url: https://api-ninjas.com/api