Search Colors

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

Search Colors 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.

Get a free API key Try it in the browser

Request

Query parameters

Parameter	Example
bestof	true	Optional
css		Optional
q	sunset	Optional

Example request

curl

curl "https://api-colors.dataandapis.com/v1/colors?bestof=true&q=sunset" \
  -H "X-Api-Key: YOUR_API_KEY"

Node.js

const res = await fetch("https://api-colors.dataandapis.com/v1/colors?bestof=true&q=sunset", {
  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?bestof=true&q=sunset",
    headers={"X-Api-Key": os.environ["DATAANDAPIS_KEY"]},
)
data = r.json()

Example response

{
  "ok": true,
  "page": 1,
  "limit": 25,
  "total": 8,
  "total_pages": 1,
  "colors": [
    {
      "hex": "#dd8869",
      "name": "Canyon Sunset",
      "is_bestof": true,
      "is_css": false
    },
    {
      "hex": "#eb9f9f",
      "name": "Cosy Summer Sunset",
      "is_bestof": true,
      "is_css": false
    },
    {
      "hex": "#b52604",
      "name": "Crimson Velvet Sunset",
      "is_bestof": true,
      "is_css": false
    },
    {
      "hex": "#f88517",
      "name": "Glorious Sunset",
…

Show full response

{
  "ok": true,
  "page": 1,
  "limit": 25,
  "total": 8,
  "total_pages": 1,
  "colors": [
    {
      "hex": "#dd8869",
      "name": "Canyon Sunset",
      "is_bestof": true,
      "is_css": false
    },
    {
      "hex": "#eb9f9f",
      "name": "Cosy Summer Sunset",
      "is_bestof": true,
      "is_css": false
    },
    {
      "hex": "#b52604",
      "name": "Crimson Velvet Sunset",
      "is_bestof": true,
      "is_css": false
    },
    {
      "hex": "#f88517",
      "name": "Glorious Sunset",
      "is_bestof": true,
      "is_css": false
    },
    {
      "hex": "#c38d87",
      "name": "Grand Sunset",
      "is_bestof": true,
      "is_css": false
    },
    {
      "hex": "#e95e2a",
      "name": "Sunset Blaze",
      "is_bestof": true,
      "is_css": false
    },
    {
      "hex": "#f6c362",
      "name": "Sunset Gold",
      "is_bestof": true,
      "is_css": false
    },
    {
      "hex": "#fd5e53",
      "name": "Sunset Orange",
      "is_bestof": true,
      "is_css": false
    }
  ]
}

Other endpoints in the Colors API

Full Colors API documentation →