Name a Color
GEThttps://api-colors.dataandapis.com/v1/colors/name
Name a Color 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
| Parameter | Example | |
|---|---|---|
| all | true | Optional |
| count | 3 | Optional |
| value | 40e0d0 | Required |
Example request
curl
curl "https://api-colors.dataandapis.com/v1/colors/name?all=true&count=3&value=40e0d0" \
-H "X-Api-Key: YOUR_API_KEY"Node.js
const res = await fetch("https://api-colors.dataandapis.com/v1/colors/name?all=true&count=3&value=40e0d0", {
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/name?all=true&count=3&value=40e0d0",
headers={"X-Api-Key": os.environ["DATAANDAPIS_KEY"]},
)
data = r.json()Example response
Example response{
"ok": true,
"query": "#40e0d0",
"pool": "all 31,919 names",
"matches": [
{
"hex": "#40e0d0",
"name": "Fresh Turquoise",
"is_bestof": false,
"is_css": true,
"distance": 0,
"exact": true
},
{
"hex": "#48d1cc",
"name": "Medium Turquoise",
"is_bestof": false,
"is_css": true,
"distance": 17.46,
"exact": false
},
{
"hex": "#45e9c1",
"name": "Aphrodite Aqua",
"is_bestof": true,
"is_css": false,
"distance": 18.19,
"exact": false
…
Show full response
Example response
{
"ok": true,
"query": "#40e0d0",
"pool": "all 31,919 names",
"matches": [
{
"hex": "#40e0d0",
"name": "Fresh Turquoise",
"is_bestof": false,
"is_css": true,
"distance": 0,
"exact": true
},
{
"hex": "#48d1cc",
"name": "Medium Turquoise",
"is_bestof": false,
"is_css": true,
"distance": 17.46,
"exact": false
},
{
"hex": "#45e9c1",
"name": "Aphrodite Aqua",
"is_bestof": true,
"is_css": false,
"distance": 18.19,
"exact": false
…{
"ok": true,
"query": "#40e0d0",
"pool": "all 31,919 names",
"matches": [
{
"hex": "#40e0d0",
"name": "Fresh Turquoise",
"is_bestof": false,
"is_css": true,
"distance": 0,
"exact": true
},
{
"hex": "#48d1cc",
"name": "Medium Turquoise",
"is_bestof": false,
"is_css": true,
"distance": 17.46,
"exact": false
},
{
"hex": "#45e9c1",
"name": "Aphrodite Aqua",
"is_bestof": true,
"is_css": false,
"distance": 18.19,
"exact": false
}
]
}