Documentation

Overview

This project provides multiple API endpoints for retrieving mobile phone specifications and related 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

• brandName: The brand/manufacturer of the mobile phone (required for certain endpoints).
• modelName: The model name of the mobile phone (required for certain endpoints).
• phoneCustomId: A unique identifier for the mobile phone (required for certain endpoints).
• imageId: A unique identifier for retrieving a specific image.

---

Mobile Phone Specifications and Data Endpoints

1. List All Phone Brands

Endpoint:

• GET /brands

Description: Retrieve a list of all available phone brands.

• No parameters required

2. List All Models by Phone Brand

Endpoint:

• GET /models/{brandName}

Description: Retrieve a list of all models for a specified phone brand.

• brandName: Required

3. Get Specifications by Brand Name and Model Name

Endpoint:

• GET /specifications/{brandName}/{modelName}

Description: Retrieve detailed specifications for a mobile phone by brand and model name.

• brandName: Required
• modelName: Required

4. Get Specifications by Phone Custom ID

Endpoint:

• GET /specifications/{phoneCustomId}

Description: Retrieve detailed specifications for a mobile phone by its custom ID.

• phoneCustomId: Required

5. Get Phone Image Link by Phone Custom ID

Endpoint:

• GET /image/{phoneCustomId}/link

Description: Retrieve an image link for a mobile phone by its custom ID.

• phoneCustomId: Required

6. Get Image as Media by Image ID

Endpoint:

• GET /image/{imageId}/media

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

• imageId: Required

---

Notes

• Ensure that you input the parameters correctly, especially for brand names, model names, and unique IDs.
• Always refer to the specific endpoint description to understand which parameters are required.
• The API provides detailed technical specifications, making it easier to compare and analyze various mobile phone models.

---

Example Requests

Retrieve All Phone Brands

curl -X GET "http://api-mobilephone.makingdatameaningful.com/api/v1/brands"

Retrieve All Models by Phone Brand

curl -X GET "http://api-mobilephone.makingdatameaningful.com/api/v1/models/Samsung"

Retrieve Specifications by Brand Name and Model Name

curl -X GET "http://api-mobilephone.makingdatameaningful.com/api/v1/specifications/Samsung/Galaxy-S21"

Retrieve Phone Image Link by Phone Custom ID

curl -X GET "http://api-mobilephone.makingdatameaningful.com/api/v1/image/12345/link"