Generate Palette

GEThttps://api-colors.dataandapis.com/v1/colors/palette

Generate Palette is an endpoint of the Colors API. Name, convert and check contrast for any color, with 31,919 curated names and WCAG math.

Send your key in the X-Api-Key header. Each call costs 1 token; a free key includes 500 tokens a month.

Request

Query parameters

ParameterExample
count5Optional
modetriadicOptional
value1e90ffRequired

Example request

curl
curl "https://api-colors.dataandapis.com/v1/colors/palette?count=5&mode=triadic&value=1e90ff" \
  -H "X-Api-Key: YOUR_API_KEY"
Node.js
const res = await fetch("https://api-colors.dataandapis.com/v1/colors/palette?count=5&mode=triadic&value=1e90ff", {
  headers: { "X-Api-Key": process.env.DATAANDAPIS_KEY },
});
const data = await res.json();
Python
import os, requests

r = requests.get(
    "https://api-colors.dataandapis.com/v1/colors/palette?count=5&mode=triadic&value=1e90ff",
    headers={"X-Api-Key": os.environ["DATAANDAPIS_KEY"]},
)
data = r.json()

Example response

Example response
{
  "ok": true,
  "base": "#1e90ff",
  "mode": "triadic",
  "palette": [
    {
      "hex": "#1e90ff",
      "hsl": {
        "h": 210,
        "s": 100,
        "l": 55.88
      },
      "name": "Pool Water"
    },
    {
      "hex": "#ff1e8e",
      "hsl": {
        "h": 330,
        "s": 100,
        "l": 55.88
      },
      "name": "Fluorescent Pink"
    },
    {
      "hex": "#8eff1e",
      "hsl": {
        "h": 90,
        "s": 100,
…
Show full response
{
  "ok": true,
  "base": "#1e90ff",
  "mode": "triadic",
  "palette": [
    {
      "hex": "#1e90ff",
      "hsl": {
        "h": 210,
        "s": 100,
        "l": 55.88
      },
      "name": "Pool Water"
    },
    {
      "hex": "#ff1e8e",
      "hsl": {
        "h": 330,
        "s": 100,
        "l": 55.88
      },
      "name": "Fluorescent Pink"
    },
    {
      "hex": "#8eff1e",
      "hsl": {
        "h": 90,
        "s": 100,
        "l": 55.88
      },
      "name": "Loud Lime"
    }
  ]
}