Name: Product Placeholder – eCommerce Mockups | Free · $4/mo | API.market
Brand: quickapis
SKU: api-quickapis-product-placeholder
Availability: InStock
Author: API Market

hern

# 🖼️ Generate Product Images: Quick placeholders using Product Placeholder

## Overview

The Product Placeholder API provides a simple and fast way to generate placeholder product images for your e-commerce mockups, client demos, or small projects. Forget scouring the web for suitable images; this API delivers high-quality, categorized product images directly to your applications. Streamline your design process and focus on building great user experiences without the hassle of sourcing placeholder visuals.

## Features

*   **Categorized Images:** Choose from a variety of product categories, including clothing, tech, accessories, beauty, and furniture.
*   **Random Image Option:** Retrieve a random assortment of product images from all available categories.
*   **Simple REST Interface:** Easy-to-use API with path-based parameters for quick integration.
*   **High-Quality Images:** Get direct links to high-resolution image files.
*   **Scalable:**  Designed to handle a large number of requests.

## Use Cases

*   **E-commerce Mockups:** Quickly populate e-commerce website mockups with realistic product images during the design phase. This allows designers to visualize the layout and user experience without committing to specific products.
*   **Client Demos:** Impress clients with visually appealing demonstrations of e-commerce platforms or applications, even before product photography is available.  Use the furniture category to quickly showcase an interior design application.
*   **Mobile App Development:** Populate placeholder product images in mobile app interfaces during development and testing.  The tech category is ideal for demonstrating new smartphone shopping apps.
*   **Marketing Landing Pages:** Create visually engaging landing pages for marketing campaigns without the need for real product images.  Use the beauty category to showcase a sample skincare lineup on a landing page promoting a new cosmetics store.
*   **Rapid Prototyping:** Accelerate the prototyping process by using placeholder images to visualize product listings and user interfaces before the actual products are finalized.

## Visual Examples

Here's an example of the response you'll get when requesting tech images:

![Example of a phone from the tech category](https://product-placeholder-api.vercel.app/images/tech/9.jpg)

## Pricing

*   1 API unit equals 1 image processed.
*   GET requests to check prediction status (GET /api/v1/magicapi/product-placeholder/predictions/{id}) are free and don't count toward API unit usage.
*   Different pricing tiers are available based on usage volume.

## API Documentation

### Base URL

All API requests should be made to: `https://prod.api.market/api/v1/magicapi/product-placeholder`

### Authentication

Authentication is handled via API key. Include your API key in the request header:

```
x-magicapi-key: YOUR_API_MARKET_KEY
```

### Endpoints

#### Get Product Images by Category

This endpoint retrieves a specified number of product images from a given category.

**Path:** `/:type/:amount`

**Method:** `GET`

**Parameters:**

*   `type` (required): The category of images to retrieve.  Possible values: `random`, `clothing`, `tech`, `accessories`, `beauty`, `furniture`.
*   `amount` (required): The number of images to return. Must be an integer.

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/magicapi/product-placeholder/clothing/3" -H "x-magicapi-key: YOUR_API_MARKET_KEY"
```

**Example Response:**

```json
[
  { "file": "https://example.com/clothing/shirt-01.jpg" },
  { "file": "https://example.com/clothing/pants-02.jpg" },
  { "file": "https://example.com/clothing/shoes-03.jpg" }
]
```

## Status Codes

*   `200 OK`: Request successful. The requested images are returned in the response.
*   `400 Bad Request`: Invalid input parameters or malformed request. Check the request parameters (e.g., `type`, `amount`) for correctness.
*   `401 Unauthorized`: Missing or invalid API key. Ensure the `x-magicapi-key` header is included with a valid API key.
*   `403 Forbidden`: Valid API key but insufficient permissions. This is unlikely to occur, but if it does, contact API.market support.
*   `404 Not Found`: Resource not found. Check the endpoint URL for typos or invalid paths.
*   `429 Too Many Requests`: Rate limit exceeded. See the Rate Limits section for details.
*   `500 Internal Server Error`: Server-side error. This indicates an issue on the API server. Please retry the request later or contact API.market support.
*   `503 Service Unavailable`: Service temporarily unavailable. The API server is temporarily overloaded or undergoing maintenance. Please retry the request later.

## Rate Limits

The API is subject to rate limiting to ensure fair usage and prevent abuse. If you exceed the rate limit, you will receive a `429 Too Many Requests` error.

*   Specific rate limits depend on your subscription plan.  Refer to your API.market account dashboard for details.
*   When you receive a 429 error, you should implement a retry mechanism with exponential backoff. This involves waiting for a progressively longer period before retrying the request.

## Error Handling

The API returns error responses in JSON format. Each error response contains the following fields:

*   `error.code`: A unique error code that identifies the type of error.
*   `error.message`: A human-readable error message that describes the error.
*   `error.status`: The HTTP status code associated with the error.

**Example Error Response:**

```json
{
  "error": {
    "code": "invalid_parameter",
    "message": "The 'amount' parameter must be a positive integer.",
    "status": 400
  }
}
```

**Common Errors and How to Resolve Them:**

*   `invalid_parameter`: One or more request parameters are invalid. Check the error message for details and correct the parameters accordingly.
*   `unauthorized`: Missing or invalid API key. Ensure the `x-magicapi-key` header is included with a valid API key.
*   `rate_limit_exceeded`: Rate limit exceeded. Implement a retry mechanism with exponential backoff.
*   `server_error`: Server-side error. Retry the request later or contact API.market support.

## Implementation Guide

### Example Code

```javascript
// JavaScript example using async/await
const apiKey = "YOUR_API_MARKET_KEY";
const baseUrl = "https://prod.api.market/api/v1/magicapi/product-placeholder";

async function getProductImages(type, amount) {
  try {
    const response = await fetch(`${baseUrl}/${type}/${amount}`, {
      method: "GET",
      headers: {
        "x-magicapi-key": apiKey
      }
    });

    if (!response.ok) {
      throw new Error(`API error: ${response.status} ${response.statusText}`);
    }

    const data = await response.json();
    return data;
  } catch (error) {
    console.error("Error:", error);
    throw error;
  }
}

// Example usage:
async function main() {
  try {
    const images = await getProductImages("tech", 2);
    console.log("Images:", images);
  } catch (error) {
    console.error("Failed to get images:", error);
  }
}

main();
```

```python
# Python example
import requests

API_KEY = "YOUR_API_MARKET_KEY"
BASE_URL = "https://prod.api.market/api/v1/magicapi/product-placeholder"

def get_product_images(type, amount):
    headers = {"x-magicapi-key": API_KEY}
    url = f"{BASE_URL}/{type}/{amount}"

    try:
        response = requests.get(url, headers=headers)
        response.raise_for_status()  # Raise HTTPError for bad responses (4xx or 5xx)
        return response.json()
    except requests.exceptions.RequestException as e:
        print(f"API Error: {e}")
        return None

# Example Usage
if __name__ == "__main__":
    images = get_product_images("clothing", 3)
    if images:
        print("Images:", images)
```

```bash
# cURL example
curl -X GET "https://prod.api.market/api/v1/magicapi/product-placeholder/furniture/1" -H "x-magicapi-key: YOUR_API_MARKET_KEY"
```

### Performance Optimization

*   **Cache Results:**  If possible, cache the API responses to reduce the number of API calls.
*   **Request Only What You Need:** Request only the necessary number of images.  Avoid requesting a large number of images and then filtering them on the client side.

## FAQ

*   **What image formats are returned?**
    *   The API returns direct links to `.jpg` images.

*   **Can I use these images for commercial purposes?**
    *   The images provided by this API are intended for placeholder use only.  It is your responsibility to ensure that you have the necessary rights and licenses to use any images for commercial purposes. Consult the terms of service of API.market regarding acceptable usage.

*   **How often are the images updated?**
    *   The image library is updated periodically. However, there is no fixed schedule for updates.

*   **Can I request a new category of images?**
    *   Currently, the available categories are limited to the ones listed in the documentation.  You can suggest new categories through the API.market support channels.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@api.market.


Generate placeholder product images for your e-commerce mockups. Free 500 calls/mo, from $4/mo. Start free on API.market.

Product Placeholder – eCommerce Mockups | Free · $4/mo | API.market