Documentation

Overview

This project provides multiple API endpoints for retrieving motorcycle specifications data. You can select any of the available endpoints, each with its specific input requirements, as detailed below.

Please note: Apify does not support declaring custom tabs for each endpoint, so you'll need to select an endpoint from the list and fill in the required parameters for that specific endpoint.

Parameters are only required for certain endpoints, as specified in the description of each.

General Input Description

• year: The production year of the motorcycle (required for certain endpoints).
• make: The make/brand of the motorcycle (required for certain endpoints).
• model: The model of the motorcycle (required for certain endpoints).
• id: A unique identifier (used for image or specification retrieval).
• make_id: ID associated with the motorcycle make.
• category: The category of the motorcycle.
• group: Group ID or name for retrieving specifications.

---

Motorcycle Specifications and Data Endpoints

1. Get Specifications by Year, Make, and Model

Endpoint:

• GET /specifications/{year}/{make}/{model}

Description: Retrieve specifications for a motorcycle by year, make, and model.

• year: Required
• make: Required
• model: Required

2. Get Image by ID (Media Content)

Endpoint:

• GET /image/{id}/media

Description: Retrieve an image as media content by its ID.

• id: Required

3. Get Image by ID (Link)

Endpoint:

• GET /image/{id}/link

Description: Retrieve an image link by its ID.

• id: Required

4. Get Specifications by Make and Model

Endpoint:

• GET /specifications/{make}/{model}

Description: Retrieve specifications for a motorcycle by make and model.

• make: Required
• model: Required

5. Get Specifications by ID

Endpoint:

• GET /specifications/{id}

Description: Retrieve specifications for a motorcycle by its ID.

• id: Required

6. Get Models by Make

Endpoint:

• GET /models/{make}

Description: Retrieve a list of models by make.

• make: Required

7. Get Models by Make ID and Year

Endpoint:

• GET /models/{make_id}/{year}

Description: Retrieve a list of models by make ID and year.

• make_id: Required
• year: Required

8. Get List of All Makes

Endpoint:

• GET /makes

Description: Retrieve a list of all motorcycle makes.

• No parameters required

9. Get Production Years by Model ID

Endpoint:

• GET /production-years/{model_id}

Description: Retrieve production years grouped by model ID.

• model_id: Required

10. Get List of All Categories

Endpoint:

• GET /categories

Description: Retrieve a list of all motorcycle categories.

• No parameters required

11. Get Specifications by Group

Endpoint:

• GET /specifications/group/{group}

Description: Retrieve specifications by group.

• group: Required

12. Get Models by Make ID, Year, and Category

Endpoint:

• GET /models/{make_id}/{year}/{category}

Description: Retrieve a list of models by make ID, year, and category.

• make_id: Required
• year: Required
• category: Required

13. Get Models by Make ID and Category

Endpoint:

• GET /models/{make_id}/{category}

Description: Retrieve a list of models by make ID and category.

• make_id: Required
• category: Required

---

Notes

• Ensure that you input the parameters in the correct format, particularly for IDs, makes, models, and other required fields.
• Always refer to the specific endpoint description to understand which parameters are required.
• Use the appropriate ID fields (id, make_id, model_id, etc.) for the endpoints that need them.

---

Example Requests

Retrieve Specifications by Year, Make, and Model

curl -X GET "http://api-motorcycle.makingdatameaningful.com/api/v1/specifications/2021/Yamaha/MT-07"

Retrieve Image by ID (Media Content)

curl -X GET "http://api-motorcycle.makingdatameaningful.com/api/v1/image/12345/media"

Retrieve Models by Make

curl -X GET "http://api-motorcycle.makingdatameaningful.com/api/v1/models/Yamaha"