{
  "openapi": "3.1.0",
  "info": {
    "title": "Motorcycles API",
    "version": "1.0.0",
    "description": "Specs for 42,500 motorcycle models from 607 brands, 1894 to today, with full factory spec sheets and photos.\n\nMotorcycle catalog and specifications for 42,500+ models from 607 brands, model years 1894 through the current one — brand, model, year, category (sport, cruiser, scooter, enduro...), engine details (displacement, power, torque, compression ratio, engine type, cooling, fuel system), gearbox and final drive, top speed, dry and total weight, seat height, fuel capacity, plus the full ~40-row factory spec sheet (chassis, suspension, brakes, tires, dimensions, color options) and a photo per model served through the API. Filter by brand, model, year range, category, displacement range, minimum power or cooling type; aggregate brands per year and categories. Self-hosted dataset, refreshed daily with newly listed models — no third-party calls.",
    "contact": {
      "name": "Data and APIs",
      "url": "https://dataandapis.com/contact"
    },
    "termsOfService": "https://dataandapis.com/terms-of-service",
    "license": {
      "name": "Data and APIs Terms of Service",
      "url": "https://dataandapis.com/terms-of-service"
    },
    "x-logo": {
      "url": "https://dataandapis.com/images/motorcycles.webp"
    }
  },
  "externalDocs": {
    "description": "Documentation, live tester and pricing",
    "url": "https://dataandapis.com/apis/motorcycles"
  },
  "servers": [
    {
      "url": "https://api-motorcycles.dataandapis.com"
    }
  ],
  "tags": [
    {
      "name": "Data",
      "description": "Motorcycles API belongs to the Data category of the Data and APIs catalog."
    }
  ],
  "paths": {
    "/v1/motorcycles/{idOrSlug}": {
      "get": {
        "operationId": "getMotorcycle",
        "summary": "Get Motorcycle",
        "description": "Get Motorcycle endpoint of the Motorcycles API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/motorcycles/get-motorcycle"
        },
        "parameters": [
          {
            "name": "idOrSlug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "honda_cbr1000rr-r_fireblade_sp_2025"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "id": 57914,
                  "slug": "honda_ace_125_2022",
                  "brand": "Honda",
                  "model": "Ace 125",
                  "year": 2022,
                  "category": "Allround",
                  "engine": {
                    "displacementCcm": 124.1,
                    "powerHp": 8.5,
                    "torqueNm": 10.1,
                    "type": "V2, four-stroke",
                    "cooling": "Air"
                  },
                  "topSpeedKmh": null,
                  "dryWeightKg": 110,
                  "seatHeightMm": 790,
                  "fuelCapacityL": 10,
                  "hasImage": true,
                  "compressionRatio": 9.4,
                  "gearbox": "4-speed",
                  "transmission": "Chain (final drive)",
                  "fuelSystem": "Overhead Valves (OHV)",
                  "totalWeightKg": null,
                  "specs": {
                    "Model year": "2022",
                    "Category": "Allround",
                    "Displacement": "124.1 ccm (7.57 cubic inches)",
                    "Engine type": "V2, four-stroke",
                    "Power output": "8.5 HP (6.2 kW )) @ 6500 RPM",
                    "Torque": "10.1 Nm (1.0 kgf-m or 7.5 ft.lbs) @ 5000 RPM",
                    "Front suspension": "31mm Telescopic forks, 130mm axle travel",
                    "Front tire": "80/100-18",
                    "Front brakes": "Expanding brake (drum brake)",
                    "Seat height": "790 mm (31.1 inches) If adjustable, lowest setting.",
                    "Fuel capacity": "10.00 litres (2.64 US gallons)",
                    "Color options": "Red Metallic"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/motorcycles": {
      "get": {
        "operationId": "listMotorcycles",
        "summary": "List Motorcycles",
        "description": "List Motorcycles endpoint of the Motorcycles API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/motorcycles/list-motorcycles"
        },
        "parameters": [
          {
            "name": "brand",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "Ducati"
          },
          {
            "name": "category",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "Sport"
          },
          {
            "name": "cooling",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "Liquid"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "20"
          },
          {
            "name": "maxCcm",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "1300"
          },
          {
            "name": "maxYear",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "2025"
          },
          {
            "name": "minCcm",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "1000"
          },
          {
            "name": "minPowerHp",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "180"
          },
          {
            "name": "minYear",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "2020"
          },
          {
            "name": "model",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "Panigale"
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "1"
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "fireblade"
          },
          {
            "name": "year",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "2025"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "total": 29,
                  "page": 1,
                  "limit": 20,
                  "count": 1,
                  "results": [
                    {
                      "id": 60123,
                      "slug": "aprilia_rsv4_factory_2023",
                      "brand": "Aprilia",
                      "model": "RSV4 Factory",
                      "year": 2023,
                      "category": "Sport",
                      "engine": {
                        "displacementCcm": 1099,
                        "powerHp": 217,
                        "torqueNm": 125,
                        "type": "V4, four-stroke",
                        "cooling": "Liquid"
                      },
                      "topSpeedKmh": 305,
                      "dryWeightKg": 184,
                      "seatHeightMm": 845,
                      "fuelCapacityL": 17.9,
                      "hasImage": true
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/motorcycles/brands": {
      "get": {
        "operationId": "motorcycleBrands",
        "summary": "Motorcycle Brands",
        "description": "Motorcycle Brands endpoint of the Motorcycles API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/motorcycles/motorcycle-brands"
        },
        "parameters": [
          {
            "name": "year",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "2025"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "count": 112,
                  "brands": [
                    {
                      "brand": "Kawasaki",
                      "count": 81
                    },
                    {
                      "brand": "Honda",
                      "count": 72
                    },
                    {
                      "brand": "KTM",
                      "count": 53
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/motorcycles/categories": {
      "get": {
        "operationId": "motorcycleCategories",
        "summary": "Motorcycle Categories",
        "description": "Motorcycle Categories endpoint of the Motorcycles API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/motorcycles/motorcycle-categories"
        },
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "count": 15,
                  "categories": [
                    {
                      "category": "Scooter",
                      "count": 3497
                    },
                    {
                      "category": "Sport",
                      "count": 2939
                    },
                    {
                      "category": "Enduro / offroad",
                      "count": 2337
                    },
                    {
                      "category": "Custom / cruiser",
                      "count": 2160
                    },
                    {
                      "category": "Naked bike",
                      "count": 1733
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/motorcycles/{idOrSlug}/image": {
      "get": {
        "operationId": "motorcycleImage",
        "summary": "Motorcycle Image",
        "description": "Motorcycle Image endpoint of the Motorcycles API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/motorcycles/motorcycle-image"
        },
        "parameters": [
          {
            "name": "idOrSlug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "honda_cbr1000rr-r_fireblade_sp_2025"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "image/*": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/motorcycles/random": {
      "get": {
        "operationId": "randomMotorcycles",
        "summary": "Random Motorcycles",
        "description": "Random Motorcycles endpoint of the Motorcycles API. Costs 1 token per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/motorcycles/random-motorcycles"
        },
        "parameters": [
          {
            "name": "amount",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "3"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "count": 2,
                  "results": [
                    {
                      "id": 61234,
                      "slug": "harley-davidson_nightster_special_2025",
                      "brand": "Harley-Davidson",
                      "model": "Nightster Special",
                      "year": 2025,
                      "category": "Custom / cruiser"
                    },
                    {
                      "id": 31234,
                      "slug": "fantic_caballero_regolarita_competizione_racing_50_2010",
                      "brand": "Fantic",
                      "model": "Caballero Regolarita Competizione Racing 50",
                      "year": 2010,
                      "category": "Enduro / offroad"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    }
  },
  "components": {
    "securitySchemes": {
      "ApiKey": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Api-Key",
        "description": "Create a free key at https://dataandapis.com/sign-up. 500 tokens a month on the Free plan; this API costs 1 token per call."
      }
    }
  },
  "security": [
    {
      "ApiKey": []
    }
  ]
}