Random Color API

Overview

This API allows users to pull any random hex, random hexes within a specific color, and random hexes within a specific shade of a color.

Disclaimer

The colors in this API are sorted mathematically, not visually. This means that the sorting is based on the hexidecimal values meaning colors in a specific category may not look like they belong to that category to your eyes.

Endpoints

1. Pull random hex of any color

Info

Endpoint: /api/color/random
Method: GET

Description

This endpoint returns a random hex from any category and subcategory.

Example Endpoint

/api/color/random

Example Response

{
      "color": "red",
      "shade": "Light",
      "hex": "#FC6C6C"
    }
    

2. Pull Random Hex from Specified Color

Info

Endpoint: /api/color/random/:color
Method: GET

Options

1. :color - specify color (Red, Orange, Yellow, Green, Blue, Indigo, Purple)

Example Endpoint

/api/color/random/red

Example Response

{
      "color": "red",
      "shade": "Normal",
      "hex": "#FF0000"
    }
    

3. Pull Random Hex from Specified Shade and Color

Info

Endpoint: /api/color/random/:color/:shade
Method: GET

Options

1. :color - specify color (Red, Orange, Yellow, Green, Blue, Indigo, Purple)
2. :shade - specify shade (Light, Normal, Dark)

Example Endpoint

/api/color/random/red/light

Example Response

{
      "color": "red",
      "shade": "Light",
      "hex": "#FC6C6C"
    }
    

Support

For support, email [email protected]