Colors API

Generate color palettes, hex codes, and named colors

Basic Usage


                            GET https://placehold.cloud/c

Returns a random color palette by default.

Query Parameters

type Type of color data: palette, hex, or named (default: palette)

count Number of results (1-10, default: 5)

Example Usage

Color Palette:


                                    GET https://placehold.cloud/c?type=palette&count=3

Random Hex Colors:


                                    GET https://placehold.cloud/c?type=hex&count=5

Named Colors:


                                    GET https://placehold.cloud/c?type=named&count=8

Response Format

Color Palette Response:

{
  "status": "success",
  "type": "palette",
  "count": 3,
  "data": [
    {
      "name": "Ocean Breeze",
      "colors": ["#2E86AB", "#A23B72", "#F18F01", "#C73E1D", "#E8E9EB"]
    },
    {
      "name": "Sunset Vibes",
      "colors": ["#F94144", "#F3722C", "#F8961E", "#F9C74F", "#90BE6D"]
    },
    {
      "name": "Forest Green",
      "colors": ["#264653", "#2A9D8F", "#E9C46A", "#F4A261", "#E76F51"]
    }
  ],
  "timestamp": "2025-01-30 12:00:00"
}

Named Colors Response:

{
  "status": "success",
  "type": "named",
  "count": 3,
  "data": [
    {
      "name": "Crimson Red",
      "hex": "#DC143C",
      "rgb": [220, 20, 60],
      "category": "red"
    },
    {
      "name": "Ocean Blue",
      "hex": "#006994",
      "rgb": [0, 105, 148],
      "category": "blue"
    }
  ],
  "timestamp": "2025-01-30 12:00:00"
}

Rate Limiting

This endpoint is rate-limited to 120 requests per minute to ensure fair usage.

Error Handling

In case of an error, the API returns a JSON response with an error message:

{
  "status": "error",
  "message": "Invalid type. Use: palette, hex, or named"
}

Try It Now

Test Palette Test Hex Test Named