How to hit the The Color API API

The Color API at https://www.thecolorapi.com names a color and converts it between hex, RGB, HSL, HSV, and CMYK, and builds color schemes from it.

Authentication

None — no key, no signup. Every example runs as-is.

Full reference: https://www.thecolorapi.com/docs

Identify a color

Pass hex, rgb, hsl, or cmyk.

curl "https://www.thecolorapi.com/id?hex=FF5733"
Run in PostTaco
Example response (trimmed)
{
  "hex": {
    "value": "#FF5733",
    "clean": "FF5733"
  },
  "rgb": {
    "fraction": {
      "r": 1,
      "g": 0.3411764705882353,
      "b": 0.2
    },
    "r": 255,
    "g": 87,
    "b": 51,
    "value": "rgb(255, 87, 51)"
  },
  "hsl": {
    "fraction": {
      "h": 0.02941176470588236,
      "s": 1,
      "l": 0.6
    },
    "h": 11,
    "s": 100,
    "l": 60,
    "value": "hsl(11, 100%, 60%)"
  },
  "hsv": {
    "fraction": {
      "h": 0.02941176470588236,
      "s": 0.8,
      "v": 1
    },
    "value": "hsv(11, 80%, 100%)",
    "h": 11,
    "s": 80,
    "v": 100
  },
  "name": {
    "value": "Outrageous Orange",
    "closest_named_hex": "#FF6037",
    "exact_match_name": false,
    "distance": 107
  },
  "cmyk": {
    "fraction": {
      "c": 0,
      "m": 0.6588235294117647,
      "y": 0.8,
      "k": 0
    },
    "value": "cmyk(0, 66, 80, 0)",
    "c": 0,
    "m": 66,
    "y": 80,
    "k": 0
  },
  "XYZ": {
    "fraction": {
      "X": 0.5705047058823529,
      "Y": 0.4710494117647059,
      "Z": 0.2500682352941177
    },
    "value": "XYZ(57, 47, 25)",
    "X": 57,
    "Y": 47,
    "Z": 25
  },
  "image": {
    "bare": "https://www.thecolorapi.com/id?format=svg&named=false&hex=FF5733",
    "named": "https://www.thecolorapi.com/id?format=svg&hex=FF5733"
  },
  "contrast": {
    "value": "#000000"
  },
  "_links": {
    "self": {
      "href": "/id?hex=FF5733"
    }
  },
  "_embedded": {}
}

Build a color scheme

mode: monochrome, analogic, complement, triad, quad…

curl "https://www.thecolorapi.com/scheme?hex=FF5733&mode=analogic&count=3"
Run in PostTaco
Example response (trimmed)
{
  "mode": "analogic",
  "count": "3",
  "colors": [
    {
      "hex": {
        "value": "#FA502C",
        "clean": "FA502C"
      },
      "rgb": {
        "fraction": {
          "r": 0.9803921568627451,
          "g": 0.3137254901960784,
          "b": 0.17254901960784313
        },
        "r": 250,
        "g": 80,
        "b": 44,
        "value": "rgb(250, 80, 44)"
      },
      "hsl": {
        "fraction": {
          "h": 0.029126213592232997,
          "s": 0.9537037037037038,
          "l": 0.5764705882352941
        },
        "h": 10,
        "s": 95,
        "l": 58,
        "value": "hsl(10, 95%, 58%)"
      },
      "hsv": {
        "fraction": {
          "h": 0.029126213592232997,
          "s": 0.8240000000000001,
          "v": 0.9803921568627451
        },
        "value": "hsv(10, 82%, 98%)",
        "h": 10,
        "s": 82,
        "v": 98
      },
      "name": {
        "value": "Orange Soda",
        "closest_named_hex": "#FA5B3D",
        "exact_match_name": false,
        "distance": 542
      },
      "cmyk": {
        "fraction": {
          "c": 0,
          "m": 0.6799999999999999,
          "y": 0.824,
          "k": 0.019607843137254943
        },
        "value": "cmyk(0, 68, 82, 2)",
        "c": 0,
        "m": 68,
        "y": 82,
        "k": 2
      },
      "XYZ": {
        "fraction": {
          "X": 0.5476470588235294,
          "Y": 0.4452658823529411,
          "Z": 0.22032549019607842
        },
        "value": "XYZ(55, 45, 22)",
        "X": 55,
        "Y": 45,
        "Z": 22
      },
      "image": {
        "bare": "https://www.thecolorapi.com/id?format=svg&named=false&hex=FA502C",
        "named": "https://www.thecolorapi.com/id?format=svg&hex=FA502C"
      },
      "contrast": {
        "value": "#000000"
      },
      "_links": {
        "self": {
          "href": "/id?hex=FA502C"
        }
      },
      "_embedded": {}
    },
    {
      "hex": {
        "value": "#FCBA32",
        "clean": "FCBA32"
      },
      "rgb": {
        "fraction": {
          "r": 0.9882352941176471,
          "g": 0.7294117647058823,
          "b": 0.19607843137254902
        },
        "r": 252,
        "g": 186,
        "b": 50,
        "value": "rgb(252, 186, 50)"
      },
      "hsl": {
        "fraction": {
          "h": 0.11221122112211213,
          "s": 0.9711538461538463,
          "l": 0.592156862745098
        },
        "h": 40,
        "s": 97,
        "l": 59,
        "value": "hsl(40, 97%, 59%)"
      },
      "hsv": {
        "fraction": {
          "h": 0.11221122112211213,
          "s": 0.8015873015873016,
          "v": 0.9882352941176471
        },
        "value": "hsv(40, 80%, 99%)",
        "h": 40,
        "s": 80,
        "v": 99
      },
      "name": {
        "value": "Sunglow",
        "closest_named_hex": "#FFCC33",
        "exact_match_name": false,
        "distance": 488
      },
      "cmyk": {
        "fraction": {
          "c": 0,
          "m": 0.261904761904762,
          "y": 0.8015873015873016,
          "k": 0.0117647058823529
        },
        "value": "cmyk(0, 26, 80, 1)",
        "c": 0,
        "m": 26,
        "y": 80,
        "k": 1
      },
      "XYZ": {
        "fraction": {
          "X": 0.7037780392156863,
          "Y": 0.7459309803921569,
          "Z": 0.2923913725490196
        },
        "value": "XYZ(70, 75, 29)",
        "X": 70,
        "Y": 75,
        "Z": 29
      },
      "image": {
        "bare": "https://www.thecolorapi.com/id?format=svg&named=false&hex=FCBA32",
        "named": "https://www.thecolorapi.com/id?format=svg&hex=FCBA32"
      },
      "contrast": {
        "value": "#000000"
      },
      "_links": {
        "self": {
          "href": "/id?hex=FCBA32"
        }
      },
      "_embedded": {}
    }
  ],
  "seed": {
    "hex": {
      "value": "#FF5733",
      "clean": "FF5733"
    },
    "rgb": {
      "fraction": {
        "r": 1,
        "g": 0.3411764705882353,
        "b": 0.2
      },
      "r": 255,
      "g": 87,
      "b": 51,
      "value": "rgb(255, 87, 51)"
    },
    "hsl": {
      "fraction": {
        "h": 0.02941176470588236,
        "s": 1,
        "l": 0.6
      },
      "h": 11,
      "s": 100,
      "l": 60,
      "value": "hsl(11, 100%, 60%)"
    },
    "hsv": {
      "fraction": {
        "h": 0.02941176470588236,
        "s": 0.8,
        "v": 1
      },
      "value": "hsv(11, 80%, 100%)",
      "h": 11,
      "s": 80,
      "v": 100
    },
    "name": {
      "value": "Outrageous Orange",
      "closest_named_hex": "#FF6037",
      "exact_match_name": false,
      "distance": 107
    },
    "cmyk": {
      "fraction": {
        "c": 0,
        "m": 0.6588235294117647,
        "y": 0.8,
        "k": 0
      },
      "value": "cmyk(0, 66, 80, 0)",
      "c": 0,
      "m": 66,
      "y": 80,
      "k": 0
    },
    "XYZ": {
      "fraction": {
        "X": 0.5705047058823529,
        "Y": 0.4710494117647059,
        "Z": 0.2500682352941177
      },
      "value": "XYZ(57, 47, 25)",
      "X": 57,
      "Y": 47,
      "Z": 25
    },
    "image": {
      "bare": "https://www.thecolorapi.com/id?format=svg&named=false&hex=FF5733",
      "named": "https://www.thecolorapi.com/id?format=svg&hex=FF5733"
    },
    "contrast": {
      "value": "#000000"
    },
    "_links": {
      "self": {
        "href": "/id?hex=FF5733"
      }
    },
    "_embedded": {}
  },
  "image": {
    "bare": "https://www.thecolorapi.com/scheme?format=svg&named=false&hex=FF5733&mode=analogic&count=3",
    "named": "https://www.thecolorapi.com/scheme?format=svg&hex=FF5733&mode=analogic&count=3"
  },
  "_links": {
    "self": "/scheme?hex=FF5733&mode=analogic&count=3",
    "schemes": {
      "monochrome": "/scheme?hex=FF5733&mode=monochrome&count=3",
      "monochrome-dark": "/scheme?hex=FF5733&mode=monochrome-dark&count=3",
      "monochrome-light": "/scheme?hex=FF5733&mode=monochrome-light&count=3",
      "analogic": "/scheme?hex=FF5733&mode=analogic&count=3",
      "complement": "/scheme?hex=FF5733&mode=complement&count=3",
      "analogic-complement": "/scheme?hex=FF5733&mode=analogic-complement&count=3",
      "triad": "/scheme?hex=FF5733&mode=triad&count=3",
      "quad": "/scheme?hex=FF5733&mode=quad&count=3"
    }
  },
  "_embedded": {}
}